Skip to main content
Skip table of contents

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”)

  • 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:

image-20240723-162642.png

2

Once installation is initiated, you will be redirected to this page, where you must enter your KMP Tracking ID and connect your store:

image-20240725-124706.png

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.

image-20240725-132237.png

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

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
https://www.loom.com/share/c3765ba1b5674bc09108d1ed4ac1e230?sid=d91225e4-ba58-4997-84be-a70e06753684

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)

HTML
<script type="text/javascript" src="{{YOUR-TRACKING-ID}}" async></script>

CartHook Checkout Pixel (HTML) & Thank You Page Script (JS)

HTML
<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>
JS
var el=document.createElement("script");
el.src="{{YOUR-TRACKING-ID}}";
(document.head||document.getElementsByTagName("head")[0]).appendChild(el);

ReCharge Checkout Pixel

HTML
<script src="{{YOUR-TRACKING-ID}}?order_id={{order_number}}&subtotal_amount={{subtotal_price}}" async></script>

Unify CRM

HTML
<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:

HTML
https://db.revoffers.com/js/{{YOUR-TRACKING-ID}}.js[?...]
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.