Shopify Troubleshooting

In general, the Katalys app is a read-only application. There are no known compatibility issues or concerns where the Katalys app might cause another application to fail. There are, however, applications that prevent the Katalys app from working correctly by preventing JavaScript from being added to the page, or by changing or replacing the post-sale “Thank You” pages. Read more below on how to validate that Shopify was installed correctly on your store.

Validating Landing Pages

The Katalys app adds a snippet of JavaScript to your web pages. This snippet enables Katalys to attribute orders to its affiliates. To validate the plugin integration, access your online store’s source code and look for JavaScript snippet, similar to:

CODE

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

You can easily validate Landing Pages using Chrome Debugger tools by following our validation guide.

If you cannot find any data-collection after following our validation guide, review the following suggestions to troubleshoot:

If you see no additional JavaScript on the page, then your Shopify template may not have the appropriate tags that inject site-wide scripts. Follow Shopify’s documentation on creating fully-integrated Shopify themes.
If your Shopify frontend application is self-hosted, then the Katalys Shopify app is only suitable for Order Status reporting. You must integrate the JavaScript directly by following our Custom Integration instructions for Landing Page Tracking and Thank-You page Tracking.

Validating Post-Sale Pages

The Katalys app should trigger a snippet of JavaScript on your post-sale “Thank You” page. You can see this happen by executing a test order. Follow our validation guide for Thank-You Page Tracking for details.

If validation fails, you may have a conflicting Shopify application installed on your store. This means you need to understand how to place JavaScript into any app that modifies or replaces your post-sale pages. Below are examples we have created to support clients using common Shopify applications.

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.

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

CODE

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

CODE

var el=document.createElement("script");
el.src="{{YOUR-TRACKING-ID}}";
(document.head||document.getElementsByTagName("head")[0]).appendChild(el);

ReCharge Checkout Pixel

CODE

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

Unify CRM

CODE

<script src="{{YOUR-TRACKING-ID}}?order_id={{_ORDER_ID_}}&sale_amount={{_ORDER_TOTAL_}}" async></script>