Unique Naming (Javascript)

Solveiga
Solveiga
  • Updated

To track website visits from specific pages or events, Adform uses a standard unique tracking code. The tracking code logs users' visits and sends basic browser information, such as browser type, operating system, or screen size, to Adform. This data helps attribute visits to specific campaigns.

Note

To track multiple pages, we recommend using either URL Path or custom tracking points. This is effective for smaller websites, as each page can have its own tracking point.

For very large websites (for example, with more than 10,000 pages), it may be impractical to give each page a unique tracking point. In this case, you can group pages with similar content or functionality and then assign tracking points based on these groupings.

Implementation

By default, the code loads asynchronously, so it can be implemented to any part of the web page code. If you don't need to pass additional parameters, such as 'sales', 'order ID', and others, you can paste it into the source code of the page or tag management solution.

Note

In rare cases, when you need to load the tracking code before the rest of the page continues loading, you might use asynchronous implementation. Use this option only if you have specific requirements that depend on the tracking code running before other website scripts.

Tracking code template (asynchronous)

Implement the code to any part of the source code or the respective tag management field that supports HTML code.

<!-- Adform Tracking Code BEGIN -->
<script type="text/javascript">
    window._adftrack = Array.isArray(window._adftrack) ? window._adftrack : (window._adftrack ? [window._adftrack] : []);
    window._adftrack.push({
        HttpHost: '{trackingSubdomain}.adform.net',
        pm: {trackingID},
        divider: encodeURIComponent('|'),
        pagename: encodeURIComponent('Example tracking point')
    });
    (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://s2.adform.net/banners/scripts/st/trackpoint-async.js'; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })();

</script>
<noscript>
    <p style="margin:0;padding:0;border:0;">
        <img src="https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=Example%20tracking%20point&ADFdivider=|" width="1" height="1" alt="" />
    </p>
</noscript>
<!-- Adform Tracking Code END -->

Insert the following mandatory parameters into your code:

JS Name

Value

Value Type

pm

Tracking setup ID of Adform client

numeric

pagename

Name of tracking point

string

HttpHost

Tracking domain

string

The divider parameter specifies which character in the name will be treated as the name separator and will be replaced with the pipeline character ( | ) on the Adform platform. The pipeline character acts as the name separator on the platform:

Note

If you specify the divider in the code as something else, for example, an underscore character ( _ ), and the name is one_two_three, the platform will register it as one|two|three .

Example on an HTML page implementation

<html>
<head>
    <title>Homepage</title>
</head>
<body>
<!-- Adform Tracking Code BEGIN -->
<script type="text/javascript">
    window._adftrack = Array.isArray(window._adftrack) ? window._adftrack : (window._adftrack ? [window._adftrack] : []);
    window._adftrack.push({
        HttpHost: 'track.adform.net',
        pm: 520801,
        divider: encodeURIComponent('|'),
        pagename: encodeURIComponent('Example tracking point')
    });
    (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://s2.adform.net/banners/scripts/st/trackpoint-async.js'; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })();

</script>
<noscript>
    <p style="margin:0;padding:0;border:0;">
        <img src="https://track.adform.net/Serving/TrackPoint/?pm=520801&ADFPageName=Example%20tracking%20point&ADFdivider=|" width="1" height="1" alt="" />
    </p>
</noscript>
<!-- Adform Tracking Code END -->
</body>
</html>

Custom Variables

To collect values from your website, you can use macros from the CMS or tag manager system. Pass this information to the code via respective system variables, data layer, or other tools to get variable values from the site.

Note

For more information, see Variables (JavaScript).

Tracking code example with order ID, sales, and one product passed

<!-- Adform Tracking Code BEGIN -->
<script type="text/javascript">
    window._adftrack = Array.isArray(window._adftrack) ? window._adftrack : (window._adftrack ? [window._adftrack] : []);
    window._adftrack.push({
        HttpHost: 'track.adform.net',
        pm: 520801,
        divider: encodeURIComponent('|'),
        pagename: encodeURIComponent('Example tracking point'),
        order: { 
            sales: {insert_sales_value_here},
            orderid: '{insert_order_id_value_here}',
            itms: [{
                productname: '{insert_product_name_value_here}',
                productid: '{insert_product_id_value_here}',
                productsales: {insert_product_sales_value_here}
            }]
        }
    });
    (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://s2.adform.net/banners/scripts/st/trackpoint-async.js'; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })();

</script>
<noscript>
    <p style="margin:0;padding:0;border:0;">
        <img src="https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=Example%20tracking%20point&ADFdivider=|" width="1" height="1" alt="" />
    </p>
</noscript>
<!-- Adform Tracking Code END -->

Extended IDs

By passing extended identifiers (EIDs) with tracking point requests, you can build audiences based on first-party data.

JavaScript-based tags support the common openRTB eids format.

Asynchronous tag example

<script type="text/javascript">
    window._adftrack = Array.isArray(window._adftrack) ? window._adftrack : (window._adftrack ? [window._adftrack] : []);
    window._adftrack.push({
        HttpHost: 'track.adform.net',
        pm: 520801,
        divider: encodeURIComponent('|'),
        pagename: encodeURIComponent('Example tracking point'),
        // Extended identifier setup start
        eids: [{
            source: 'advertiser.com', // website domain, or ID consortium domain
            uids: [{
                "atype": 1, // id source type, according to openRTB list https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/2.x_official_extensions/eids.md#object--extended-identifier-uids-
                "id": 'some user identifier' // provided user id
            }]
        }]
        // Extended identifier setup end
    });
    (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://s2.adform.net/banners/scripts/st/trackpoint-async.js'; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })();
</script>

Synchronous tag example

<script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>
<script type="text/javascript">
    adf.Params.HttpHost = 'track.adform.net';
    adf.Params.PageName = encodeURIComponent('Example tracking point');
    adf.Params.Divider = encodeURIComponent('|');
    // Extended identifier setup start
    adf.eids = [{
        source: 'advertiser.com', // website domain, or ID consortium domain
        uids: [{
            "atype": 1, // id source type, according to openRTB list https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/2.x_official_extensions/eids.md#object--extended-identifier-uids-
            "id": 'some user identifier' // provided user id
        }]
    }];
    // Extended identifier setup end
    adf.track(2117129);
</script>

A visitor ID that Adform adds to the audience after applying ID Fusion, or lookalike modeling. Extended IDs are additional entities in the audience, that Adform adds programmatically, based on the seed audience.

Check Implementation

After implementing the tracking point on a page, to check if it was activated, you can use Adform Site Tracking Helper extension for Chromium-based browsers.

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

Network

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

  1. Tracking point library

  2. A tracking point request, which contains the tracking setup ID, tracking point name, and other information sent

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

A visitor ID that Adform adds to the audience after applying ID Fusion, or lookalike modeling. Extended IDs are additional entities in the audience, that Adform adds programmatically, based on the seed audience.

Was this article helpful?

/
How we can make it better?

Thank you for your feedback!