Step 1: Determine the Appropriate Click Identifier Parameter
Each advertiser’s tracking platform may expect the click ID to be passed using a specific query parameter (e.g., click_id, sub1, ref_id, etc.). It is the advertiser’s responsibility to confirm which parameter their platform accepts for storing session or click identifiers that will be returned in their postback to GoKart.
Example:
If the advertiser’s tracking platform expects a click identifier under the sub1 parameter, GoKart must pass the click id value in the tracking link using sub1={gk_click_id}.
Step 2: Structure the Offer URL in GoKart
In the GoKart offer setup, configure the Offer Link to include the expected parameter and macro. Use {gk_click_id} as the macro, which GoKart will automatically replace with a unique ID during redirect.
Example format:
https://advertiser.example.com/track?sub1={gk_click_id}Additional parameters can be appended using standard query string formatting, such as:
https://advertiser.example.com/track?sub1={gk_click_id}&campaign={gk_offer_name}When a user clicks on the offer, GoKart will dynamically replace the macro, resulting in a URL like:
https://advertiser.example.com/track?sub1=efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32&campaign=offertest
Step 3: Advertiser Stores the gk_click_id
The advertiser's tracking platform must store the gk_click_id received in the offer URL. This allows it to be returned to GoKart when a conversion occurs.
It is essential that this value is retained throughout the user’s funnel so it can be retrieved upon conversion.
Step 4: Advertiser Send a Postback to GoKart
When a user completes the desired action, the advertiser’s platform must send a server postback to GoKart. GoKart will validate the click ID and attribute the conversion to the appropriate user and offer.
Example postback:
https://gokart.api/track?gk_click_id=efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32
Best Practice: Test Your Postback Before Launch
Most partner platforms provide a built-in testing tool that allows you to fire a test conversion/postback without needing a real user to complete the flow.
Before going live, we strongly recommend:
Ask the advertiser or platform contact to trigger a test conversion using their testing feature.
Verify the postback reaches GoKart and appears correctly in the Conversions Report or callback logs.
Troubleshoot any missing parameters or mismatches before enabling traffic.
This simple pre-launch check prevents the majority of tracking issues and ensures the integration is fully aligned before real users begin converting.
