To set up a campaign with Adjust, there are 2 options.
Recommended: To set up a module integration. Instructions here.
Use Adjust’s partner encoding tool. Often used to start your Adjust campaign immediately without an integration
⚠️ Important Security Note
Adjust’s Partner Encoding Tool exposes the postback URL in the tracking link, making it vulnerable to postback manipulation.
Risk: Malicious actors could modify or inject false postbacks by manipulating the exposed callback structure.
Recommendation: To protect yourself, follow the steps below to ensure your callbacks are properly secured when using the partner encoding tool.
Instructions from Adjust to Secure your Postback- Adjust Partner Security Options
Email Adjust support at [email protected]
In your message:
Specify which parts of the Postback URL are static. Use the postback URL found in your Profile
Request a placeholder that maps to the static part of your URL.
Sample Email:
Subject: Request to Protect Callback URLs with Partner Encoding Tool
Hi Adjust Integrations,
I’m reaching out to request assistance with protecting our callback URLs using the partner encoding tool. Please confirm and provide the placeholder that maps to the static part of our Postback URLs.
Install Postback:
Full URL: https://api.TENANTNAME.getgokart.ai/api/v1/GKSECRET1/GKSECRET2/GKSECRET3/?signature=GKSIGNATURE&gk_click_id=CLICKID&cnv_event_id=EVENTID
Static Part: https://api.TENANTNAME.getgokart.ai/api/v1/GKSECRET1/GKSECRET2/GKSECRET3/?signature=GKSIGNATURE&gk_click_id=
In-App Event Postback:
Full URL: https://api.TENANTNAME.getgokart.ai/api/v1/GKSECRET1/GKSECRET2/GKSECRET3/?signature=GKSIGNATURE&gk_click_id=CLICKID&cnv_event_id=EVENTID
Static Part: https://api.TENANTNAME.getgokart.ai/api/v1/GKSECRET1/GKSECRET2/GKSECRET3/?signature=GKSIGNATURE&gk_click_id=Dynamic Placeholder: {gk_click_id}
Using the Encoding Tool
Add your advertiser's Adjust links.
Your advertiser will provide the Adjust tracking link. Ensure to apply the following:
Use the click URL, not the impression URL
Append the URL with the following parameters:
campaign={gk_advertiser_campaign_name}&ip_address={session_ip}&campaign_id={gk_offer_id}&click_id={gk_click_id}&cost_currency=USD&cost_id={gk_click_id}Example click URL:
https://app.adjust.com/1tuahmv9?campaign={gk_advertiser_campaign_name}&ip_address={session_ip}&campaign_id={gk_offer_id}&click_id={gk_click_id}&cost_currency=USD&cost_id={gk_click_id}
Add your callback URLs
Event Callbacks
Your advertiser will also provide the event tokens for the events you want to track. Each event token maps to a specific in-app event
Example Event Tokens:
Purchase:
q9bfk3Level 5 Complete:
x3df4z
Set each Token as the Event ID value in Gokart
Event callback URL: Add Your GoKart Postback URLs
If Adjust provided the Placeholder mapping to the GoKart static base URL, add that placement followed by
CLICKID&cnv_event_id={event}Example:
myNetworkPlaceholderCLICKID&cnv_event_id={event}
If you did not secure the postback URL from the instructions above, we do not recommend using the global postback in your Profile. Paste the postback URL that appears after saving the offer.
Install Callback
If Adjust provided the Placeholder mapping to the GoKart static base URL, add that placement followed by
GKCLICKID&cnv_event_id=EVENTIDExample:
myNetworkPlaceholderGKCLICKID&cnv_event_id=Install
If you did not secure the postback URL from the instructions above, we do not recommend using the global postback in your Profile. Paste the postback URLthat appears after saving your offer
Copy Your Final Adjust Link
Once you have added the Adjust link and GoKart postbacks, the tool will generate the final encoded Adjust links at the bottom for you to copy into the tracking URL in GoKart
Example:
https://app.adjust.com/1er0gaki?campaign={offer_name}&click_id={gk_click_id}&ip_address={session_ip}&campaign_id={offer_id}&install_callback=https%3A%2F%2Fapi.tenant.getgokart.ai%2Fapi%2Fv1%3Fcnv_event_id%3DInstall%26signature%3D%26gk_click_id%3DCLICKID
Edit the Final Adjust Link by replacing all instances of CLICKID with {gk_click_id}
Final URL:
https://app.adjust.com/1er0gaki?campaign={offer_name}&click_id={gk_click_id}&ip_address={session_ip}&campaign_id={offer_id}&install_callback=https%3A%2F%2Fapi.tenant.getgokart.ai%2Fapi%2Fv1%3Fcnv_event_id%3DInstall%26signature%3D%26gk_click_id%3D{gk_click_id}