This article explains how to use the Superior Tracking and Transformation tag, aka STAT tag, a snippet of javaScript code you can add to your website. The core functionalities of the STAT tag are to transform relevant direct links on your website into tracking links and track impressions each time a user loads the page. The basic integration offers two features, while the advanced integration offers an additional feature:
Transform links — When loaded with your webpages, the STAT tag will detect any direct links you're using to send traffic to the landing pages of brands you work with and automatically convert them into impact.com tracking links. When users follow these links, you'll receive credit for any actions that result from driving that traffic.
Impression tracking — The STAT tag will also count impressions for your transformed links each time it's loaded on the page, which can be viewed as a report in impact.com. For this feature to work, the brands you're working with need to enable it in their impact.com account.
Identify User (Advanced integration only) — The STAT tag can track a range of additional information, like item IDs, products, and more, along with traffic information for more accurate conversion path reporting.
Depending on how you want to use the STAT 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.
From the top navigation bar, select Content → Ad Tools.
Under the STAT Tag section, select [Toggle on] Enable.
Under the code snippet, select Copy to copy the code to your clipboard.
The process for installing your STAT 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 STAT tag.
In your web page's code, find the
<head>
opening tag at the top.Paste the entire STAT 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 STAT tag to run.
If you use a Content Management System (CMS) or 3rd-party website platform like Wordpress, Squarespace, Wix, etc., refer to their help docs on how to add a JavaScript tag to your website. A quick web search should surface some results on how to install a JavaScript tag for your particular CMS. See examples below:
If you use a Tag Management System (TMS) for your website, you'll need to add a custom HTML tag to your website. Refer to the tag manager's help docs on how to do this. For example:
Once you've installed the STAT 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.
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).
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
orbeacon
has fired with a Status of200
.
Alternatively, you can search your Partner ID in the Network tab. The format of the line item is
{trackingdomain}/i/partnerId/adId/campaignId
with anxhr
orbeacon
Type and Status of200
.
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.
The advanced integration expands the STAT tag feature set with the identifyUser
function, which you can use to track specific product item IDs, categories, and other fields. This is especially useful if you work with brands that use a product catalog. The identifyUser
function also captures non-personally identifiable information (non-PII). Any PII collected, like customer emails, must adhere to SHA-1 standards when sent to impact.com.
Add the following line of code to the STAT tag body after the
trackImpression
function:impactStat('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','impactStat',document,window); impactStat('transformLinks', {properties}, {options [augmentLinksOnly, addImpressions]}); impactStat('trackImpression', {properties}, {options}); impactStat('identifyUser', {properties}, {options}); </script>
Optionally, customize the function with additional parameters in the
{properties}
section, depending on your use case. For example, if you want to track product catalog SKUs:impactStat('identifyUser', {category: "", item: "", customerid: "", customeremail: ""}, {options});
Replace the quotation marks ("") with the value that you want to track in quotation marks (e.g.,
category: "creditcard"
)The
customerid
orcustomeremail
must be passed dynamically on each user visit.
Once you’ve modified the script, you can follow the basic integration instructions to install the script.
Once you've installed the STAT 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 customerid
or customeremail
variables.
Once this is configured, check the Network tab of your browser’s developer console for customerid={passedid}
and customeremail={passedemail}
.
Note: If you’re unsure how to accomplish any of the mentioned steps in this article, contact support.