Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

CreateUPMCookie

Commerce Server 2000

Use this component to collect cookie data to pass to an Active Server Pages (ASP) page generating a personalized message.

Although the component appears as CreateUPMCookie in the Pipeline Editor, its ProgID is Commerce.DMLCreateUPMCookie.

Intended use: DirectMailer pipeline, Create Cookies stage.

Configuration Values

None.

Values Read

The CreateUPMCookie component reads the following values from the indicated dictionaries.

KeyDictionaryDescription
rcp_bypassOrderBoolean. The component bypasses (skips) processing if True.
rcp_personalizeOrderOptional. Numeric. Use this key to indicate whether or not to personalize the message for this recipient:

0

Do not personalize

1

Personalize

This key defaults to 1 (personalize).

cookieOrderOptional. A reference to a dictionary to hold the created cookie. This key is created if it is not present.
rcp_guidOrderOptional. The globally unique identifier (GUID) uniquely identifying this recipient, taken from the user profile.
rcp_emailOrderThe e-mail address of the recipient.
css_siteContextThe site ID string.
campaign_itemContextOptional. The campaign item ID.
campaign_item_nameContextOptional. The name of the campaign item.
default_url_isfileContextThis key is True if the default Uniform Resource Locator (URL) is a file path and not an http:// path.

Values Written

The CreateUPMCookie component writes the following values to the Order dictionary.

KeyDescription
CookieA dictionary containing the information that will be used in the cookie.

Remarks

The CreateUPMCookie component does nothing if the rcp_bypass key is True, if the default_url_isfile key is True, or if the rcp_personalize key is zero (0).

The CreateUPMCookie component keeps the cookie information in a dictionary. The cookie string is produced by the ComposeDMLMessage component.

If the message is not personalized, the component creates a cookie entry (assigns YES to the key Microsoft_DirectMailer) to prevent CDO from using a locally stored cookie.

The cookie string created from the data has the following format:

MSCSProfile='encryptedstring';CampaignItemID=string;CampaignItemName=string;UserEmail=string

The items in the cookie have the following meanings.

AbbreviationDescription
MSCSProfileString. The user profile ID, which is needed for personalizing the message.
CampaignItemIDString. The Campaign item ID, which is necessary for click tracking.
CampaignItemNamesString. The Campaign item name, which allows labeling the message for the user.
UserEmailString. The e-mail address of the user.

Note that the abbreviations in the table are also the keys used in the Cookie dictionary.

The user profile ID is encrypted only when the mail is sent as part of the campaign. In a stand-alone Direct Mailer job, the user profile ID is unencrypted.

See Also

AddAttachments

ComposeDMLMessage

SendPrecomposedMessage

ThrottleDMLPerformance

VerifyMessageBody

VerifyRecipientData


All rights reserved.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.