This guide explains how to send a postback from an advertiser or website directly to Trackdesk. To record a conversion, you can use either a:
We've broken down exactly how to configure both options below.
1. Sending a GET Postback
A - Fixed Amount Offers
To send a GET postback for an offer with a fixed commission amount, use the following URL structure to create your conversion:
https://YOUR_TENANT_ID.trackdesk.com/tracking/conversion/v1?conversionTypeCode=SELECTED_CONVERSION_TYPE&cid=OUR_CID
⚠️ Make sure to replace these placeholders:
YOUR_TENANT_ID: Your actual Trackdesk Tenant ID.
SELECTED_CONVERSION_TYPE: The type of conversion you want to record, such as a "sale".
OUR_CID: The specific Trackdesk Click ID (CID).
B - Revenue Share Offers
If your offer uses a dynamic revenue share, you must provide the revenue amount in the postback so Trackdesk can correctly calculate the network and affiliate commissions.
https://YOUR_TENANT_ID.trackdesk.com/tracking/conversion/v1?conversionTypeCode=SELECTED_CONVERSION_TYPE&cid=OUR_CID&amount.value=AMOUNT_PLACEHOLDER
⚠️ Make sure to replace these placeholders:
YOUR_TENANT_ID: Your actual Trackdesk Tenant ID.
SELECTED_CONVERSION_TYPE: The type of conversion you want to record, such as a "sale".
OUR_CID: The specific Trackdesk Click ID (CID).
AMOUNT_PLACEHOLDER: The revenue amount you want to prorate to the system. Note: This parameter must be formatted as a string. For example, use
"100"for whole numbers or"100.50"for decimals.
C - Optional: Adding Extra GET Parameters
You can attach up to 9 extra parameters to your conversion to provide additional information.
💡 Tip: You can use the builder tool found in our API documentation to help easily generate your customized postback link
Adv S1–Adv S5: Use these 5 available parameters for any general information. Format it as:
customParams.advS1=VALUE
Customer ID: A general parameter for passing customer details. Format it as:
customerId=VALUE
External ID: This parameter is used for deduplication and must be completely unique on the platform. This is typically an Order ID or another internal transaction identifier. Format it as:
externalId=VALUE
Currency: Specifies the conversion currency, applicable only for revenue share cases. Format it as:
currency.code=VALUE
⚠️ ReplaceVALUEwith an ISO 4217 format currency code (e.g. USD, EUR or GBP)
Status: Dictates the initial status of the conversion. Format it as:
status=VALUE
Check the API documentation for supported options likeCONVERSION_STATUS_APPROVEDorCONVERSION_STATUS_PENDING.
2. Sending a POST Postback
A - Fixed Amount Offers
To send a POST request for a fixed amount offer, direct your payload to the tracking endpoint:
Endpoint:
https://YOUR_TENANT_ID.trackdesk.com/tracking/conversion/v1
Payload Example:
{
"conversionTypeCode": "SELECTED_CONVERSION_TYPE",
"cid": "OUR_CID"
}
⚠️ Make sure to replace these placeholders:
YOUR_TENANT_ID: Your actual Trackdesk Tenant ID.
SELECTED_CONVERSION_TYPE: The type of conversion you want to record, such as a "sale".
OUR_CID: The specific Trackdesk Click ID (CID).
B - Revenue Share Offers
For dynamic revenue shares, include the revenue value inside your payload so the system can calculate commissions properly.
Endpoint:
https://YOUR_TENANT_ID.trackdesk.com/tracking/conversion/v1
Payload Example:
{
"conversionTypeCode": "SELECTED_CONVERSION_TYPE",
"cid": "OUR_CID",
"amount": {
"value": "AMOUNT_PLACEHOLDER"
}
}
⚠️ Make sure to replace these placeholders:
YOUR_TENANT_ID: Your actual Trackdesk Tenant ID.
SELECTED_CONVERSION_TYPE: The type of conversion you want to record, such as a "sale".
OUR_CID: The specific Trackdesk Click ID (CID).
AMOUNT_PLACEHOLDER: The revenue amount you want to prorate to the system. Note: This parameter must be formatted as a string. For example, use
"100"for whole numbers or"100.50"for decimals.
C - Optional: Adding Extra POST Parameters
You can include the same 9 optional extra parameters in your POST payload.
💡 Tip: A payload builder tool is also available in the API documentation.
Here is how to format each extra parameter inside your JSON payload:
Adv S1–Adv S5: General parameters for any information. There are a total of 5 of these parameters. Use the following format to add them to the postback (example for Adv S1 shown):
"customParams": {
"advS1": "VALUE"
}
To use multiple Adv S parameters, use the following format:"customParams": {
"advS1": "VALUE",
"advS5": "VALUE"
}
Customer ID: General parameter for any information.
"customerId": "VALUE"
External ID: Parameter used for deduplication. This must be completely unique on the platform (typically an Order ID or other internal transaction identifier).
"externalId": "VALUE"
Currency: Specifies the currency for the conversion, applicable only for revenue share cases.
"currency": {
"code": "VALUE"
}
⚠️ ReplaceVALUEwith an ISO 4217 format currency code (e.g. USD, EUR or GBP)
Status: Parameter used to specify the conversion status that the conversion will be created with. Use the following format to add this parameter to the postback
"status": "VALUE"
Check the API documentation for supported options likeCONVERSION_STATUS_APPROVEDorCONVERSION_STATUS_PENDING.