Skip to main content
Skip table of contents

Shopify Integration

Overview

Katalys requires Advertisers to include our tracking pixel on Landing Pages (for fraud detection and user verification) and on Thank You pages (for capturing conversions). Katalys has developed an integration with Shopify’s CRM/CMS system that solves both of these with a One-Click-Install application!

Installation

You can install the app in just a few steps!

Step

Action

1

  1. Go to https://shop-app.revoffers.com/

  2. On the form, enter your Shopify Store’s name.

    1. Enter the Tracking ID found on your Katalys Marketing Platform Integrations Page (instructions below).

  3. Click on “Continue To Shopify”.

image-20240215-191511.png

2

Authorize the app
The app needs a few basic permissions so that it can add the scripts to your pages. Details on these permissions are later in this article.

3

The app will register your store
The page will load in 3-5 seconds, then show a completion message.

4

Activate the tracking codeblock

Close the install process and find the section “Enable the Tracking Pixel”. Click the link to enable tracking.

And… you’re done!

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.

There you will be able to copy the Katalys ID associated with your site.

image-20240531-212401.png

Katalys Tracking ID, found on upper-right.

Verifying Installation

The plugin adds a snippet of JavaScript to your web pages. This snippet enables Katalys to
attribute orders to its affiliates.
To verify the plugin has been installed and the appropriate caches have been cleared,
look at the source code of any public page -- we suggest simply starting with the homepage. The
process to view a page's source is slightly different depending on which browser you're using, but
most offer an option of "View Page Source" when right-clicking on the page.

Within the source of the page, you should see a JavaScript snippet as indicated below:

HTML
<script type="text/javascript" src="https://db.revoffers.com/_track.min.js" async></script>
OR
<script type="text/javascript" src="https://db.revoffers.com/_track.js" async></script>

Permissions

The app requests the following permissions:

  • View Shopify account data
    This is Shopify’s default permission.

  • View Orders [read-only, required]
    This is our primary data source. We inspect orders for coupons, line items, or traffic sources as defined and configured according to the Advertiser’s needs. The Katalys platform is very flexible; it can trigger conversions based on coupons, modify deal structures for line items, and more.

  • View Products [read-only]
    We frequently need to sync up with clients product information or SKU lists for communication to our Affiliates. When this permission is included, we can streamline this process ensuring a smooth rollout of your Affiliate Campaigns.

  • View Checkouts [read-only]
    This permission allows us to more accurately attribute conversions from 3rd Party or External Checkout Experiences and Funnels, as well as provide for my analytical product data.

  • Manage your Online Store
    This permission includes the “ScriptTag” asset, and Theme files. This is how the app adds the tracking script to Landing Pages and Thank You Pages.
    We add a snippet at snippets/revoffers.liquid into your active themes.
    We do not replace or modify your theme files save for ONE operation: we add this to the bottom of your layout.liquid file: {% include 'revoffers' %}

Your customers are your customers! Collected data is only used to attribute that growth where appropriate in accordance with our Privacy Policy.  RevOffers partners with brands to create strong relationships to help you drive performance -- our focus is your success! 

Compatibility with other Shopify Apps

In general, the RevOffers 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

JavaScript errors detected

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

If this problem persists, please contact our support.