Page Comparison

...

...

Generating the 'basket' Variable

...

Using a GTM Variable Template

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.

[{
          "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."

...

Working in GTM we recommend the strategy to work with a dedicated basket variable. There also is a template for this, to easily configure the basket:

1. Download the Variable Template:

• Download the appropriate basket variable template here. Save it as file with the ending .tpl

2. Import the Variable Template into GTM:

• Navigate to "Templates" from the left sidebar.

• Click on the "New" button in the variable template section, go to the three dots and then select "Import."
  

  Image Added

• Browse and select the downloaded variable template file.

• Follow the on-screen instructions to successfully import the template.

3. Create the 'basket' Variable Using the Imported Template:

• Once the template is imported, go to "Variables" from the left sidebar.

• Click on the "New" button to create a new variable.

• Name

...

• this variable "basket" or something descriptive

...

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:

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.

...

• .

• For the variable type, select the imported template from the list of available templates.
  

  Image Added

4. Mapping Data in the Variable:

To start, fill in the variable that contains your basket information in the fields your basket:

...

Now you can proceed and provide the name of the variables, that represent the needed basket values. Only mandatory ones need to be filled in. In case not variable is available, just leave it empty.

Within the variable configuration, you'll see fields that correspond to the product details (e.g., Product ID, Product Name, Price, etc.). Fill in the name of your variable.

Example:

...

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

Ensure that each field is correctly mapped to capture the desired product information.

5. Use the 'basket' Variable in the ECommerce Conversion Tracking Tag:

• Navigate to "Tags" from the left sidebar.

• Either create a new tag or edit an existing ECommerce Conversion Tracking Tag.

• In the tag configuration, look in the section eCommerce settings for the field to select the basket variable. This will ensure that the tag captures the product details from the basket variable during a purchase event.

• Save and test the tag to ensure it's capturing the product details correctly.

...

6. Publish Changes:

• Don't forget to submit your changes to make them live.

By following this method, you can efficiently generate the basket variable in GTM using the new variable template and ensure accurate capture of product details during purchase events.

Example for server side implementation (sGTM)

...