Shopify Integration
Overview
Katalys requires advertisers to have our tracking technology running on your store’s pages (for fraud detection and user verification) and on “Thank You” pages (for capturing conversions), accordingly. Katalys has developed an integration with Shopify’s CRM/CMS system that solves both of these with a One-Click-Install application!
Pre-Requisites
You must have an active Katalys advertiser profile (Katalys Marketing Platform, a.k.a., “KMP”)
If you do not have a KMP advertiser profile, please create a profile: https://auth.katalys.com/signup
The account that will be used to install Shopify must be a member of the corresponding KMP profile
Installation
You can install the app in just a few steps!
If installing from Shopify App Store for the first time, please use this link: https://shop-app.katalys.com/
Step | Action |
---|---|
1 | Log into your Shopify admin account. |
1a | After logging in to install the Katalys app, you will be redirected to this page, where you should click the Install button: ![]() |
2 | Once installation is initiated, you will be redirected to this page, where you must enter your KMP Tracking ID and connect your store: ![]() |
3a | To get your tracking ID, if not provided by your Katalys account manager:
|
3b | Return to the Shopify app store to paste your KMP tracking ID into the Tracking ID field and select the Connect your store and enable tracking button to complete the Shopify install. ![]() |
Retrieving your Katalys Tracking ID
During the onboarding process, you will be prompted to install the Katalys Tracking Script onto your site, which will direct you to your Katalys Integrations Page:
![image-20240725-183032.png](../__attachments/1045594128/image-20240725-183032.png?inst-v=ee5edfdf-54ac-4b18-a65c-778ed0958072)
On the Integrations page, copy the Katalys TrackingID and paste on the Shopify Connect Your Store page (see Step 3b, above section).
![image-20240725-182504.png](../__attachments/1045594128/image-20240725-182504.png?inst-v=ee5edfdf-54ac-4b18-a65c-778ed0958072)
Your customers are your customers! Collected data is only used to attribute that growth where appropriate in accordance with our Privacy Policy. Katalys partners with advertisers to create strong relationships to help you drive performance -- our focus is your success!
Compatibility with other Shopify Apps
In general, the Katalys app is a read-only application. There are no known compatibility issues or concerns with any other applications.
An exception is the “Thank You” page, where Katalys needs to place a conversion pixel to attribute the revenue correctly. If you use an application that modifies or replaces the checkout page – i.e. One Click Upsell, ReCharge, CartHook, etc. – then clone the Katalys pixel into that tool's “Conversion Pixel” configuration area.
Here are some example implementations we’ve used in the past to integrate with third-party Shopify Checkout plugins:
These Third-Party Plugins do not allow for automatic placement of our Tracking Script. You must manually place the Tracking Script onto all Thank You pages via the BackEnd of the Third-Party Plugin.
The URL in the snippets below may vary slightly based on your account’s needs. Please confirm your snippet is correct before implementing it.
Default Pixel (may vary per your install)
<script type="text/javascript" src="{{YOUR-TRACKING-ID}}" async></script>
CartHook Checkout Pixel (HTML) & Thank You Page Script (JS)
<script src="https://db.revoffers.com/shopify-carthook.js" async></script>
<script src="https://db.revoffers.com/_track.js" async></script>
// OR
<script type="text/javascript" src="{{YOUR-TRACKING-ID}}" async></script>
var el=document.createElement("script");
el.src="{{YOUR-TRACKING-ID}}";
(document.head||document.getElementsByTagName("head")[0]).appendChild(el);
ReCharge Checkout Pixel
<script src="{{YOUR-TRACKING-ID}}?order_id={{order_number}}&subtotal_amount={{subtotal_price}}" async></script>
Unify CRM
<script src="{{YOUR-TRACKING-ID}}?order_id={{_ORDER_ID_}}&sale_amount={{_ORDER_TOTAL_}}" async></script>
Integration Troubleshooting
The plugin adds a snippet of JavaScript to your web pages. This snippet enables Katalys to
attribute orders to its affiliates.
Although not required, to validate the plugin integration, access your online store’s source code and look for JavaScript snippet, similar to:
https://db.revoffers.com/js/{{YOUR-TRACKING-ID}}.js[?...]