Skip to main content

GoKart × Singular Integration Guide

This guide walks advertisers through securely connecting Singular to GoKart in order to run their affiliate marketing offers.

Written by GoKart Support

Part 1: Activate GoKart Integration in Singular

Log in to Singular

Activate Gokart Partner Integration

  1. Navigate to your Singular dashboard

  2. Go to Attribution Setup → Partner Configuration

  3. Find the search bar on the top right by Add Partner

  4. Search and select GoKart

  5. Select an app

Part 2: Retrieve your GoKart Postback

Access Your GoKart Postback Credentials

When integrating with GoKart, you will need to utilize the global postback in your profile.

Log in to GoKart

Access your GoKart dashboard using your unique login URL
(e.g., app.[YOUR_TENANT].getgokart.ai).

  1. In GoKart, click your profile icon

  2. Navigate to the Postback tab

  3. Click the eye icon next to your postback URL to view

You will see a full secure postback URL. From this URL, find the three required security values below

Retrieve Security Credentials

These values authenticate every install and in-app event sent from Singular to GoKart. Each advertiser receives unique values for the following that need to be inputted into the Singular Integration:

1. Security Signature

The authentication hash used to validate requests in the signature parameter

Example:

7FqR9KxD2WmA5N0B1TgYJcZs8vL3X4UeP-MH6tQEkdS

2. Postback Security Segment

The first encoded path segment immediately after /api/v1/

Example:

ZM-A9KxR5TQ2/Zu4Wn-8PmFJ7BqC6tHDrN0V/L5EoG2SxM9pTQaU3W/

3. Domain Name

The advertiser-specific domain/tenant name inside the URL.

Example:

Brownboots

Part 3: Enter Credentials into Singular

Configure GoKart Postback Settings

In the GoKart Parmaters field:

  • Paste Security Signature

  • Paste Postback Security Segment

  • Paste your Domain Name

Click Next.

Part 4: Configure App Settings in Singular

Configure In-App Events

  1. Navigate to In-App Events

  2. Add revenut events you wish you track under Revenue Events Postbacks

  3. Add other events you wish you track under Events Postbacks

Click Save.

Get Your Singular Tracking Link

  1. Navigate to Attribution Setup → Manage Links

  2. Create Link

    1. Link Type: Partner

    2. Source Name: GoKart

    3. Input tracking link name

    4. Define Link Setttings and Redirects

    5. Click Generate

  3. View Link Summary

  4. Copy Click-through tracking link

    1. This will be used during offer creation

Done

Part 5: Offer Creation in GoKart

Create a New Offer

  1. Navigate to Offer Management

  2. Click Create Offer

  3. Select Multi-Event

  4. Choose Singular as the Integration System

  5. Click Proceed

Offer Details

  • Select your Advertiser name (e.g., Brain Games)

  • Input your campaign name (e.g., Game_iOS_GoKart)

  • Provide an Offer name (e.g., "Pet the Dogs iOS") - this is what partners will see

  • Paste your Singular Click-through tracking link into the offer link field

  • Click Next.

Description & Creative

All offer details you configure here are shared with publishers and may be user-facing, so accuracy and clarity are critical to ensure clarity, engagement, and scale.

  • Add a Headline and Description (what end-users will see). Note: you can grab copy from the App or Play store and edit it down.

  • Select or add Categories (e.g., Golf, Sports).

  • Upload a Creative (e.g., an App Store screenshot).

  • Click Next.

Targeting & Budget

  • Enter your total Budget and Launch Date.

  • Set Gender (e.g., Select All) and Age Range (e.g., 18+).

  • Select the Platform (e.g., iOS).

  • Select target Countries (e.g., United States, South Africa, Australia).

  • Click Next.

Event Mapping

  • Create an event for the in-app events you configured in Singular

    • ⚠️Important Notes:

      • Set the Event ID as the SDK Event Name exactly as it is in Singular

      • Event ID for the Install event must always be Install

      • Do NOT include the * that is in the SDK Event Name of the revenue events

  • Set the Sequence number for each event (starting with 1).

    • Sequence 1 should be Install, App Open, and FTUE

  • Set Pending Time (e.g., 0 for instant firing, or a number of days to hold the postback for verification).

  • Save

Example:

Singular SDK Event Name

GoKart Event ID

GoKart Event Name (user-facing)

Sequence

Install

Install

Install

1

level_10

level_10

Reach Level 10

2

__iap__*

__iap__

Purchase

Independent

Revenue & Reward

GoKart supports flexible monetization models (CPE & CPI).

In each event, you can configure whether to set a payout on the install and/or the in-app events.

Key Definitions

  • Revenue → what advertiser pays publisher

  • Reward → what end user receives

Part 6: Create & Share Offer

Once configuration is complete:

  1. Click Create Offer

  2. Offer is saved in GoKart (not yet distributed)

You can then:

  • Clone the offer

  • Customize the cloned offer per publisher (naming, payouts, links, etc.)

  • Share with specific publishers by clicking the share icon on the left

Each shared offer:

  • Is publisher-specific

  • Can have customized payouts and settings

  • Cannot be re-shared or unshared to other publishers

Related Articles
Singular Cost Reporting API (Developer Documentation)
GoKart x Appsflyer Integration
Partner Integration Intro
GoKart x Adjust Integration
Singular Cost Reporting for GoKart Advertisers
Did this answer your question?