Google Tag Manager Installation

Katalys (formerly “RevOffers”) requires Advertisers to include our tracking pixel on Landing Pages (for fraud detection and user verification) and on Thank You pages (for capturing conversions).

There are 2 parts to integrating with Katalys:

1. Visitor Reporting
   This is a JavaScript file that will record clicks and incoming transaction IDs. It records when someone lands on your site from our network.

2. Order Reporting
   This can be accomplished by installing our WooCommerce or Shopify plugins, or via a custom JavaScript implementation on the Thank You page of a checkout flow. 

Part 1: Visitor Reporting

You can use Google Tag Manager to easily deploy your account’s JavaScript snippet site-wide. Minimally this must be done on pages that will potentially receive traffic from our affiliates, but it’s safer to simply launch site-wide.  This script will record when visitors land on your pages from the Katalys Network.

1. Log into your Google Tag Manager Workspace Dashboard
   Click ‘New Tag’ to add the Katalys tracking script to your page.

   

2. Enter the name for the Tag
   Click “Tag Configuration” to select the Tag Type, and select “Custom HTML” for the Tag Type. With this Tag Type, you can directly plug in the snippet for the Katalys Tracking Script.

   

3. Place your tracking JavaScript snippet in the HTML content section
   Retrieve your JavaScript snippet from your account in the Katalys platform by navigating to your account’s Integrations page and selecting your desired Tracking ID to implement. Click “Google Tag Manager”, and copy the snippet. Then paste the snippet into the “HTML” section in Google Tag Manager.
   
   Get your Google Tag Manager script on the Katalys Platform’s Integrations page →

5. Configure Tag Triggers
Click ‘Triggering’ to set the Trigger Configuration for this Tag.

6. Ensure the Script fires on all pages

Select the ‘All Pages' Trigger of type ‘Page View’.

7. Save the changes to create the Custom Tag

Click the ‘Save’ button to finalize Tag/Trigger Configuration.

8. Publish the Tracking Script to your site!

Click ‘Submit’ to add the Custom Tag to your live website.

Part 2: Order Reporting

On the Thank You page after the customer has completed an order and an Order ID is known, add additional details before the Katalys JavaScript tag.

This portion relies on how your marketing or development team implemented Google Tag Manager; specifically, your team must have passed customer and order information into the Google Tag Manager Data Layer on the post-sale page so that you can use those values in Google Tag Manager. Read more about GTM’s Data Layer →

Order Example

Below is an example showing how we implemented Order Reporting within GTM. The variables used here were defined within Google Tag Manager, and populated by the marketing team from a checkout funnel.

<script src="{{YOUR-CUSTOM-URL}}" async></script>
<script type="text/javascript">
_revoffers_track = window._revoffers_track || [];
_revoffers_track.push({
    action: "convert",
    order_id: "{{Order ID}}",
    sale_amount: "{{Order Total}}",
    subtotal_amount: "{{Order Subtotal}}",
    email_address: "{{User Email}}",
    discount_1_code: "{{Coupon Used}}",
});
</script>
<script type="text/javascript">
// is in separate <script> tag in case of JS-parse errors
var lineItems = {{Order Line Item Array}};
for (var i = 0; i < lineItems.length; i++) {
    var item = lineItems[i];
    _revoffers_track.push({
        ['line_item_' + i + '_title']: item.productName,
        ['line_item_' + i + '_sku']: item.SKU,
        ['line_item_' + i + '_price']: item.unitPrice,
        ['line_item_' + i + '_qty']: item.quantity,
    });
}
</script>

Permissions

The scope utilized by Katalys is below:

• Having the Katalys tracking JavaScript on your website

• Sending Order Status updates to Katalys so we can trigger your custom business rules

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 brands to create strong relationships to help you drive performance -- our focus is your success! 

Compatibility with other 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 here is the “Thank You” page – Katalys needs to place a conversion pixel to attribute the revenue correctly. If you use an application that modifies or replaces the checkout page, then you must clone the Katalys pixel into that tool's “Conversion Pixel” configuration area.