Custom Naming (Iframe)

Toma
Toma
  • Updated

Adform iframe custom naming tracking code is used to track visits to a website either on one specific page, or multiple pages at once. This code will generate a unique tracking point based on the tracking point name which is passed to the code.

The tracking code uses 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

Define Pagename Parameter

The Pagename parameter is responsible for the tracking point name, which is assigned once the code is activated. The pagename parameter should correspond to the page where the tracking code is activated to recognize the tracking points later in the platform using analytics or retargeting.

Example of a tracking code with Pagename to be modified

<iframe src="https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=WebsiteName|SectionName|SubSection|PageName&ADFdivider=|&ADFtpmode=4" style="display:none;"></iframe>

Default mandatory parameters:

Parameter name

Value

Value type

pm

Tracking setup ID of Adform client

numeric

ADFPageName

Name of tracking point

string

Values can be passed from any source that defines the tracked page. For example, part of page URL, page title, bread-crumbs, CMS variables, or any other source as long as the assigned value allows to identify the tracked page.

Implement Tracking Code

Once the pagename is defined, the code can be added to the source code of the page or the respective tag management field which supports HTML code.

In case of dynamic tracking point naming, make sure the code is set on as many pages or sections as necessary, or unconditionally on all websites.

Example of an HTML page implementation

<html>
<head>
    <title>Homepage</title>
</head>
<body>
<iframe src="https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=website.com/homepage&ADFdivider=|&ADFtpmode=4" style="display:none;"></iframe>
</body>
</html>

As the tracking point generates tracking points dynamically, it is recommended to exclude it from pages that are not required to be tracked, such as development, CMS, or test pages.

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.

For conversion page tracking, we recommend implementing a unique naming tracking point.

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

<iframe src="https://track.adform.net/Serving/TrackPoint/?pm={trackingID}&ADFPageName=Example%20name&ADFdivider=|&ADFtpmode=4&itm={sl:'95.29',id:'YWZ-487921','itms':[{pnm:'Product A'},{pnm:'Product B'}]}" style="display:none;"></iframe>

Extended IDs

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

You can pass extended IDs with a dedicated query parameter. Multiple EID parameters are supported.

Parameter format:

eid_<source>_<atype>=<userid_value>

Example of Iframe implementation

<iframe src="https://track.adform.net/Serving/TrackPoint/?pm=2117129&ADFPageName=WebsiteName|SectionName|SubSection|PageName&ADFdivider=|&eid_advertiser.com_1=123456&eid_id5-sync.com_2=54321" width="1" height="1" alt="">
</iframe>

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!