Skip to main content

Partner Tracking Link Setup

For partners to properly track users and attribute conversions, follow this guide on how to implement GoKart tracking links to your external system

Written by GoKart Support

Accessing Tracking Links

Offer URLs are available directly within the partner portal.

To access the Offer URL:

  1. Log in to your partner portal

  2. Locate the offer you want to run

  3. Open the offer details (e.g., click the eye icon)

  4. View the URL in the Offer Details tab


Required Parameters

⚠️ Important:

The tracking link in the Offer Details will not work on its own. You must append the required parameters below for the link to redirect properly. Missing, invalid, static, or reused values may result in failed redirects, broken tracking, rejected conversions, or lost attribution.

Parameter

Description

Examples

Notes

pub_click_id

Your unique click identifier

?pub_click_id={unique_1}

Used to map conversions back to your system

In this example, {unique_1} is an example partner click macro

pub_member_id

Your internal user ID

?pub_member_id={my_member_id}

Required for GoKart to validate that a user can't complete an offer more than once.

In this example, {my_member_id} is an example partner user ID macro

For additional information on how to pass your pub_member_id, see more details below.


Additional Optional Parameters

Parameter

Description

Example

Notes

pub_sub_1pub_sub_15

Custom sub parameters available for your own tracking and reporting purposes.

?pub_sub_1=campaign_a

Can be used to pass additional partner internal metadata


How to Append Parameters

Option 1: Manually append to the URL

?pub_click_id={unique_1}&pub_member_id={my_member_id}
  • In this example, {unique_1} is an example partner click macro

  • In this example, {my_member_id} is an example partner user ID macro

Option 2: Use the Customize URL Form

  1. Enter your system macros in the available fields

  2. The Offer URL will automatically update

  3. Copy the final URL once generated


Example Tracking Link

Tracking link (from portal):

https://api.brownboots.getgokart.ai/api/v1/offer-link/redirect/ec3e2f2b-4f95-4674-8ca0-c7ffbf3dbd5e?pub_click_id=PUB_CLICK_ID&pub_member_id=PUB_MEMBER_ID
  • PUB_CLICK_ID and PUB_MEMBER_ID would be replaced with your system’s corresponding click and user/member ID macros.

Final tracking link (with macros appended):

https://api.NETWORKNAME.getgokart.ai/api/v1/offer-link/redirect/abc123f2b-4f95-4670-8ca0-c7ffbf3dbd43?pub_click_id={unique_1}&pub_member_id={my_member_id}
  • In this example, {unique_1} is an example partner click macro

  • In this example, {my_member_id} is an example partner user ID macro


How to Use pub_member_id for Partners

pub_member_id is used by GoKart to validate that a user cannot complete the same offer more than once. This value should be unique per user (or per click/session if unique users are unavailable).

  • If You Do NOT Have User IDs, you can reuse your click ID:

?pub_click_id=PUB_CLICK_ID&pub_member_id=PUB_CLICK_ID

PUB_CLICK_ID would be replaced with your system’s corresponding click and user/member ID macros.


❌ Common Errors:

1. Missing pub_member_id

Why this happens:

A member id value was not passed in the pub_member_id parameter of the URL

Error Message:

PubMemberId cannot be empty

How to fix:

  • Always include a pub_member_id value in the URL

  • Pass a CLICKID value if you don’t have a user ID

2. Static/Repeat pub_member_id

Why this happens:

Static or repeat values such as a site ID, placement ID, or other shared identifiers were passed in the pub_member_id parameter of the URL.

What happens:

  • If a recurring value is passed, only the first conversion associated with that pub_member_id value will be recorded.

  • All subsequent conversions using the same value will be ignored

How to fix:

  • Ensure pub_member_id is:

    • Unique per user, OR

    • Unique per click/session (if user IDs are not available)

  • Do NOT use static values or shared identifiers. (e.g. site ID, app ID, placement ID)


Best Practices

  • Always generate a unique pub_click_id per click

  • Validate your final URL before launching

  • Test at least one click + conversion before going live


Quick Checklist

Before launching an offer, confirm:

  • Tracking link copied from portal

  • pub_click_id is appended

  • pub_member_id is appended

  • Link redirects successfully

  • Click ID is being generated correctly

Did this answer your question?