Media Tag Generator Guide

• Steps for initiall tag creation
• Steps for retrieving previously created tags
• Accepted values for the Media Tag fields

Steps for initial tag creation

1. Within Salesforce Audience Studio UI, navigate to Manage > Sites.
2. Create Media ConfID by clicking the Create Media Tag button.
3. Create Media Tag screen will appear.  Complete the fields as follows:
   NOTE: Once media tag is submitted, name, category and channel cannot be changed. Be sure to double check before submitting.

• Media Tag: Name the media tag accordingly
• Category: Used to organize tags in a way that is meaningful to your business. Define accordingly
• Channel: Select the media channel you wish to tie data back to
• Click Submit

4. Navigate to the newly created Media Tag and click the " </>" (Get Code) button, located in the "Actions" column.
5. Fill in the brand parameter only if kxbrand is needed within the media tag setup.
6. From the Ad Server dropdown menu, select ad server for tag implementation. Appropriate tag macros will be generated based on selection. Example: If trafficking tags within DCM, selecting "DCM" will generate tags containing the necessary DCM macros. If tags without macros are needed, select "Generic" from the Ad Server drop down menu. 
7. The ConfID and CampaignID attributes are required parameters, and it is recommended that all parameters be used. If you elect to forgo use of any of the optional parameters, deselect at this time.
8. Click the Get Code button to prompt tag generation.
9. Click Download to obtain a csv containing all tags (Impression – JavaScript, Impression - Image Pixel and Click). Downloading a csv is recommended when initially providing tags to ad ops for trafficking. 
   You may also click Copy to Clipboard to copy the selected tag (Impression – JavaScript, Impression - Image Pixel or Click) and paste tag to a text file.
10. Review tags within the csv or text file.
11. Email tags to ad ops for trafficking.

Steps for retrieving previously created tags

1. Within Salesforce Audience Studio UI, navigate to Manage > Sites.
2. Find the name of the appropriate Media Tag, and click the " </>" (Get Code) button, located in the "Actions" column.
3. Fill in the brand parameter only if kxbrand is needed within the media tag setup.
4. From the Ad Server dropdown menu, select ad server for tag implementation. Appropriate tag macros will be generated based on selection. Example: If trafficking tags within DCM, selecting "DCM" will generate tags containing the necessary DCM macros. If tags without macros are needed, select "Generic" from the Ad Server drop down menu. 
5. The ConfID and CampaignID attributes are required parameters, and it is recommended that all parameters be used. If you elect to forgo use of any of the optional parameters, deselect at this time.
6. Click the Get Code button to prompt tag generation.
7. Click Download to obtain a csv containing all tags (Impression – JavaScript, Impression - Image Pixel and Click). Downloading a csv is recommended when initially providing tags to ad ops for trafficking. 
   You may also click Copy to Clipboard to copy the selected tag (Impression – JavaScript, Impression - Image Pixel or Click) and paste tag to a text file.
8. Review tags within the csv or text file.
9. Email tags to ad ops for trafficking.

Accepted values for the Media Tag fields

When you select an Ad Server to configure the Media Tag, the macros that Ad Server supports will be included in the generated tag.  If an appropriate macro doesn't exist for a field, the string <REPLACE_VALUE> will be inserted instead.  You need to replace the <REPLACE_VALUE> string with the actual value you want sent to Audience Studio.  If you'd prefer, you can also replace any of the ad server macros with a hard-coded value as well.

If you manually add a hard-coded value to the Media Tag, it is important that you only use values that are accepted for that particular field.

Field	Accepted Data
Conf ID	Generated by the platform - Do Not Change
Advertiser ID	Integer
Campaign ID	UTF-8 string (with a maximum length of 255 characters)
Placement ID	UTF-8 string (with a maximum length of 255 characters)
Ad ID	Integer
Creative ID	Integer
Site ID	UTF-8 string (with a maximum length of 255 characters)

Since this data is sent to Audience Studio via a URL request, it's also important that the values are appropriately URL-encoded as well.