Supported Parameters
When tracking conversion events on your website, you can pass additional details to Tracknow and display them in your dashboard.
This is done by sending each data point under its corresponding parameter within the postback request.
Parameters
Please make sure to send values using their correct (dedicated) parameters, as each one is tied to specific processing logic within the system.
For example, if your affiliate commission is based on a percentage, Tracknow will use the value sent under the amount parameter to calculate the commission accordingly.
Below are the parameters you can use to send details about various events.
You can use only the parameters you need or want to see in Tracknow. However, some parameters may still be mandatory depending on the type of integration.
| Parameter Key | Corresponding Column | Description |
|---|---|---|
| campaign_id | Campagin/Offer | The Tracknow campaign ID that this purchase should be associated with. It is required in certain types of integrations |
| click_id | Click ID | A unique parameter that links the client or purchase to the referring affiliate. It is required in certain types of integrations |
| order_id | Order ID | The internal order ID from your webstore that identifies the specific order or purchase |
| amount | Amount | The amount paid by the client, which the affiliate commission can be based on |
| commission | no column | If you want the affiliate’s commission to be based on a specific value rather than the purchase amount, use this parameter to send that custom value |
| currency | no column | If purchases are made in different currencies, include the currency code in 3-letter ISO format (e.g., USD, EUR). This allows our system to convert the amount to your campaign’s default currency |
| conversion_rate | no column | You can provide your own conversion rate if you prefer not to use the system’s default rate |
| coupon | Coupon code | The coupon code entered by the client during the purchase |
| goal | no column | A unique parameter used to trigger a specific payout, based on a pre-configured goal value. Click here to learn more |
| comment | Comment | Add any comments or notes related to this purchase or order |
| ref_id | Affiliate | If you want to attribute this purchase to a specific affiliate, include their Tracknow Affiliate ID in this parameter |
| ref_custom_id | Affiliate | If you use custom Affiliate IDs, you can identify the affiliate using their custom ID instead of their ref_id |
| first_name | First Name | Client's first name |
| last_name | Last Name | Client's last name |
| Client's email address | ||
| country | Country | Client's country (ISO 3166-1 alpha-2 code format i.e UK, US, JP) |
| address | Address | Client's address |
| postcode | Postcode | Client's postcode |
| phone | Phone number | Client's phone number |
| new_customer | no column | The value should be true or false, indicating whether the client is new. This helps establish a link between the client and the referring affiliate when using lifetime payouts |
| customer_id | no column | The value defined in your integration (such as a customer ID or email address) used to link the client to the referring affiliate when using lifetime payouts |
| skip_lifetime | no column | Send the value true if you want to create a lifetime link between the client and the affiliate, but prefer to pay the commission through a different payout instead of the lifetime payout |
| gaid | GAID | Google advertising ID |
| idfa | IDFA | A random device identifier assigned by Apple to a user’s iOS device |
| custom1 | custom1 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom2 | custom2 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom3 | custom3 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom4 | custom4 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom5 | custom5 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom6 | custom6 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom7 | custom7 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| custom8 | custom8 | A parameter for any text or values you want to pass that don’t have a dedicated parameter |
| sub1 | sub1 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub2 | sub2 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub3 | sub3 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub4 | sub4 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub5 | sub5 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub6 | sub6 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub7 | sub7 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| sub8 | sub8 | A parameter for any text or values you want to pass that don’t have a dedicated parameter. Affiliates can also use this parameter, but if you use it, your value will override theirs |
| itemId | | This parameter will hold the item ID/SKU (Mandatory for catalog-based payouts) |
| itemVariation | | This parameter will hold the item variation (Optional for catalog-based payouts) |
| itemName | | This parameter will hold the item name (Optional for catalog-based payouts) |
| itemQuantity | | This parameter will hold the quantity of purchased item (Optional for catalog-based payouts) |
| itemPrice | | This parameter will hold the item price (Optional for catalog-based payouts) |
Example
These parameters can be passed using different Integration Methods, with the most common being postbacks and tracking pixels.
What these methods have in common is that they both involve generating a URL, appending the relevant parameters to it, and then calling that URL to send the data to Tracknow.
Here's an example of a postback format that reports a purchase made by a client that was referred by an affiliate, the parameters we chose to pass in this example are the order ID, purchase amount, client's first name and email address
https://exmaple-tracking.tracknow.info/postback?click_id={value}&campaign_id={value}&order_id={value}&amount={value}&first_name={value}&email={value}
The actual purchase details should replace the {value} placeholders next to each parameter key. Once populated with real data, the final postback URL should look like this:
https://exmaple-tracking.tracknow.info/postback?click_id=a520dca8-ab08-4640-af65-034be3a68909&campaign_id=1&order_id=23315&amount=150&first_name=John&email=john.example%40gmail.com
Values that contain special characters, such as the '@' symbol in an email address, must be URL-encoded to ensure they are transmitted correctly within the URL