Skip to content

Instantly share code, notes, and snippets.

@switzer
Last active August 29, 2015 14:14
Show Gist options
  • Save switzer/f54335d276efdbfd047e to your computer and use it in GitHub Desktop.
Save switzer/f54335d276efdbfd047e to your computer and use it in GitHub Desktop.
Documentation on how to add Authenticated Digital tags to your ad creative

Authenticated Ad Tags

Please append the following script immediately after your ad creative iframe/javascript tag in your ad system:

<script data-adjs='true' data-client-id='<<account_id>>' type='text/javascript' src='//cdn.adjs.net/auth.digital.js'></script>

NOTE: <<account_id>> is your Authenticated Digital account id. For example, the AD demo account ID is: f4bb22d31b2e2357f5375465ead279c90915fbe1

Inserting Macros

It is possible to pass a number of different variables into our script tag from your ad-system that can be available for reporting and post-analysis. Ususally, a macro in your ad server would render the values of these variables.

It is important to pass these variables in correctly, so that the AD analytics dashboard, as well as the raw data

FIELD DESCRIPTION EXAMPLE
xurl This variable is used to tell AD what the reported url is. AD will then parse this URL to get the domain, and report on whether this domain matches the authenticated domain. data-xurl='http://finance.yahoo.com/q?s=RUBI'
xid This variable stores the impression ID of your ad server, for reconciliation purposes data-xid='22458443883485543'
cmp-id This variable stores the campaign ID. The AD analytics dashboard will segment authentication data based cmp-id. There should be 100 or fewer separate values for exc-id in order for the AD dashboard to display correctly. data-cmp-id='SPRING 2015 AIRLINE PROMO'
exc-id This variable stores the exchange ID. The AD analytics dashboard will segment authentication data based exc-id. There should be 100 or fewer separate values for exc-id in order for the AD dashboard to display correctly. data-exc-id='opx'
  • data-adv-id (used for advertiser id)
  • data-cmp-id (used for campaign id)
  • data-ad-id (used for ad creative id)
  • data-pub-id (used for publisher id)
  • data-site-id (used for site / domain id)
  • data-slot-id (used for slot or placement id)
  • data-exc-id (used for ad exchange id/mnemonic)
  • data-sup-id (used for upstream supplier id)

For example if you wanted to pass campaign_id of 12345 into the tag your tag would look like this:

<script data-adjs='true' data-client-id='<>' data-cmp-id='12345' type='text/javascript' src='//cdn.adjs.net/advertiser.ad.js'></script>

All variables are stored as strings. At this point variable cardinality is not really an issue, but there may be limits as we move out of beta.

Please let me know when you are ready to go live, and we can test the tag implementation from our side, and/or answer any questions that you have.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment