Reporting Custom Events

This document will review how to set up and implement additional Katalys event tracking. These events allow a Brand to report on funnel analytics for their own benefit, or to provide insights to Partners. This data can be used to perform funnel depth analysis or optimize media buying. 

Quick Start

After you have implemented the Katalys Tracking Script on your webpage, either by installing a Katalys plugin or by completing a custom integration, you can send events into the script with the following code.

<script>_revoffers_track.push("INSERT_EVENT_NAME")</script>

For example, to trigger an event named “addtocart”, add the following script:

<script>_revoffers_track.push("addtocart")</script>

Once you modify the script with the name you desire, copy the script and implement it in ADDITION and AFTER our site script on the desired pages or triggered on the event you’re looking to track.

1. Site Script: <script src="https://db.revoffers.com/js/KA-XXXXXXX.js" async></script>

2. Place the new event script in ADDITION & AFTER the above site script.

3. Repeat these steps for any additional events you want to track

4. Notify the Katalys team you’ve finalized the implementation for a QA check

If you see errors in your browser console, such as Uncaught ReferenceError: _revoffers_track is not defined, this means that the Katalys Tracking Script is not loading on your webpage. Confirm that you have implemented your tracking script properly.

Get your script on the Katalys Platform’s Integrations page →

Naming Your Events

Decide on what the event name will be and insert it into the highlighted section of the above example script between the quotes. 

1. Do not use spaces

2. Do not use certain terms and names. See the prohibited list here. 

3. Suggested event names are also listed below should you want to use them. 

Suggested Event Names

Below is a list of suggested event names that may be applicable to your integration.

• addtocart: user added items to their cart

• thank_you: user has completed a pre- or post-sale funnel

• email_submit: user has submitted their email in a pre-sale funnel or in a survey

• survey_begin: user has entered a dedicated survey or questionnaire

• survey_complete: user completed the questionnaire before going into the checkout process

Prohibited Event Names

Please do not use the following event names as it will impact your wider integration. These terms are already reserved for events and actions on the Katalys Platform

• click or hasoffers_click

• convert

• nobounce

• pageview or page_view

How To View Events

Once tested and confirmed by the Katalys team, a dedicated Dashboard will be provided to you and or your partners upon your request to give visibility to the additional data.