Capturing Campaign Click Data via Pixel Calls
Click tracking enables measurement of visitor engagement throughout your campaign, as it records click-based activity for third-party creatives. Similar to impressions collection, an event call is sent to the Audience Manager data collection servers (DCS) for processing. The visitor is then redirected to the intended web address.
Requirements
Click tracking calls require the following parameters:
d_event=click
: A key-value pair that identifies an event call as a click event.d_rd=redirect URL
: A key-value pair that contains a double-encoded redirect URL. If you’re using an online encoding tool, run the string through the encoder, then encode the result again, in order for the redirect to work.
In addition, the call can contain key-value pairs that can be used for trait qualification or to provide data and metadata for other reports.
Request Sample
https://client.demdex.net/event?d_event=click&d_creative=123&d_rd=http%3A%2F%2Fadobe.com%2Fcallback%3Fcreative%3D%25d_creative%25
Response
The response redirects the browser to the URL specified in the d_rd
parameter. The response string can include values generated by any of the supported macros listed below.
Based on the above example, the browser is redirected to the following URL:
https://adobe.com/callback?creative=123
Supported Macros
Click events support the macros listed in the following table. A macro is a small unit of self contained code that activates when the ad tag loads for campaign and user tracking. The macros will be passed along with the destination URL, as long as they are marked with the following format: %macro%
. Some keys do not have macros and accept a hard coded ID value instead. Keys that accept hard coded values are required if you want to analyze data in the Audience Optimization Reports.
d_adgroup
%d_adgroup%
Numeric ad group ID from the ad server.
Optional.
d_adsrc
No macro.
Accepts a hard coded ID value.
Advertiser ID.
An integration code for your advertiser's data source. Note that this is not related to Audience Manager data sources.
Required for Audience Optimization reports.
d_bu
%d_bu%
Numeric ID for the business unit.
Required for Audience Optimization reports.
d_campaign
%d_campaign%
Numeric campaign ID from the ad server.
Required for Audience Optimization reports.
d_creative
%d_creative%
Numeric creative ID from the ad server.
Required.
d_dpid
%d_id%
Data provider ID.
Often used with d_dpuuid
to link a data provider ID to a user ID.
Optional.
d_dpuuid
%d_dpuuid%
Unique user ID supplied by the data provider.
Often used with d_dpid
to link a user ID to a data provider ID.
d_mid
%d_mid%
Experience Cloud ID (ECID). For more information about the ECID, see Cookies and the Experience Cloud ID.
Optional.
d_placement
%d_placement%
Numeric placement ID from the ad server.
Optional.
d_region
%d_region%
The numeric region ID for the DCS cluster that services a request. For more information about the DCS, see Data Collection Components.
Optional.
r_rand
%r_rand%
Random number used for cache busting.
Optional.
d_site
%d_site%
Numeric site ID from the ad server.
Optional.
d_src
%d_src%
DPID of the source from where Audience Manager pulls the metadata.
Required.
d_uuid
%d_uuid%
Specify the ID of the visitor directly in the URL instead of relying on Demdex cookie.
Optional.
gdpr
${gdpr}
Related to the Audience Manager Plug-in for IAB TCF.
gdpr
can be 0 (GDPR does not apply) or 1 (GDPR applies).
Default value is 0.
Optional.
gdpr_consent
${gdpr_consent_XXXX}
Related to the Audience Manager Plug-in for IAB TCF.
If gdpr=1
, then ${gdpr_consent_XXXX}
is replaced by the gdpr_consent
string and the vendor ID (see IAB specification).
Default value is 0.
Optional.
Macros Example
This example demonstrates passing the creative, adgroup, and placement macros. It assumes the values for each parameter are passed in the non-redirect portion of the click-tracking call.
creative=1235
campaign=4709
adgroup=3408
placement=1001
src=203
Request
https://client.demdex.net/event?d_event=click&d_creative=1235&d_src=203&d_campaign=4709&d_adgroup=3408&d_placement=1001&
d_rd%3Dhttp%253A%252F%252Fadobe.com%252Fcallback%253Fcreative%253D%2525d_creative%2525%2526campaign%253D%2525d_campaign%2525%2526adgroup%253D%2525%0Ad_adgroup%2525%2526d_placement%253D%2525placement%2525%2526src%253D%2525d_src%2525
Response
Based on the above example, the browser is redirected to the following URL:
https://adobe.com/callback?creative=1235&campaign=4709&adgroup=3408&placement=1001
Additional functionality - Audience Optimization Reports
You can use pixel calls to power the Audience Optimization Reports. See Overview and Mappings for Metadata Files if you wish to use pixels to power the reports.