Skip to main content

Partner Postback Setup Guide

Written by GoKart Support

Partners have the ability to add a postback URL in their partner portal.

A postback is a server-to-server notification sent from GoKart to the partner's external system when a conversion event occurs.

It allows you to:

  • Track conversions in real time

  • Attribute events back to your users

  • Sync performance data into your system


Postback Configuration Options

GoKart supports two types of postbacks:

1. Event-Level Postbacks

You can configure postbacks per offer and per event.

This means:

  • Each offer can have its own configuration

  • Each event within an offer can trigger a different postback

  • You can send different data depending on the event type

Example use cases:

  • Send “Install” events to one endpoint

  • Send “Purchase” events to a different endpoint

  • Track multi-event funnels separately

2. Global Postback (Applies to all events)

A Global Postback is a single endpoint that triggers for every conversion event within an offer.

Key behavior:

  • Fires on all conversions

  • Useful for quick integrations or full data sync


⚠️ If both options are configured: both postbacks will fire.

For example, if you have:

  • an event-level postback for “Install – Game X”, and

  • a global postback

GoKart will send a postback to both endpoints when that event occurs:

  • one to the event-level postback URL

  • one to the global postback URL


Available Postback Macros

GoKart supports dynamic macros that are replaced with real conversion values when a postback is fired.

Available Macros

Macro

Description

Example Value

{pub_click_id}

Unique click identifier generated at click time

abc123xyz

{pub_member_id}

Partner’s internal user ID

user_98765

{gk_offer_id}

Unique offer identifier

3b8ced3d-35f2-46fb-a031-109f16ee6c8a

{gk_offer_name}

{cnv_event_id}

Unique event identifier within an offer for a multi-event offer.

For single-event offers, it is null.

9df7f2b4-d403-435b-860e-cc18754d8e87

{cnv_amount}

The transaction value associated with the conversion event (e.g., sale amount).

5.00, 10, etc.

{pub_sub_1}{pub_sub_15}

Custom sub fields 1–15


Example Postback

https://yourdomain.com/postback?click_id={pub_click_id}&user_id={pub_member_id}&offer_id={gk_offer_id}&event_id={cnv_event_id}

How Postback Setup Works

Step 1: Choose Scope

Decide if you want:

  • Event-level postbacks (specific events)

  • Global postback (all events)


Step 2: Configure Endpoint

Enter your postback URL in the partner portal.


Step 3: Test Integration

Reach out to your POC from the affiliate network or advertiser to trigger a test conversion and verify:

  • Postback is received

  • Macros are correctly populated

  • Events are mapped correctly


Did this answer your question?