Adtech is a German-American digital marketing company that retails products used to manage, serve and evaluate online advertising campaigns (including display, video, and mobile formats). The company was acquired by the web portal AOL on May 15, 2007.
Adtech provides an integrated ad-serving platform. The product allows publishers, advertisers, agencies, and ad networks to manage their display, video, and mobile digital advertising campaigns.
Exporting segments to ADTECH ad server
-
In the menu bar, go to Master data → Key Groups.
-
Enter the name for a new key group in the Add new key group text box and click Add.
-
Click the name of the new key group to add keys to it.
For each segment, follow these steps:
-
Click Add.
-
Set the key to "CxSegments". It is important that this is spelled exactly the same way as in the tag!
-
Copy the segment name into the Caption input field.
-
Copy the segment ID into the value input field at the bottom of the form.
-
Set Preselect to "Yes".
-
Set Multi select to "No".
Ad tag modification
At runtime, the current user's assigned segments need to be read by Piano Audience and provided to the ADTECH ad tag so that the ADTECH ad server can match the user to a targeted ad or campaign.
This integration uses ADTECH's "Key Value Targeting" for this purpose. See the "Key Value Targeting" documentation for more details.
In essence, we need to add a key value "CxSegments" with multiple values to the ADTECH ad server URL.
For example, if we have a user matching two segments ("12" and "23"), we want to add those parameters to the URL:
;kvCxSegments=12:23
This can be done by modifying a typical ADTECH ad tag like this one:
<!-- AdTech ad tag begin -->
<script type="text/javascript">
// Setup and run the AdTech ad request
document.write('<scr'+'ipt type="text/javascript" src="http://' + 'adserver.adtech.de/multiad/3.0/25/0/0/-1/ADTECH' +
';mode=multiad;plcids=12345;loc=100;target=_blank' +
';misc=' + new Date().getTime()+ '"></scri'+'pt>');
</script>
<script type="text/javascript">
// Place the ad
ADTECH_showAd(12345, document, false);
</script>
<!-- AdTech ad tag end -->
A tag modified to include the current user's segments in the ad server request URL:
<!-- DMP-targeted AdTech ad tag begin -->
<script type="text/javascript">
// Load cx.js
document.write('<scr' + 'ipt type="text/javascript" src="http' +
(location.protocol === 'https:' ? 's://s' : '://') + 'cdn.cxense.com/cx.js"></scr' + 'ipt>');
</script>
<script type="text/javascript">
// Send an analytics event to setup cross-site user id link so that we can read user segment ids
cX.setSiteId('<TODO: Insert your site id here!>');
cX.sendPageViewEvent();
// Read the user segment ids from DMP
var segments = cX.getUserSegmentIds({ persistedQueryId: '<TODO: insert persisted query id here>' });
var adtechTargeting = (segments && segments.length) ? ';kvCxSegments=' + segments.join(':') : '';
</script>
<!-- Modified AdTech ad tag -->
<script type="text/javascript">
// Setup and run the AdTech ad request
document.write('<scr'+'ipt type="text/javascript" src="http://' + 'adserver.adtech.de/multiad/3.0/25/0/0/-1/ADTECH' +
';mode=multiad;plcids=12345;loc=100;target=_blank' +
adtechTargeting + ';misc=' + new Date().getTime()+ '"></scri'+'pt>');
</script>
<script type="text/javascript">
// Place the ad
ADTECH_showAd(12345, document, false);
</script>
<!-- DMP-targeted AdTech ad tag end -->
Learn how to set up the cX.getUserSegmentIds(..) call here.