...
Fields | Description | Default |
|---|---|---|
Tracking Domain | The tracking domain can be a Third-Party Ingenious Tracking Domain, a First-Party Ingenious Tracking Domain or a GTM Serverside Domain. You can find it on the platform under "Partnerships -> Advertiser -> Settings". | proxy.ingenious.cloud |
Advertiser Id | You can find the advertiser ID on the platform under "Partnerships -> Advertiser -> Settings". Do not use the internal ID (mid). | |
Conversion Id | Unique conversion identifier from your system | gtmss_{currentTimestampMillis} |
Conversion Target | Defines an event and its type, for example Sale, Appinstall, Newslettersignup. | sale |
Tracking Currency | Determines the currency for all amounts. | |
Unique Id | The unique ID is used to identify conversions during the validation process. | |
Discount Value | This is the total net discount value. '0.00' is allowed. | |
Discount Code | This is the applied discount code. | |
Basket | The contents of the shopping cart consist of items containing the following values in JSON format | |
Session Id | A session Id. The data type is string. | |
Click Ids | A comma-separated list of click IDs. | uses _iclid Cookie |
Gdpr | Activates the general data protection regulation according to TCFv2.0 | |
Gdpr Consent | The actual tcfv2.0 string | |
Site Id | A short description of the conversion page. | |
Timestamp | Usage for cache invalidation. | Current Timestamp in Millis |
HTTP Location | The complete Browser-URL on which the tag was fired. | |
Customer Id | This specifies the internal customer ID from your system. | |
Customer New | This specifies a new or existing customer. Use value 'true' for new customer or 'false' for existing customer. | |
Pay Method | Customer payment method, for example 'credit card' or 'paypal'. | |
User Value 1 | These fields are for free additional information. All formats are accepted. | |
User Value 2 | These fields are for free additional information. All formats are accepted. |
Setting Up the 'basket' Variable in GTM
The ECommerce Conversion Tracking Tag is crucial for capturing details about a purchase. One of the essential components of this tag is the basket variable, which holds the product details of a purchase.
Here is the JSON object that needs to be transmitted in the basket variable.
| Code Block |
|---|
[{
"id":${POSITION_ID},
"pid":"${PRODUCT_ID}",
"sku":"${PRODUCT_SKU}",
"prn":"${PRODUCT_NAME}",
"brn":"${PRODUCT_BRAND}",
"prc":"${PRODUCT_HIERARCHY}",
"pri":${PRODUCT_PRICE},
"qty":${PRODUCT_QUANTITY},
"dsv":${PRODUCT_DISCOUNT},
"shp":${PRODUCT_SHIPPING},
"tax":${PRODUCT_TAX},
"trc":"${TRACKING_CATEGORY}"
}] |
More details and a description of each parameter can be found here: https://ingenioustechnologies.atlassian.net/wiki/spaces/KB/pages/1440809027/Configuring+and+implementing+tracking+tags#Basket-tracking
To transmit the product details correctly, you'll need to set up the basket variable with a specific JSON object format in GTM. Here's a step-by-step guide for non-technical users:
Navigate to Variables: On the left sidebar, click on "Variables."
Create a New Variable: Click on the "New" button to create a new variable.
Name the Variable: For clarity, name this variable "basket" or something descriptive like "Product Purchase Details."
Choose Variable Type:
Click on "Variable Configuration."
From the list of variable types, select "Custom JavaScript."
Enter the JavaScript Code: In the code area, paste the following:
| Code Block | ||
|---|---|---|
| ||
function() {
return [{
"id":{{POSITION_ID}},
"pid":"{{PRODUCT_ID}}",
"sku":"{{PRODUCT_SKU}}",
"prn":"{{PRODUCT_NAME}}",
"brn":"{{PRODUCT_BRAND}}",
"prc":"{{PRODUCT_HIERARCHY}}",
"pri":{{PRODUCT_PRICE}},
"qty":{{PRODUCT_QUANTITY}},
"dsv":{{PRODUCT_DISCOUNT}},
"shp":{{PRODUCT_SHIPPING}},
"tax":{{PRODUCT_TAX}},
"trc":"{{TRACKING_CATEGORY}}"
}];
} |
Set Up Associated Variables: For the script to work, you'll need to set up individual variables for each placeholder (e.g.,
{{PRODUCT_ID}},{{PRODUCT_SKU}}, etc.). These variables will capture the respective values from your website or e-commerce platform. You may have already set up the variables, it depends on your existing data layer.Save the Variable: Once you've entered the code, click on the "Save" button.
Integrate with the Tag: Now, when setting up or editing the ECommerce Conversion Tracking Tag, ensure you select the "basket" variable you just created for the appropriate field.
Publish Changes: Don't forget to submit your changes to make them live.
Example for server side implementation (sGTM)
...