Cookie-Based Implementation

This page describes a method for pushing data from your website where you already use an existing affiliate network software or attribution technology. You will need to have a deep understanding of web technologies, how to store long-lived, cross-session, cross-domain cookies on your website, and ensure your implementation is kept up-to-date with the latest web tracking and opt-out technologies.

This method is not recommended due to lack of transparency for Katalys affiliates, limited data postback options, and lower attribution rates which dilute your program’s value to affiliates. Katalys has developed a custom deterministic identity graph that ensures your affiliates get credit for only the orders they drive without you needing to do this heavy lift. We highly recommend starting with any of our plugin-based approaches for smooth and fast onboarding with no developer time.

To get started with sending data back to Katalys, you must:

Retrieve your Tracking ID from the Katalys “Integrations” page
This is the data silo that has been created to collect data for your integration. This is frequently named using a KA- prefix followed by random numbers/letters.
Go to your account’s Integrations page →
Configure your website to store attribution information
You must have an attribution technology tool implemented on your site that can store Katalys tracking information, such as transaction_id, offer_id, and aff_id. Either a) the transaction_id parameter must be defined or b) the offer_id and aff_id parameter must be defined.
- Inbound Katalys links should contain the URL parameters transaction_id, offer_id, and publisher_id.
- You will need to store these values and offer them back to Katalys after a conversion takes place.
- As an example:
  For URL: https://example.com/page1?utm_source=Katalys&transaction_id=1234abcd&offer_id=1234&publisher_id=5678
  You would store transaction_id=1234abcd, offer_id=1234, and aff_id=5678

To create a JavaScript pixel, you will combine your regular “Custom Integration” Katalys JS tag with additional custom JavaScript that records your conversion event. The pixel should be placed on your Thank-You page that is presented to the end-user. This pixel can be fired within an iframe or run directly on the source of the page.

To create your custom postback, get your script on the Katalys Platform’s Integrations page → and combine it with the following example.

Remember to replace the {variable} syntax below with your own values. See Reporting Schema for all available data keys.

HTML

{{ PASTE YOUR KATALYS JS TAG HERE }}

<script>
_revoffers_track.push({
    type: "force_convert",
    site_id: "{katalys_tracking_id}",
    order_id: "{your_crm_order_id}",
    sale_amount: "{sale_amount}",
    subtotal_amount: "{sale_amount}",
    email_address: "{email_address}",
    discount_1_code: "{coupon_code}",
    transaction_id: "{katalys_transaction_id}",
    offer_id: "{katalys_offer_id}",
    aff_id: "{katalys_aff_id}"
});
</script>

Initial Requirements

JavaScript Pixel