Skip to end of metadata
Go to start of metadata

Table of Contents


Overview

XPO AdTag™ is a JavaScript tag that Knorex provides you to enable the following:

  • capturing the activities, engagements and intentions as the visitor navigates the webpages or website

Things to note:

  • embedding XPO AdTag should not affect or alter the visual aspect of your website, if it does, let us know
  • XPO AdTag uses aynchronous mode and hence does not slow the loading of your website / web pages

Non-Expandable Ad Tag

The following XPO ad tags are for non-expandable creatives. You can generate the ad tags via XPO ARENA.

There are 2 formats available : (a) Javascript tag; and (b) iFrame tag. For each format, there are 2 available options (a) normal and (b) adaptive. 

  • In normal mode: the creative size is fixed and will not change with different device or screen sizes. 
  • In adaptive mode: the creative size will adapt / adjust to the screen size available.

You can set these options in the CMS. If JavaScript ad tag is used, switching between these two options does not incur any changes in the ad tag. However, in iFrame ad tag, switching between normal and adaptive mode requires you to update the ad tag. 

 

Javascript Tag
<script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>'></script>
iFrame Tag (Normal)
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>"></iframe>
iFrame Tag (Adaptive)
<iframe frameborder=0 scrolling=no width="100%" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>"></iframe>

Enabling Macros

The ad tags can handle DFP click macros, DBM click macro, view-through macros, and custom macros  from other systems. 

Enabling DFP Click Macros

DFP click macro name is “click”, and the placeholder is “%%CLICK_URL_ESC_ESC%%”.

We expect the value of click macro to be escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.

Javascript Tag
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=%%CLICK_URL_ESC_ESC%%&ct=click'></script>
iFrame Tag
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=%%CLICK_URL_ESC_ESC%%&ct=click"></iframe>

Enabling DBM Click Macros

DBM click macro name is “click”, and the placeholder is “${CLICK_URL} or ${CLICK_URL_ESC_ESC}”.

We expect the value of click macro to be encoded or escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.


Javascript Tag with Click Macro escaped twice
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL_ESC_ESC}&ct=click'></script>
Javascript Tag with Click Macro encoded
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL}&ct=click'></script>
iFrame Tag with Click Macro escaped twice
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=%%CLICK_URL_ESC_ESC%%&ct=click"></iframe>


iFrame Tag with Click Macro encoded
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL}&ct=click"></iframe>

Enabling Third Party Click Macros

DBM click macro name is “click”, and the placeholder is “${CLICK_URL} or ${CLICK_URL_ESC} or  ${CLICK_URL_ESC_ESC}”.

We expect the value of click macro to be encoded or escaped once or escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.


Javascript Tag with Click Macro escaped twice
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL_ESC_ESC}&ct=click'></script>
Javascript Tag with Click Macro escaped once
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL_ESC}&ct=click'></script>
Javascript Tag with Click Macro encoded
<script type='text/javascript' src=‘//sv.brand-display.com/adedge/api/bd/serving/simple/js?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL}&ct=click'></script>
iFrame Tag with Click Macro escaped twice
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=%%CLICK_URL_ESC_ESC%%&ct=click"></iframe>


iFrame Tag with Click Macro escaped Once
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=%%CLICK_URL_ESC%%&ct=click"></iframe>


iFrame Tag with Click Macro encoded
<iframe frameborder=0 scrolling=no width="300" height="250" src="//sv.brand-display.com/adedge/api/bd/serving/simple/frame?aukey=<adtag_id>&_=%%CACHEBUSTER%%&click=${CLICK_URL}&ct=click"></iframe>


Enabling Third-Party Tracking

We support third-party pixel tracking. To do that, you can include the XPO™ ARENA CMS. The acceptable format is the URL pointing to the tracking pixel.

 For example, the tracking pixel is <IMG SRC=“http://example.com/pixel” WIDTH=“1” HEIGHT=“1”/>, the source URL is to be passed to the ARENA CMS.


Expandable Ad Tag

The following ad tags are for expandable creatives. You can generate the ad tags from Knorex XPO™. There are two available options - normal and adaptive.

  • Normal mode: the creative size shall be fixed, regardless of the device or screen size available. 
  • Adaptive mode: the creative size shall be adaptive to the screen size available.

You can set these options in the CMS. However, switching between these two options does not incur any changes in the ad tag. For expandable ad tag, we have only JavaScript tag.

 

JavaScript Tag

Javascript Tag
<div id=“c52e2a1d5ece78524502"></div>
<script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>'></script>

Enabling Macros

The ad tags can handle DFP click macros, view-through macros, and custom macros from other systems. 

Enabling DFP Click Macros

DFP click macro name is “click”, and the placeholder is “%%CLICK_URL_ESC_ESC%%”.

We expect the value of click macro to be escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.

 

Javascript Tag
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=%%CLICK_URL_ESC_ESC%%&ct=click'></script>

Enabling DBM Click Macros

DBM click macro name is “click”, and the placeholder is “${CLICK_URL} or ${CLICK_URL_ESC_ESC}”.

We expect the value of click macro to be encoded or escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.


Javascript Tag with Click Macro escaped twice
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=${CLICK_URL_ESC_ESC}&ct=click'></script>
Javascript Tag with Click Macro encoded
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=${CLICK_URL}&ct=click'></script>

Enabling Third Party Click Macros

DBM click macro name is “click”, and the placeholder is “${CLICK_URL} or ${CLICK_URL_ESC_ESC}”.

We expect the value of click macro to be encoded or escape once or escaped twice. 

Example click URL is http://example.com/click. Therefore, the macro value should be “http%253A//example.com/click”.


Javascript Tag with Click Macro escaped twice
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=${CLICK_URL_ESC_ESC}&ct=click'></script>
Javascript Tag with Click Macro escaped Once
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=${CLICK_URL_ESC}&ct=click'></script>
Javascript Tag with Click Macro encoded
<div id="c52e2a1d5ece78524502"></div><script type='text/javascript' src='//sv.brand-display.com/adedge/api/bd/serving/simple/js2?aukey=<adtag_id>&_=%%CACHEBUSTER%%&wrap=c52e2a1d5ece78524502&click=${CLICK_URL}&ct=click'></script>


Enabling Third-Party Tracking

We support third-party pixel tracking. To do that, you can include the XPO™ ARENA CMS. The acceptable format is the URL pointing to the tracking pixel.

For example, the tracking pixel is <IMG SRC=“http://example.com/pixel” WIDTH=“1” HEIGHT=“1”/>, the source URL is to be passed to the ARENA CMS.


  • No labels