This article details how to install the Polar Pixel and how to configure tracking parameters for each of your ads to ensure you can view the most accurate attribution data in Polar Analytics. You can also use our CAPI to boost your ads performance.
Note: If you are using a headless build, skip the first two section. You need to include the Pixel script in the "For headless stores" section.
Polar Pixel overview
The polar pixel is a Shopify App Pixel. This is the recommended way to use Pixels on Shopify stores as it offers the most secure, reliable, and performant pixels.
The Polar Pixel is compatible with Shopify customer privacy settings. If you use a third-party provider for marketing consent, please ensure that they are compatible with Shopify customer privacy settings.
How-to: Install the Polar Pixel
Step 1: Make sure that the Polar Pixel is enabled on your subscription (This is a paid add-on feature)
If "Polar Pixel" is not enabled, ask us on the in-app chat or reach out to your Customer Success Manager to enable it. If it’s enabled, proceed to Step 2.
Step 2. Install the Polar pixel from the Pixel setup page.
Click on "Install"
Step 3. If you use any third-party checkout solutions other than Shopify (such as Recharge), you'll need to ensure that the Polar Pixel is also installed on those solutions. We have a few guides here on how to install the Polar Pixel on various 3rd party checkouts.
Please note that we do not currently have a way to install the Polar Pixel on:
Amazon Seller
Facebook / Instagram Checkout
TikTok Shop
Shopify Shop App
However, if orders from any of the above sales channels also are sent to Shopify, we can still ensure they're tracked.
Step 4. To ensure that the Polar Pixel is as comprehensive as possible, you must properly configure the tracking parameters of your ads. We've detailed the steps for how to set your tracking parameters in a set of tracking guides below.
For headless stores
On headless stores, you need to:
1 - copy the code below
2 - Add it as high as possible on your website <head> tag
3 - (Don't forget this) Replace the URL in line 4 with your Shopify store URL.
window.shopifyShopURL = '{your-url}.myshopify.com';
<script>
/* Begin Polar Analytics Pixel */
try {
window.shopifyShopURL = '{your-url}.myshopify.com';
} catch(e) {}
!function(){function load(retry){var PA=new XMLHttpRequest;PA.open("GET","https://cdn-production.polaranalytics.com/pap.txt?"+(new Date).toISOString().slice(0,10).replace(/-/g,""),!0),PA.send(),PA.onreadystatechange=function(){4===PA.readyState&&200===PA.status?setTimeout(function(){return eval(PA.responseText)},40):(299<PA.status||PA.status<200)&&retry&&load(retry-1)}}load(10)}();
/* End Polar Analytics Pixel */
</script>
Polar Tracking Parameters Guides
For each platform on which you have ads you need to configure, you can find a comprehensive walkthrough of how to configure the tracking of your ads below
If you'd like assistance with setting up the Polar Pixel or configuring tracking parameters, reach out to us via the in-app live chat and a member of our team will be happy to help!
NOTE: If your ads do not contain the following set of tracking parameters, we cannot guarantee comprehensive attribution results.
Common questions
"Additional scripts" are not allowed in Shopify checkouts anymore, how does installation works?
There is no need for an additional script, the polar pixel is a Shopify App Pixel. This is the recommended way to use Pixels on Shopify stores as it offers the most secure, reliable, and performant pixels.
We have other tracking pixels installed, is this a problem?
No problem, our tracking pixel is independent from other tracking sources, you can install it in parallel.
Do you foresee any issues in compatibility with consent banner app?
We don't foresee any issues. The Polar Pixel is compatible with Shopify customer privacy settings. If you use a third-party provider for marketing consent, please ensure that they are compatible with Shopify customer privacy settings
Do you support headless stores?
Yes but this guide does not apply for headless store. Please reach out to your customer success manager in this case.
Do we need to set up a new Conversion action on ad platforms like Google Ads?
We are not relying on google ads' pixel for tracking in any way, so there is no need to set up a conversion action on Google Ads or any other ad platform. When you click on "install" a small piece of code will be added to you Shopify theme (like all other pixels), and you then need to configure UTM parameters in your ad platforms, that's all.