> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/extensions/cms-tracking/adpages-ecommerce-datalayer.md).
# AdPage's ecommerce dataLayer
What events and parameters are part of AdPage's trytagging-dataLayer?
### What is a dataLayer?
A dataLayer is a crucial part of your tracking strategy. It acts as a bridge (invisible to site visitors) between your website and the tracking tools you use. By placing the right information in your dataLayers, you ensure you can collect and analyze valuable data.
A properly configured dataLayer makes your tracking accurate and reliable. This means you can get better insight into user behavior and the effectiveness of your marketing campaigns. Here are a few reasons why dataLayers are essential:
* **Improved data quality:** make sure the right data is collected at the right moment.
* **Flexibility:** adjust your tracking without having to change your website's code.
* **Efficiency:** reduce the chance of errors in your tracking setup.
## Available events & parameters in the AdPage dataLayer
### Magento
#### trytagging\_user\_data
This event fires on every page with the following parameters:
* `page.title`
* `page.type`
* `store.code`
* `store.name`
* `store.website_id`
* `store.url`
* `new_customer`
* `marketing._ga`
* `marketing._ga_8XN45..`
* `marketing.user_id`
* `marketing.client_id`
* `marketing.session_id`
* `marketing.session_count`
* `marketing.fbp`
* `marketing.referrer`
* `marketing.user_agent`
* `device.screen_resolution`
* `device.viewport_size`
* `device.encoding`
* `device.language`
* `device.colors`
* `gtm.uniqueEventId`
#### trytagging\_view\_item\_list
This event fires with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
#### trytagging\_view\_item
This event fires with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_add\_to\_cart
This event fires with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_view\_cart
This event fires when the visitor views the cart, with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_remove\_from\_cart
This event fires when the visitor removes a product from the cart, with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_begin\_checkout
This event fires when the visitor starts checkout, with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.items.#.order_item_id`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_add\_payment\_info
This event fires when the visitor starts adding payment details, with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.items.#.order_item_id`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_add\_shipping\_info
This event fires when the visitor starts adding their shipping details, with the following parameters (event name: `trytagging_add_shipping_info`):
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.items.#.order_item_id`
* `ecommerce.value`
* `ecommerce.currency`
#### trytagging\_purchase
This event fires once payment has been completed, with the following parameters:
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.magento_sku`
* `ecommerce.items.#.magento_id`
* `ecommerce.items.#.item_list_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_category2`
* `ecommerce.items.#.item_category3`
* `ecommerce.items.#.item_category4`
* `ecommerce.items.#.item_category5`
* `ecommerce.items.#.index`
* `ecommerce.items.#.quantity`
* `ecommerce.items.#.price`
* `ecommerce.items.#.order_item_id`
* `ecommerce.tax`
* `ecommerce.coupon`
* `ecommerce.affiliation`
* `ecommerce.shipping`
* `ecommerce.transaction_id`
* `ecommerce.value`
* `ecommerce.currency`
***
### Lightspeed
#### trytagging\_user\_data
This event fires on every page with the following parameters:
* `page.title`
* `marketing._ga`
* `marketing._ga_8XN45..`
* `marketing.user_id`
* `marketing.client_id`
* `marketing.session_id`
* `marketing.session_count`
* `marketing._fbp`
* `marketing.user_agent`
* `device.screen_resolution`
* `device.viewport_size`
* `device.encoding`
* `device.language`
* `device.colors`
* `gtm.uniqueEventId`
#### trytagging\_view\_item\_list
This event fires when the user views a product list, with the following parameters:
* `ecommerce.item_list_id`
* `ecommerce.item_list_name`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_view\_item
This event fires as soon as the visitor views a product, with the following parameters:
* `ecommerce.currency`
* `ecommerce.items.#.category_2`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_add\_to\_cart
This event fires as soon as the visitor adds a product to the cart, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.category_2`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_view\_cart
This event fires when the visitor views the cart, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_begin\_checkout
This event fires when the visitor starts checkout, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_add\_shipping\_info
This event fires as soon as the visitor starts adding shipping info, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_add\_payment\_info
This event fires as soon as the visitor adds payment information, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_purchase
This event fires on the thank-you page after the visitor has paid, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
* `ecommerce.transaction_id`
* `ecommerce.shipping`
* `ecommerce.tax`
* `ecommerce.coupon`
* `ecommerce.affiliation`
***
### Shopify
#### trytagging\_user\_data
This event fires on all pages with the following parameters:
* `page.title`
* `marketing._ga`
* `marketing._ga_B4J3SF6P8V..`
* `marketing.user_id`
* `marketing.client_id`
* `marketing.session_id`
* `marketing.session_count`
* `marketing.fbp`
* `marketing.referrer`
* `marketing.user_agent`
* `device.screen_resolution`
* `device.viewport_size`
* `device.encoding`
* `device.language`
* `device.colors`
* `gtm.uniqueEventId`
#### trytagging\_view\_item\_list
This event fires when the visitor is viewing a list of products, with the following parameters:
* `ecommerce.item_list_id`
* `ecommerce.item_list_name`
* `ecommerce.items.#.handle`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.position`
* `ecommerce.items.#.price`
#### trytagging\_view\_item
This event fires when the visitor is viewing a product, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
#### trytagging\_add\_to\_cart
This event fires as soon as the visitor adds a product to the cart, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_view\_cart
This event fires as soon as the visitor views the cart, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_remove\_from\_cart
This event fires as soon as the visitor removes a product from the cart, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_begin\_checkout
This event fires when the visitor starts checking out, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_purchase
This event fires once the visitor has checked out and landed on the thank-you page, with the following parameters:
* `ecommerce.value`
* `ecommerce.currency`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_image`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_product_id`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_variant_id`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
* `ecommerce.tax`
* `ecommerce.shipping`
* `ecommerce.affiliation`
* `ecommerce.coupon`
* `ecommerce.transaction_id`
***
### WooCommerce
#### trytagging\_user\_data
This event fires on all pages with the following parameters:
* `marketing._ga`
* `marketing.user_id`
* `marketing.client_id`
* `marketing.session_id`
* `marketing.session_count`
* `marketing.fbp`
* `marketing.user_agent`
* `device.screen_resolution`
* `device.viewport_size`
* `device.encoding`
* `device.language`
* `device.colors`
* `gtm.uniqueEventId`
#### trytagging\_view\_item\_list
This event fires as soon as the visitor views multiple products, with the following parameters:
* `ecommerce.currency`
* `ecommerce.items.#.id`
* `ecommerce.items.#.index`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_list_name`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.price`
* `ecommerce.items.#.product_type`
* `ecommerce.items.#.sku`
* `ecommerce.items.#.stocklevel`
* `ecommerce.items.#.stockstatus`
#### trytagging\_view\_item
This event fires as soon as the visitor views a product, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.price`
#### trytagging\_add\_to\_cart
This event fires when the visitor adds a product to the cart, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.price`
#### trytagging\_view\_cart
This event fires as soon as the visitor views the cart, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.index`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_begin\_checkout
This event fires as soon as the visitor starts checkout, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.index`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
#### trytagging\_purchase
This event fires on the thank-you page after payment, with the following parameters:
* `ecommerce.currency`
* `ecommerce.value`
* `ecommerce.items.#.index`
* `ecommerce.items.#.item_brand`
* `ecommerce.items.#.item_category`
* `ecommerce.items.#.item_id`
* `ecommerce.items.#.item_name`
* `ecommerce.items.#.item_variant`
* `ecommerce.items.#.item_sku`
* `ecommerce.items.#.price`
* `ecommerce.items.#.quantity`
* `ecommerce.tax`
* `ecommerce.affiliation`
* `ecommerce.shipping`
* `ecommerce.transaction_id`
* `ecommerce.coupon`
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.adpage.io/extensions/cms-tracking/adpages-ecommerce-datalayer.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
