Ads exposure tracking
You can track the exposition of users to the different kind of Ads format that exist today:
- Display Ads: All Ads that are either static image/animations or HTML5 animated Ads
- Video Ads: All Video Ads that the User can see through a marketing campaign
All Ads tracking is done using Pixels and Click Tracking URLs.
You should consider using this feature to get ad view and ad click directly within your datamart when using DSPs .
Activities tracked through this method will be of
DISPLAY_AD $type and NO_SESSION $session_status. See User activity object for more information.There are two predefined user events that should be tracked during the exposition of a user to an Ad :
Event name | Tracking method | Description |
|---|---|---|
$ad_view | Pixel | The 'view/impression' of the Display Ad to the User |
$ad_click | Click Tracking URL | The 'click' of the Ad by the User |
Use the following URL in your tracking pixel to send an
$ad_view event to the platform.https://events.mediarithmics.com/v1/touches/pixel? \
$ev=$ad_view& \
$dat_token=<DATAMART_TOKEN>&
$catn=<CAMPAIGN_TECHNICAL_NAME>&
$scatn=<AD_GROUP_TECHNICAL_NAME>&
$crtn=<CREATIVE_TECHNICAL_NAME>&
$cb=<CACHEBUSTER>&
... any custom property
Field | Type | Description |
|---|---|---|
$ev | String | The event name. $ad_view for Display Ad impression tracking |
$dat_token | String | The token (not the ID) of the datamart in the mediarithmics platform. |
$catn | String | Campaign technical name |
$scatn | String | Sub-campaign technical name |
$crtn | String | Creative technical name |
$cb | String | The cache buster parameter. It should contain a random string. optional |
$cuid | String | |
$uaid | String | |
$email_hash | String | |
$comp_token | String | Compartment token (not the ID) |
any custom property name | Any Type | Any custom property. optional |
Use the following click-tracking URL to send an
$ad_click event to the platform.https://events.mediarithmics.com/v1/touches/click?
$ev=$ad_click&
$dat_token=<DATAMART_TOKEN>&
$catn=<CAMPAIGN_TECHNICAL_NAME>&
$scatn=<AD_GROUP_TECHNICAL_NAME>&
$crtn=<CREATIVE_TECHNICAL_NAME>&
$cb=<CACHEBUSTER>&
$redirect=<CLICK_URL>
... any custom property
Field | Type | Description |
|---|---|---|
$ev | String | The event name. $ad_click for Display Ad click tracking |
$dat_token | String | The id of the audience datamart in the mediarithmics platform. |
$redirect | String | The redirect url. This string should URL Encoded. (RFC 3986) |
$catn | String | Campaign technical name |
$scatn | String | Sub-campaign technical name |
$crtn | String | Creative technical name |
$cb | String | The cache buster parameter. It should contain a random string. optional |
$cuid | String | |
$email_hash | String | |
$comp_token | String | Compartment token (not the ID) |
any custom property name | Any Type | Any custom property. optional |
If you want to integrate with an external DSP / Ad Server such as Google Ad Manager or App Nexus, you can use the ids of the creative ad groups and campaign from your external DSP as technical names. See the integrations below for examples.
You can use the following macros as a minimum configuration for tracking on DV 360 (ex-Doubleclick Bid Manager):
https://events.mediarithmics.com/v1/touches/pixel?
$ev=$ad_view&
$dat_token=<DATAMART_TOKEN>&
$catn=${CAMPAIGN_ID}&
$scatn=${INSERTION_ORDER_ID}&
$crtn=${CREATIVE_ID}&
$cb=${CACHEBUSTER}
https://events.mediarithmics.com/v1/touches/click?
$ev=$ad_click&
$dat_token=<DATAMART_TOKEN>&
$catn=${CAMPAIGN_ID}&
$scatn=${INSERTION_ORDER_ID}&
$crtn=${CREATIVE_ID}&
$cb=${CACHEBUSTER}&
$redirect=${CLICK_URL_ENC}
You can use the following macros as a minimum configuration for tracking on Campaign Manager 360 (ex-Doubleclick Campaign Manager):
https://events.mediarithmics.com/v1/touches/pixel?
$ev=$ad_view&
$dat_token=<DATAMART_TOKEN>&
$catn=%ebuy!&
$scatn=%eaid!&
$crtn=%ecid!&
$cb=%n
https://events.mediarithmics.com/v1/touches/click?
$ev=$ad_click&
$dat_token=<DATAMART_TOKEN>&
$catn=%ebuy!&
$scatn=%eaid!&
$crtn=%ecid!&
$cb=%n&
$redirect=<CLICK_URL>
More info on Google Campaign Manager 360 macros can be found here:
You can use the following macros as a minimum configuration for tracking on Ad Manager:
https://events.mediarithmics.com/v1/touches/pixel?
$ev=$ad_view&
$dat_token=<DATAMART_TOKEN>&
$catn=%ebuy!&
$scatn=%eaid!&
$crtn=%ecid!&
$cb=%%CACHEBUSTER%%
https://events.mediarithmics.com/v1/touches/click?
$ev=$ad_click&
$dat_token=<DATAMART_TOKEN>&
$catn=%ebuy!&
$scatn=%eaid!&
$crtn=%ecid!&
$cb=%%CACHEBUSTER%%&
$redirect=<CLICK_URL>
More info on Google Ad Manager macros can be found here: https://support.google.com/admanager/answer/2376981
You can use the following macros as a minimum configuration for tracking on Xandr:
https://events.mediarithmics.com/v1/touches/pixel?
$ev=$ad_view&
$dat_token=<DATAMART_TOKEN>&
$catn=${CP_CODE}&
$scatn=${CPG_CODE}&
$crtn=${CREATIVE_CODE}
$cb=${CACHEBUSTER}
https://events.mediarithmics.com/v1/touches/click?
$ev=$ad_click&
$dat_token=<DATAMART_TOKEN>&
$catn=${CP_CODE}&
$scatn=${CPG_CODE}&
$crtn=${CREATIVE_CODE}
$cb=${CACHEBUSTER}
$redirect=${CLICK_URL_ENC}
More info on Xandr supported macros can be found here: https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/supported-creative-macros.html
Basic video ad tracking can be achieved by integrating the display ad pixel (with
$ad_view events) and the click-tracking URL (with $ad_click events) into your video ad format.For more advanced capabilities, a specific integration can be setup based on the visit pixel (with custom completion events) and an Activity Analyzer. Please advise with your Account Representatives during the design phase.
Last modified 9mo ago