Variables (iframe)

With Adform custom variables you can pass additional information such as sales, order IDs, product names, or other custom values via the tracking point together with information collected by default (such as browser type, operating system, or screen size).

The data is sent to Adform servers and later can be used for retargeting or analytics purposes.

Order and Product Level Variables

Variables can be passed either on order (single value) or product (multiple value) levels.

Order Level

Order level variables are used for values unique per each activation and are used when a single value needs to be passed at a time, such as the order ID or total sales amount of a purchase. These variables are defined in the scope of itm object:

window.adf&&adf.ClickTrack(this,{trackingID},'Example tracking point',{sales:'insert sales value here',orderid:'insert order id value here',currency:'insert currency value here'});

Product Level

Product level variables are used to pass information about each individual item, such as product cart details. These variables are defined in the itms array, which is added to the order object.

window.adf&&adf.ClickTrack(this,{trackingID},'Example tracking point',{'itms':[{productname:'insert product name value here',productid:'insert product id value here',productsales:'insert product sales value here'}]});

If there are several items which need to be passed, that can be done by creating an additional item in the array:

itms: [{
    productname: 'insert product 1 name value here',
    productid: 'insert product 1 id value here',
    productsales: 'insert product 1 sales value here',
},{
    productname: 'insert product 2 name value here',
    productid: 'insert product 2 id value here',
    productsales: 'insert product 2 sales value here',
},{
    productname: 'insert product 3 name value here',
    productid: 'insert product 3 id value here',
    productsales: 'insert product 3 sales value here',
}]

window.adf&&adf.ClickTrack(this, {trackingID}, 'Example tracking point', {
    sales: 'insert sales value here>',
    orderid: 'insert order id value here',
    'itms': [{
        productname: 'insert product 1 name value here',
        productid: 'insert product 1 id value here',
        productsales: 'insert product 1 sales value here'
    }, {
        productname: 'insert product 2 name value here',
        productid: 'insert product 2 id value here',
        productsales: 'insert product 2 sales value here'
    }, {
        productname: 'insert product 3 name value here',
        productid: 'insert product 3 id value here',
        productsales: 'insert product 3 sales value here'
    }]
});

Custom Variables

Variables in Adform come with predefined names (such as Sales, Order ID) and also custom ones, which can be renamed in Adform platform.

These variables can pass values at the order or product level:

https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=Example tracking point&ADFdivider=|&itm={sv1:'insert sv1 value here',svn1:'insert svn1 value here',var1:'insert var1 value here','itms':[{sv2:'insert sv2 value here',svn2:'insert svn2 value here',var2:'insert var 2 value here'}]}&rdir=<insert redirect URL here>

Supported variables:

Check Implementation

After implementing the tracking point on a page, you can check if it was activated using Adform site tracking testing browser extension. You can download it for a Chrome browser from the web store.

Alternatively, you can check network requests via the browser’s developer tools:

Successful activation will result in two network requests, which are:

Javascript variables are encoded in Base 64 function before sending the tracking point request to Adform servers where the data is decoded.

https://track.adform.net/Serving/TrackPoint/?pm={trackingId}&ADFPageName=Example%20tracking%20point&ADFdivider=%7C&ord=896447548360&Set1=en-US%7Cen-US%7C1600x900%7C24&ADFtpmode=2&itm=eyJzbCI6IjYwIiwiaWQiOiIxMjM0NSIsIml0bXMiOlt7InBubSI6IlByb2R1Y3QgQSIsInBzbCI6IjQwIn0seyJwbm0iOiJQcm9kdWN0IEIiLCJwc2wiOiIyMCJ9XX0&loc=http%3A%2F%2Fsite.adform.com%2F

eyJzbCI6IjYwIiwiaWQiOiIxMjM0NSIsIml0bXMiOlt7InBubSI6IlByb2R1Y3QgQSIsInBzbCI6IjQwIn0seyJwbm0iOiJQcm9kdWN0IEIiLCJwc2wiOiIyMCJ9XX0

For additional information, contact the Site Tracking team (site-tracking@adform.com).