Skip to main content

gk_click_id

Written by GoKart Support

Overview

  • The gk_click_id is GoKart’s unique session identifier that links a user’s click to their eventual conversion.

  • When a user clicks an offer link, GoKart generates a unique gk_click_id and records it along with contextual metadata such as the offer ID, member ID, and timestamp.

  • In the offer’s tracking link (URL), GoKart requires that the {gk_click_id} macro be appended in order to successfully pass the ID downstream to the advertiser or third-party tracking system (e.g., AppsFlyer, TUNE, etc.).

  • When a conversion is received, GoKart references the gk_click_id in the incoming postback from the advertiser or tracking system to identify the correct click record and member to attribute the conversion.


gk_click_id in Action

User Clicks an Offer

  1. The user clicks an offer within GoKart.

  2. GoKart records the click and generates a unique gk_click_id.

  3. The user is redirected to the advertiser’s offer URL with gk_click_id appended

    Example tracking link:

    https://google.com?sub1={gk_click_id}

    Destination link after click:

    https://google.com?sub1=efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32

    In this example, {gk_click_id} is dynamically replaced with the real click id: efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32.

Conversion Occurs

  1. When the advertiser or tracking system (e.g., TUNE or AppsFlyer) fires a postback, it returns the same gk_click_id that was generated during the click.

  2. GoKart matches the gk_click_id from the postback with the stored click record.

  3. Upon validation, the conversion is recorded.

    Example postback:

    https://api.getgokart.ai/postback?gk_click_id=efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32&event_id=win_10_games

    Notice how the same gk_click_id (efb2a7d2-c01a-4e3f-b8a1-81b4568e9f32) generated after the click in the example above is passed back in the postback.


Technical Details

Attribute

Description

Format

Alphanumeric UUID

Generated

At the time of click redirect

Stored

Persistently within GoKart’s click database

Used in

Tracking links, postbacks, click/conversion reports, and attribution logs

Required in

All offer tracking links
All incoming postbacks for conversion attribution


Duplicate Prevention

  • Each gk_click_id is unique per click session and can only be used once for conversion credit. GoKart allows only one conversion per click ID and member ID combination. This ensures one valid conversion per click and member to prevent double crediting.

  • If a postback is received with an already processed gk_click_id that’s tied to a member who already has a recorded conversionId, GoKart automatically flags it as a duplicate and rejects it (unless “Allow Repeat Conversions” is enabled).


On Invalid or Missing Click IDs

  • If a gk_click_id is missing or invalid in the incoming postback, GoKart cannot map the conversion to a valid click.

  • Such conversions will be unattributed and logged as errors in the History Logs.


gk_click_id & Diagnosing Discrepancies

  • When reconciling data between GoKart and a tracking system (AppsFlyer or TUNE), the gk_click_id is the only reliable identifier for matching specific conversions.

  • Within GoKart, gk_click_id is visible and searchable across all reports.

  • In the advertiser’s tracking system, it will appear in the parameter used to capture the click ID—for example, sub1 in the example above.

  • This allows teams to trace a user’s full attribution path and pinpoint mismatches, missing parameters, or untracked conversions.

Did this answer your question?