CreateUPMCookie
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.
Key | Dictionary | Description |
rcp_bypass |
Order | Boolean. The component bypasses (skips) processing if True. |
rcp_personalize |
Order | Optional. 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). |
cookie |
Order | Optional. A reference to a dictionary to hold the created cookie. This key is created if it is not present. |
rcp_guid |
Order | Optional. The globally unique identifier (GUID) uniquely identifying this recipient, taken from the user profile. |
rcp_email |
Order | The e-mail address of the recipient. |
css_site |
Context | The site ID string. |
campaign_item |
Context | Optional. The campaign item ID. |
campaign_item_name |
Context | Optional. The name of the campaign item. |
default_url_isfile |
Context | This 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.
Key | Description |
Cookie |
A 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.
Abbreviation | Description |
MSCSProfile | String. The user profile ID, which is needed for personalizing the message. |
CampaignItemID | String. The Campaign item ID, which is necessary for click tracking. |
CampaignItemNames | String. The Campaign item name, which allows labeling the message for the user. |
UserEmail | String. 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.