Integrating Third-Party Tags in Admixer
When using third-party tags (banner script tags from other ad management systems) in Admixer, they should be placed as External codes. To ensure proper click tracking on the Admixer side, the third-party banner tag script must include the Admixer click macro.
Here is a list of macros that can be used for tracking clicks.
| Macro | Description |
|---|---|
| [clickUrl] | URL Macro. If your landing page contains dynamic UTM parameters (MACRO), utilize this macro. It will direct you to the target URL set in the Admixer interface. Encoded |
| [clickUrlUnesc] | URL Macro. If your landing page contains dynamic UTM parameters (MACRO), utilize this macro. It will direct you to the target URL set in the Admixer interface. Decoded |
| [clickTag] | Click tracking and target URL macro. Allows you to track clicks on third-party creatives in Admixer. Replaced with a click-through URL (encoded). The clickthrough redirects to the click handler: https://inv-nets.admixer.net/click.aspx?item=…&retUrl=. The target URL should be passed to the retUrl parameter. Encoded |
| [clickTrack] | Click tracking macro. Allows you to track clicks on third-party creatives in Admixer. Encoded. |
| [clickTrackUnesc] | Click tracking macro. Allows you to track clicks on third-party creatives in Admixer. Replaced with the click tracker. Decoded. |
| [clickTagUnesc] | Click tracking and target URL macro. Allows you to track clicks on third-party creatives in Admixer. Replaced with a click-through URL (encoded). The clickthrough redirects to the click handler: https://inv-nets.admixer.net/click.aspx?item=…&retUrl=. The target URL should be passed to the retUrl parameter. Decoded. |
| [CLICK] | Click tracking macro. Simple click. |
Click-Through Chain
The respective click macro in Admixer passes a click tracking link containing parameters used for reporting and analytics within the Admixer system. When a user clicks the ad, Admixer logs the interaction and then redirects the user to the landing page defined within the third-party ad tag.
Click Tracking with Admixer Macros
Some third-party tags are automatically recognized by the Admixer system, and the [clickTag] macro is applied without manual intervention (e.g., Somplo tags).
<somplo-tag
tagid='285865782'
width='320'
height='480'
prop='none'
type='banner'
prod='true'
tagtype='js'
platform='mweb'
autoexpand='false'
clickMacro='[clickTag]'
tech='2'
network='6'
close_button='false'
imp=''
CACHEBUSTER='[cachebuster]'
style='display: block;'>
<script src="https://cdn.somplo.com/prod/tags/080624/tag.min.js"></script>
<img src="data:image/png;base64, somplo" width="1" height="1" style="border:none;position: absolute"
onerror='if(typeof window.Somplo !== "function"){var s=document.createElement("script");s.src="https://cdn.somplo.com/prod/tags/080624/tag.min.js", this.parentElement.appendChild(s);}'>
</somplo-tag>
How to Insert the Admixer Click Macro
If the third-party tag doesn’t clearly define a placeholder for the click URL, refer to their documentation to identify where to insert the Admixer click macro. Typically, you'll replace the default click-through URL or tracking placeholder with the appropriate Admixer macro.
Example of Third-Party Tags with Admixer Click Macro
DoubleClick tag
<ins class='dcmads' style='display:inline-block;width:320px;height:100px'
data-dcm-placement='N2290532.4197679TURKCELLADPLUS/B33240815.416391899'
data-dcm-rendering-mode='script'
data-dcm-https-only
data-dcm-api-frameworks='[APIFRAMEWORKS]'
data-dcm-omid-partner='[OMIDPARTNER]'
data-dcm-gdpr-applies='gdpr=[GDPR]'
data-dcm-gdpr-consent='gdpr_consent=[GDPR_CONSENT_755]'
data-dcm-addtl-consent='addtl_consent=[ADDTL_CONSENT]'
data-dcm-ltd='false'
data-dcm-resettable-device-id=''
data-dcm-click-tracker='[CLICK]&ext_red='
data-dcm-app-id=''>
<script src='https://www.googletagservices.com/dcm/dcmads.js'></script>
</ins>
OpenX
<a href="[clicktagunesc]https://www.facebook.com/events/1024112802233098" target="_blank">
<img src="https://ads.clp.ge/banners/front.jpg" style="width:776px; height:119px ; position: absolute; z-index:2;opacity: 0.0">
</a>
<iframe scrolling="no" width="776" height="119" style="display: block; margin: auto; border: none;" src="https://openx.xxxxx.ge/banerebi/776x119TouchSammit2024"></iframe>
If a tag is generated within Admixer and click tracking is required in the Admixer interface
<script src="https://cdn.admixer.net/scripts3/loader2.js" async
data-sender="admixer"
data-inv="//inv-nets.admixer.net/"
data-r="always"
data-bundle="desktop">
globalAml.defineClickThrough('[clickTagUnesc]') - specify the click MACRO you need
</script>
Replace {clickMacro} with the appropriate macro (e.g., [clickTag], [CLICK]).
For tracking Confirmed views metric add
<script>window.IGNORE_ROOT = true;</script>
Additional Notes
- Always test the third-party banner within the Admixer platform to ensure the click tracking is functioning correctly.
- For tags that contain dynamic URL generation, consult with the third-party provider to ensure compatibility with the click macro.
- In case of difficulties, contact Admixer support for further assistance.
By following these guidelines, you can ensure accurate click tracking and proper performance measurement of your third-party banners within the Admixer system.