Publisher Tag Implementation for Partners

The Publisher Tag is a JavaScript snippet that automatically converts direct brand links into tracking links, captures impression data, and, with Trackonomics Essentials, enables page-level reporting.

Depending on your specific setup and add-ons, the tag provides four primary features:

Feature

Description

Requirement

Link Transformation

Automatically converts brand links into tracking links. With Trackonomics Essentials, this extends to any of your connected networks.

Basic integration
Conditionally, Trackonomics Essentials

Impression Tracking

Measures link visibility by tracking how often links are viewed.

Basic integration
Brand-side activation

Page-Level Tracking

Provides granular revenue data for specific pages via the Overview by Story report.

identifyUser

Captures advanced traffic data for more precise conversion path reporting.

identifyUser Implementation

Publisher tag placement

Depending on how you want to use the Publisher Tag, it can be placed:

In the <head> tag of your web pages — [Recommended] place the code at the bottom of the <head> of each of the web pages on which you want it to run.
In the <body> tag of your web pages — place the code in the <body> of each of the web pages on which you want it to run.
In the header template of your website — [Recommended] place the code at the bottom of your header template if you want it to run automatically on all of your webpages.

Copy the Publisher Tag

From the top navigation bar, select Content → Ad Tools.
In the Publisher Tag section on the right, select [Toggle-on] to enable Third Party Click Tracking, or select [Toggle-off] to disable it.
- Note: Third-party click tracking enables tracking from external partner networks on pages where the tag runs. To view this data in the Overview by Story report, you must first activate the free Trackonomics Essentials add-on.
Under the code snippet, select Copy Tag to copy the code to your clipboard.

Install the Publisher Tag with a basic integration

The process for installing your Publisher Tag is different depending on whether your website is locally hosted, CMS-hosted, or whether you use a tag manager.

Use this method if you manage your website's code directly, rather than hosting it on a CMS or website platform.

Open the source code of the web page on which you want to install the Publisher Tag.
In your web page's code, find the <head> opening tag at the top.
Paste the entire Publisher tag code at the end of the section, making sure that everything is before the </head> closing tag.
Repeat this for each webpage on which you want the Publisher Tag to run.

Test your basic integration

Once you've installed the Publisher Tag code snippet on your website, you should test the integration to make sure it's working correctly. Use your browser’s developer console to check that the link transformation and impression tracking features are working.

Check your website links

Open your browser's developer console by hovering over a link, then right-click and select Inspect (or Inspect Element).
- Check that the link in the <a href=””> quotation marks looks like an impact.com tracking link (e.g., https://advertiser.sjv.io/ ).
Alternatively, hover over links on your web page. Most browsers will show the link's path in the browser’s status bar in the lower-left corner. The link should look like an impact.com tracking link (e.g., https://advertiser.sjv.io/ or similar).

Check impression tracking

Note: If you're using Safari, make sure to enable the Status bar from the top menu. Select View → Show Status Bar (or on your keyboard, hold [Command] + / [Forward slash]).

Open your browser's developer console by hovering over a link, then right-click and select Inspect (or Inspect Element).
In your browser’s developer console, select the Network tab. Refresh the page to capture fresh data.
- In the list under Type, check that an xhr or beacon has fired with a Status of 200.
Alternatively, you can search your Partner ID in the Network tab. The format of the line item is {trackingdomain}/i/partnerId/adId/campaignId with an xhr or beacon Type and Status of 200.

Install the Publisher Tag with identifyUser

Heads up! The advanced integration requires a skilled web developer who understands how this integration changes the script, along with the implications of the function. We strongly advise consulting with a developer before attempting this integration.

Integrating using identifyUser is the recommended approach, because submitting authenticated user data through identifyUser can allow for improved attribution.

The identifyUser function also captures non-personally identifiable information (non-PII).

Step 1: Modify the script

Add the following line of code to the Publisher Tag body before the other function calls:
```
impactPublisher('identifyUser', {properties}, {options});
```

Once you've added the new code, the full tag will look similar to this:

<script type="text/javascript">
    (function(a,b,c,d,e,f,g){e['ire_o'] = c;e[c] = e[c] || function(){(e[c].a = e[c].a||[]).push(arguments)};f = d.createElement(b);g = d.getElementsByTagName(b)[0];f.async = 1;f.src = a;g.parentNode.insertBefore(f,g);})('//d.impactradius-event.com/<UNIQUE_ID>.js','script','impactPublisher',document,window);
    impactPublisher('identifyUser', {properties}, {options});
    impactPublisher('transformLinks', {properties}, {options [augmentLinksOnly, addImpressions]});
    impactPublisher('trackImpression', {properties}, {options});
    impactPublisher('trackLinks');
</script>

Step 2: Install the script

Once you’ve modified the script, you can follow the basic integration instructions to install the script.

Step 3: Test your identifyUser integration

Once you've installed the Publisher Tag code snippet on your website, you should test it to make sure it's working correctly. Testing the advanced integration requires knowledge of how to dynamically pass the partnercustid or customeremail variables.

Once this is configured, check the Network tab of your browser’s developer console for partnercustid={passedid} and customeremail={passedemail}.

Note: For more information on the Publisher Tag, read the Publisher Tag FAQ. If you’re unsure how to accomplish any of the mentioned steps in this article, contact support.

PreviousCreate & Manage Vanity Links NextFind Specific Landing Page URLs or Vanity Links as a Partner

Last updated 12 days ago

Was this helpful?