Skip to main content

Callback Schema: v1

Written by GoKart Support

Example request body

{
"id": "af5877b5-83cf-408c-bde9-85dd21ab19e6",
"sentAt": "2024-09-18T18:29:26.8469471+00:00",
"conversion":
{
"status": "Success",
"rejectionReason": null,
"userCompletedAt": "2025-05-19T15:36:19.756249+00:00",
"isRewardSent": true,
"viewId": "62feb0a5-33fe-4571-8b4e-6763b27dd000",
"clickId": "34e72cca-7b4e-321q-805d-b91fbaba437b",
"conversionId": "abcd17c9-878d-4afb-999c-6c8e3091b160",
"offerId": "6a8273c6-fe06-4be2-927e-c8be786c3fff",
"offerName": "Test",
"offerAdvertiserId": "ee70b574-1234-4b4e-8b99-46e050754d1c",
"offerEventId": null,
"offerAdvertiserName": "Brown Boots",
"offerCategoryId": "ddd1dade-0988-41e6-89e7-07f55c9f74be",
"offerCategoryName": "Credit",
"offerCountryId": "5b03d969-cef9-4b99-a2dc-d8415536fc7c",
"offerCountryCode2": null,
"offerCountryCode3": null,
"eventId": null,
"eventName": null,
"rewardPoints": 45,
"revenue": 60,
"pubMemberId": "421f91c7-c621-4ca5-bf9d-af3e6fbe7c61",
"pubClickId": null,
"pubSessionId": null,
"pubGender": null,
"pubAge": null,
"pubGeoCountry": null,
"pubGeoState": null,
"pubPostalCode": null,
"pubSub1": null,
"pubSub2": null,
"pubSub3": null,
"pubSub4": null,
"pubSub5": null,
"pubSub6": null,
"pubSub7": null,
"pubSub8": null,
"pubSub9": null,
"pubSub10": null,
"pubSub11": null,
"pubSub12": null,
"pubSub13": null,
"pubSub14": null,
"pubSub15": null,
"pubDevice": null,
"trackSysEventId": null,
"trackSysConversionId": null,
"trackSysConversionAmount": null,
"trackSysConversionIpAddress": null,
"trackSysConversionEmail": null,
"trackSysConversionUserId": null,
"trackSysConversionSub1": null,
"trackSysConversionSub2": null,
"trackSysConversionSub3": null,
"trackSysConversionSub4": null,
"trackSysConversionSub5": null,
"sequenceNumber": null,
"partnerId": null,
"partnerName": null,
"createdAt": "2025-05-19T15:36:19.756448+00:00"
"clickTime": "2025-05-19T15:36:19.756448+00:00"

}
}

Callback Fields

Field Name

Type

Description

Value Source

Example

id

UUID

Unique identifier of the callback record

GoKart

af5877b5-83cf-408c-bde9-85dd21ab19e6

sentAt

datetime

Timestamp when the callback was sent

GoKart

2024-09-18T18:29:26.8469471+00:00

status

string

Conversion status (Success, Pending, Rejected)

GoKart

Success

rejectionReason

string/null

Reason the conversion was rejected

GoKart

null

userCompletedAt

datetime/null

Time the user completed the offer

GoKart

2024-10-21T09:26:32.369306+00:00

isRewardSent

boolean

Indicates whether the reward has been sent

GoKart

false

viewId

UUID

Unique identifier for the view

GoKart

bf6fc719-f85b-48ac-81f7-9017b5be1990

clickId

UUID

Unique identifier for the click

GoKart

b5c445f5-378f-41b4-8653-4f032446f79e

conversionId

UUID

Unique identifier for the conversion

GoKart

ea499300-4aa3-45bf-9bf1-fc199bb97203

offerId

UUID

Unique identifier for the offer

GoKart

dd58fbe3-5251-49ea-92d0-10ef555e4e6e

offerName

string

Name of the offer

GoKart Offer Configuration

Heroic Journey

offerAdvertiserId

UUID

Unique identifier for the adviertser

GoKart

63c8f7d6-87e9-4a4b-9cdd-e4f2ed31f2d5

offerAdvertiserName

string

Name of the advertiser

GoKart Offer Configuration

Blizzard Inc.

OfferEventId

UUID

Unique identifier for the offer event

GoKart

328f81d5-e728-48b0-a8a2-028378577bcf

offerCategoryId

UUID

Unique identifier for the category

GoKart

56bf744f-ade6-4760-993c-a2c6bba796c8

offerCategoryName

string

Offer category name

GoKart Offer Configuration

MMORPG

offerCountryId

UUID

Offer country ID

GoKart Offer Configuration

3deb6b6c-fb69-4561-bf72-2cf35a366bfc

offerCountryCode2

string

ISO 2-letter country code

GoKart Offer Configuration

US

offerCountryCode3

string

ISO 3-letter country code

GoKart Offer Configuration

USA

eventId

string

Tracking identifier for the event

GoKart Offer Configuration

Install

eventName

string

Human-readable event name

GoKart Offer Configuration

Install

rewardPoints

integer

Points rewarded for the conversion

GoKart Offer Configuration

89

revenue

decimal/null

Revenue attributed to the conversion

GoKart Offer Configuration

89

pubMemberId

string

Publisher member ID

Publisher Query

abc_123

pubClickId

string/null

Publisher click ID

Publisher Query

null

pubSessionId

string/null

Publisher session ID

Publisher Query

null

pubGender

string/null

Publisher gender

Publisher Query

null

pubAge

integer/null

Publisher age

Publisher Query

null

pubGeoCountry

string/null

Publisher country

Publisher Query

null

pubGeoState

string/null

Publisher state

Publisher Query

null

pubPostalCode

string/null

Publisher postal code

Publisher Query

null

pubDevice

string/null

Publisher device

Publisher Query

null

pubsub1 – pubsub15

string/null

Additional publisher sub parameters

Publisher Query

null

trackSysEventId

string/null

Event ID from external tracking system

Tracking System (Postback)

evt_12345

trackSysConversionId

string/null

Conversion ID from external tracking system

Tracking System (Postback)

conv_67890

trackSysConversionAmount

string/null

Amount recorded by tracking system

Tracking System (Postback)

49.99

trackSysConversionIpAddress

string/null

IP address from tracking system

Tracking System (Postback)

203.0.113.42

trackSysConversionEmail

string/null

Email from tracking system

Tracking System (Postback)

trackSysConversionUserId

string/null

User ID from tracking system

Tracking System (Postback)

user_abc

trackSysConversionSub1 – Sub5

string/null

Custom tracking system sub parameters

Tracking System (Postback)

sub_value_1

sequenceNumber

integer/null

Order index for dependent events

GoKart Offer Configuration

2

partnerId

UUID/null

ID of partner that generated the conversion

GoKart

56bf744f-ade6-4760-993c-a2c6bba796c8

partnerName

string/null

Name of partner that generated the conversion

GoKart

Partner ABC

createdAt

datetime

Timestamp when the conversion record was created

GoKart

2024-09-18T18:24:51.621197+00:00

clickTime

datetime

Timestamp when the click was created

GoKart

2024-09-18T18:24:51.621197+00:00


Value Source Legend

  • GoKart: Identifiers generated by GoKart

  • GoKart Offer Configuration: Values defined in the GoKart platform during offer and event creation and setup.

  • Tracking System (Postback): Values sent by the external tracking system in the conversion postback.

  • Publisher Query: Values supplied by the publisher via query parameters

Did this answer your question?