Configure a Cookie Destination
A cookie destination returns and writes data to a cookie in the user's browser. The cookie contains data that can be read by other platforms that have access to the page. Follow these instructions to create a cookie destination with Destination Builder.
To create a new cookie destination, go to Audience Data > Destinations > Create New Destination and complete the sections as described below.
This section contains fields and options that start the cookie destination creation process. To complete this section:
- Click Basic Information to expose the controls.
- Name the destination. Avoid abbreviations and special characters.
- (Optional) Describe the destination. A concise description is an effective way to define or provide more information about a destination.
- In the Category list, choose Custom .
- In the Environment list, select Browser . You cannot configure cookie destinations for native mobile environments, such as Android or iOS apps.
- In the Type list, click Cookie .
- (Optional) Select an Auto-fill Destination Mapping . Options include:
- Segment ID : Automatically adds and sends the segment ID to the destination.
- Integration Code Value : Automatically adds and sends the segment integration code to the destination mapping. The integration code is a unique identifier created and used by the customer. It is limited to 255 characters, maximum.
- Click Next to go to the Configuration settings or click Data Export Labels to apply export controls to the destination.
Data Export Labels
This section contains options that apply data export controls to a cookie destination. Skip this step if you do not use data export controls. To complete this section:
- Click Data Export Labels to expose the controls.
- Select a label that corresponds to data export control applied to the destination (see Add Export Labels to a Destination for details).
- Click Save .
This section contains fields and options that let you set up the cookie for your destination.
Audience Manager encodes data written to the destination cookie. For example, spaces are encoded as %20 and semicolons are encoded as %3B .
To complete this section:
- Click Configuration to expose the controls
- Name the cookie. Avoid abbreviations and special characters.
- Choose a data format option. These options let you choose the delimiters and separators for the key-value pairs that send segment data to a destination. Format options include:
- Single key: Lets you set the key in a key-value pair. You'll set the value after you select a segment in the Segment Mappings section below.
- Multi key: Lets you set the key and value for a key-value pair. You'll create the key-value pair after you select a segment in the Segment Mappings section below. See Standard and Serial Key-Value Pairs for more information about these data elements.
- Click Save .
All other settings are optional. For more information about the Cookie Domain and Publish data to settings, see Optional Settings for Cookie Destinations .
This section lets you search for and add segments to your destination. To complete this section:
- Click Segment Mappings to expose the controls.
- In the Search and Add Segments box, start typing the name of a segment or click Browse All Segments to browse a list of available segments.
- Click Add Selected Segments when you find the segment you want to use. Adding a segment opens the Edit Mapping window.
- In the Edit Mapping dialog:
- Mapping lets you set a value for the key specified in the Configuration section above.
- Publish from lets you set start and end date for the destination. If the end date is blank, the destination never expires.
- Click Save .
- Click Done .