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.

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
email	Email	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