Extra Parameters for Events

You can add extra parameters to your events if you want to send (eCommerce) data to Tracklution when events are tracked on your website. For example; you want to send product information with "AddToCart" event. You can send send event parameters with an event to Tracklution by pushing them from your website to Google Tag Manager data layer. You can also do this with manual script installation without Google Tag Manager.

If you are using our WooCommerce plugin or Shopify app for Tracklution installation, Tracklution has automatically set up underlying eCommerce variables (such as product IDs and variations).

How to Track Extra Parameters

If you are using Google Tag Manager, the first step is to ensure the Data Layer variables are pushed to Google Tag Manager and available for you there. You should see them under "Variables". If you don't see anything; create the variables yourself, or ask someone from you development team to create them. You can send this to your website developers (remember to edit the name of the event and the variables):

"I want to send more data to Tracklution with AddToCart event. Could you please push a Data layer event to Google Tag Manager that would include product name, value, id and currency, so I can use those values as Data layer variables in Google Tag Manager."

Next, create or edit the tag you want to add the parameters to in Google Tag Manager. If you need to create a new tag first, follow these instructions. Add the event parameters to the event, below is an example of eCommerce data of AddToCart event (feel free to add or remove parameter-value pairs inside items). The parameters can be added or removed as long as there is comma after each row except the last one.

<script>
  tlq('track', 'AddToCart', {
      currency: "EUR",
      value: "34.99",
      items: [
        {
         item_id: 1235,
          item_name: "Product name",
         sku: "SW-C-005",
         price: "34.99",
          item_category: "Category Name",
           id: 1234,
          variant: "Variant Info"
       }, 
        {
         item_id: 1235,
          item_name: "Product name",
         sku: "SW-C-005",
         price: "34.99",
          item_category: "Category Name",
           id: 1234,
          variant: "Variant Info"
       }
    ]
});
</script>

When you want to add the Data Layer Variables in GTM, start typing

"{{"

and you should see a list of variables, like in the screenshot below:

Data Layer Variable

Standard eCommerce parameters

Ecommerce event parameters can be implemented to track user shopping habits, providing valuable data about product popularity. They also help analyze how promotions and product positioning contribute to overall revenue. If you are using our WooCommerce plugin or Shopify app for Tracklution installation, Tracklution has automatically set up underlying eCommerce variables (such as product IDs and variations). Below, you can find all standard eCommerce event parameters:

Item-Level Parameters (within the items array):

Parameter	Description
affiliation	A product affiliation to designate a supplying company or brick-and-mortar store location.
coupon	The coupon name/code associated with the item.
discount	The unit monetary discount value associated with the item.
index	The index/position of the item in a list.
item_brand	The brand of the item.
item_category	The category of the item.
item_category2	The second category hierarchy or additional taxonomy for the item.
item_id	The ID of the item.
item_list_id	The ID of the list in which the item was presented to the user.
item_list_name	The name of the list in which the item was presented to the user.
item_name	The name of the item.
item_variant	The item variant or unique code or description for additional item details/options.
location_id	The physical location associated with the item (e.g., the physical store location).
price	The monetary unit price of the item, in units of the specified currency parameter.
quantity	Item quantity.

Event-Level Parameters:

Parameter	Description
coupon	The coupon name/code associated with the event.
currency	The currency of the items associated with the event, in 3-letter ISO 4217 format.
payment_type	The chosen method of payment.
shipping_tier	The shipping tier (e.g., Ground, Air, Next-day) selected for delivery.
shipping	The shipping cost for the transaction.
tax	The total tax amount for the transaction.
transaction_id	The unique identifier for the transaction.
value	The monetary value of the event.

The standard eCommerce parameters are automatically mapped to Ad Platforms that support eCommerce fields.

Custom parameters

You can send any custom event, and pass any custom parameters with the event. This is configured the same way as in the "AddToCart" example above, just edit the event name and parameters according to your wishes. Note! In order to track the custom events and parameters, those need to be sent from your website to Google Tag Manager.

Custom parameters are sent as they are to Ad Platforms which support custom-parameters.

Monitoring Processed Events About Connectors