...
If you look at panel below the configuration section, you will find that the conversion code already contains six parameters. These parameters are mandatory and should not be removed from the conversion code.
Name (JS code) | Name (img code) | Explanation | Format | Example | ||
|---|---|---|---|---|---|---|
|
| This parameter identifies the conversion target. The value of the parameter corresponds with the target you selected in the configuration panel. Attention: Uniqueness of conversions is determined by the combination of the | Alphanumeric | AddBasket | ||
|
| This parameter identifies the tracking category. The value of the parameter corresponds with the category you selected in the configuration panel. Tracking category
Attention: Uniqueness of conversions is determined by the combination of the | Alphanumeric | default | ||
|
| For security reasons, this parameter identifies the page on which the conversion is made. | Alphanumeric |
| ||
|
| This parameter identifies the the conversion and therefore should be unique. In case the ID contains sensitive information such as an email address, it can be replaced by an alternative ID on the platform. Attention: Uniqueness of conversions is determined by the combination of the | Alphanumeric |
| ||
|
| This parameter transmits the value of the conversion. If the conversion does not contain a value, the transmitted value should be Attention: Any other format than ##############.#### (Scale 20, Precision 4) is not allowed. | Numeric: Max-Value: |
| ||
|
| This parameter transmits the currency following ISO 4217. The currency should always correspond with the currency used on the advertiser's website. | Alphabetic |
| ||
|
| The complete Browser-URL on which the tag was fired. Used to prevent accuracy issues in case of strict referrer browser policy. Please don’t change the default value | URL | Result of |
Adding advanced parameters
...
The advanced parameters are sorted by purpose, let’s go through them one by one.
Name (JS code) | Name (img code) | Explanation | Format | Example |
|---|---|---|---|---|
|
| This parameter transmits any discount values related to the conversion. | Numeric: #.# |
|
|
| This parameter transmits any discount codes related to the conversion. | Alphanumeric |
|
|
| This parameter transmits the order value minus the value of the voucher that was applied to the order. It only needs to be implemented to allow distribution via third party tracking. | Numeric: #.# |
|
|
| This parameter transmits the total order value of a conversion, i.e. including shipping costs and VAT. | Numeric: #.# |
|
|
| This parameter transmits the status of the conversion. If it is not used, conversions will be registered with an open status. Therefore, you should only use this parameter when you want to confirm or cancel conversions automatically. | Numeric |
|
|
| This parameter is needed when you want to automate your validation process. For more information, please read this article. | Universally unique identifier (UU ID) |
|
Name (JS code) | Name (img code) | Explanation | Format | Example |
|---|---|---|---|---|
|
| This parameter registers whether the customer was new to the advertiser. Possible values are true (new) or false (recurring). | Alphabetic |
|
|
| This parameter transmits any ID given to the customer who placed the conversion. Use this for implementing cross-device tracking. | Alphanumeric |
|
|
| This parameter transmits a value identifying the gender of the customer placing the conversion. Possible values are f (female) and m (male). | Alphabetic |
|
|
| This parameter transmits the age of the customer placing the conversion. | Numeric |
|
|
| This parameter transmits questions and answers to surveys held upon placing the order. | Alphanumeric: {"#":"#"}. Please note JSON format is higly recommended. |
|
|
| This parameter can transmit the payment method the customer chose when placing the order.* | Alphanumeric |
|
|
| This parameter can transmit costumer related data, such as the number of orders previously canceled or recommendations. | Alphanumeric: {"#":"#"}. Please note JSON format is highly recommended. |
|
|
| This parameter can transmit additional information. It can be a string, a JSON or another format. | Alphanumeric |
|
|
| This parameter can transmit additional information. It can be a string, a JSON or another format. | Alphanumeric |
|
|
| This parameter can transmit additional information. It can be a string, a JSON or another format. | Alphanumeric |
|
|
| This parameter can transmit additional information. It can be a string, a JSON or another format. | Alphanumeric |
|
Custom values
The parameters in this section can transmit custom values related to the conversion or the customer, such as points given for a loyalty program. The content can be alphanumeric.
...
To enable basket tracking, please make sure you add the ‘basket’ parameter to the conversion code. Remember, the tracking category ‘basket’ should be set up. The only requirement for using this parameter is that your advertiser needs to be able to fill it with basket data in JSON format. The individual components of the basket data are discussed in the table below.
Name | Explanation | Format | Example |
|---|---|---|---|
| The optional ID of this position Can be submitted to address this position later. Generated automatically if empty | 1 or higher | 1 |
| The optional UUID of this position. Can be submitted to address this position later. Generated automatically if empty | Valid UUID | 0d5bb776-2d50-4d65-912c-d20e324f66b8 |
| The ID of the product to which the basket position relates. | Numeric |
|
| The name of the product to which the basket position relates. | Alphabetic |
|
| The price of the product to which the basket position relates. | Numeric: |
|
| The brand name of the product to which the basket position relates. | Alphanumeric |
|
| The number of ordered products. | Numeric |
|
| The tracking category of the basket position, not to be confused with the tracking category of the conversion to which the basket position belongs. Any tracking category may be used except Never use the trc | Alphanumeric |
|
| The shop category of the product to which the basket position relates. | Alphanumeric |
|
Name (JS code) | Name (img code) | Explanation | Format | Example |
|---|---|---|---|---|
|
| This parameter transmits the complete ad media code of the click URL via which the conversion was generated. | Numeric: #.#.# |
|
|
| This parameter replaces any sub IDs added to the click URL via which the conversion was generated. | Alphanumeric |
|
|
| This parameter can transmit the ID of a click and enable attribution even when no cookie was dropped. | Numeric |
|
(In JS code, use clickIds to transmit this value) |
| Awin click checksum. | String |
|
(In JS code, use clickIds to transmit this value) |
| Google Ads click ID. | String |
|
(In JS code, use clickIds to transmit this value) |
| Facebook Ads click ID. | String |
|
Configuring the on-page code
...
If you look at panel below the configuration section, you will find that the on-page code already contains five parameters, that you may work with. The parameter siteId is mandatory.
Name | Explanation | Format | Example |
|---|---|---|---|
| Mandatory: This parameter defines the placement of the code. It should be filled with the path of the page or the URL | Alphanumeric | |
| only on product pages: This parameter is the product ID, e.g. EAN or SKU | Alphanumeric |
|
| optional parameter, you are free to put in any additional information that may be needed | Alphanumeric | |
| optional parameter, you are free to put in any additional information that may be needed | Alphanumeric | |
| The complete Browser-URL on which the tag was fired. Used to prevent accuracy issues in case of strict referrer browser policy. Please don’t change the default value | URL | Result of |
Implementing the tracking codes
...
More information can be found in the main article about TCFv2.
Name (JS code) | Name (img code) | Explanation | Format | Example |
|---|---|---|---|---|
|
| not set : TCFv2.0 not implemented | Numeric: # (0 or 1) |
|
|
| Only meaningful if | Base64-encoded string |
|