Unique Naming (Click)

Toma
Toma
  • Updated

Adform click tracking code is used to track clicks on a website buttons or links. The tracking code utilizes JavaScript functions, which gather visit count, basic visitor information (such as browser type, operating system, or screen size) and sends this information along with campaign data to Adform servers.

Implementation

Click tracking code consists of a link to a code library and a JavaScript tracking function. Both must be placed on the same page in order for the click tracking to work.

Add Tracking Code Library

In order for the tracking function to send out tracking requests, the library must be loaded on the page beforehand:

<script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>

It can be added either in the <head>, or <body> sections of the website prior to the click tracking function:

<html>
<head>
    <title>Page</title>
    <script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>
</head>
<body>
<button type="button">Click here!</button>
</body>
</html>

The tracking point library needs to be loaded only once per page in case of multiple click tracking point implementation.

Add Click Tracking Function

Once the library is added to the page, you can add the click tracking function to track the needed element on the page. In most cases, it can be added via 'onclick' event.

Example HTML page implementation via onclick event

<html>
<head>
    <title>Page</title>
    <script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>
</head>
<body>
<button type="button" onclick="return window.adf&&adf.ClickTrack(this, {trackingId}, 'Example Name',{});">Click here!</button>
</body>
</html>

The tracking function also supports custom implementation within page code functions, or via tag management solutions which support event triggers.

Example JavaScript code

if (window.adf) {
    e.preventDefault();
    adf.ClickTrack(this, {trackingId}, 'Example Name', {});
}

Example JavaScript code implementation

<html>
<head>
    <title>Page</title>
    <script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>
</head>
<body>
<button type="button" id="button">Click here!</button>
<script type="text/javascript">
        document.getElementById('button').addEventListener("click", function(e) {
            if (window.adf) {
                e.preventDefault();
                adf.ClickTrack(this, {trackingId}, 'Example Name',{});
            }
        });
</script>
</body>
</html>

Custom Variables

Additional information can be collected by the tracking point with the use of variables, such as sales, order IDs, product names, or other custom values.

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.

Example of the tracking code output with sales, order ID, and two products passed

window.adf&&adf.ClickTrack(this,{trackingID},'Example name',{sales:'95.29',orderid:'YWZ-487921','itms':[{productname:'Product A'},{productname:'Product B'}]});

Extended IDs

By passing extended identifiers with tracking point requests, you can collect first-party data-based audiences.

Example of Extended IDs implementation

<script type="text/javascript" src="https://s2.adform.net/banners/scripts/st/trackpoint-sync.js"></script>
    <script type="text/javascript">
        adf.eids = [{
          source: 'adserver.org',
          uids: [{
            id: 'TTD_ID_FROM_USER_ID_MODULE',
            atype: 1
          }]
        }, {
          source: 'adserver.com',
          uids: [{
            id: 'COM_ID_FROM_USER_ID_MODULE',
            atype: "2"
          }, {
            id: 'COM_ID_FROM_USER_ID_MODULE',
            atype: "1"
          }]
        }];
    </script>
    <a href="https://adform.com" onclick="adf.ClickTrack(this,2454360,'WebsiteName|SectionName|SubSection|PageName')">Adform</a>

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 Chrome web store.

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

Click

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).

Was this article helpful?

/
How we can make it better?

Thank you for your feedback!