Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
revenue metrics to be computed accurately.

items added to cart

products

items

An array with items included.

Standard product data is included here (e.g. name, id, category, quantity, brand, price)

pageType

One of the following:

  • Product List

  • Search Results

  • Product Details

-

Value determined by the page on which the product was added. 

In GA4, not used.

list page where product was added

list

item_list_name

See: List Names

*NOTE - Zoned Product Layout must be used in order for Enhanced eCommerce to work with lists.

GA4 Example

Code Block
languagejs
titleSample Add To Cart data
collapsetrue
gtag("event", "add_to_cart", {
  currency: "AUD",
  value: 20.00,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "CV Tee",
      currency: "AUD",
      index: 0,
      item_brand: "CV",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_name: "Related Products",
      price: 10.00,
      quantity: 2
    }
  ]
});

UA Example

Code Block
languagejs
titleSample Add To Cart data
collapsetrue
{
	"event": "addToCart",
	"ecommerce": {
		"currencyCode": "AUD",
		"add": {
			"items": [
			{
				"name": "Product Description",
				"id": "ProductCode",
				"category": "/first level/second level/third level",
				"quantity": 2,
				"brand": "brand name",
				"price": "10.00"
			}
			]
		}
	},
	"pageType": "Product List",
	"list": "Product List"
}
AnchorecomremovefromcartecomremovefromcartRemove from Cart

Remove From Cart data is pushed whenever a product is successfully removed from the user's cart.

NOTE - This can be a whole line deletion, or a decrease in quantity. Both actions are sent as 'Remove From Cart' data.

Property

UA

GA4

Notes

event

'removeFromCart'

remove_from_cart

value of order line (product x quantity)

value

currency code for the current account

currencyCode

currency

product(s) removed from cart

products

items

Standard product data is included here (e.g. name, id, category, quantity, price).

GA4 example

Code Block
languagejs
titleSample Remove From Cart data
collapsetrue
 gtag("event", "remove_from_cart", {
  currency: "AUD",
  value: 20.00,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "CV Tee",
      currency: "AUD",
      index: 0,
      item_brand: "CV",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_name: "Related Products",
      price: 10.00,
      quantity: 2
    }
  ]
});

UA example

Code Block
languagejs
titleSample Remove From Cart data
collapsetrue
 {
	"event": "removeFromCart",
	"ecommerce": {
		"currencyCode": "AUD",
		"remove": {
			"products": [
			{
				"name": "Product Description",
				"id": "Product Code",
				"category": "/first level/second level/third level",
				"quantity": 2,
				"price": "10.00"
			}
			]
		}
	}
}
AnchorecomcartupdateecomcartupdateCart Updated

Cart Updates will push Add or Remove event depending on product quantity changes:

  • Quantity increase triggers an "addToCart" data push

  • Quantity decrease triggers a "removeFromCart" data push

AnchorecompromoecompromoPromotion Codes check name

The following data is automatically pushed in relation to Promotion Code use: 

  • success adding a promo code ('validPromoCode')

  • failure adding a promo code ('invalidPromoCode')

  • removal of a promo code ('removedPromoCode')

The event type and the promotion code name is the only data sent in these instances.

Code Block
languagejs
titleSample Valid Promo Code data
collapsetrue
{
	"event": "validPromoCode",
	"promoCode": "XXXX"
}
Code Block
languagejs
titleSample Removed Promo Code data
collapsetrue
{
	"event": "removedPromoCode",
	"promoCode": "XXXX"
}
AnchorecomvieworderecomvieworderView Order

View Order data is pushed when an order is viewed on the Order History / tracking page. The relevant sales order number is sent in this instance.

Code Block
languagejs
titleSample View Order data
collapsetrue
{
	"virtualURL": "/TrackOrder/ViewOrder/Order Number"
}
AnchorecomviewtemplateecomviewtemplateView Template

View Template data is pushed when a saved template is viewed on the Order Templates page. The template name is sent in this instance.

Code Block
languagejs
titleSample View Template data
collapsetrue
{
	"virtualURL": "/OrderTemplates/Template Name"
}
AnchorextendextendExtend or Override Pushed Data

To push custom data or to override Commerce Vision's out-of-the-box inclusions, consult Commerce Vision. 

CV internal use:

Determine the type of custom data required to push:

  • User

  • Product

  • Order

    Include the new data by adding the field to the relevant JSON field group. 

    Data Type

    Dictionary Table

    JSON Field Group

    User

    Primary Table:

    • User

    Additional Tables:

    • Role

    • Customer

    SiteTrackerUserData (or SiteTrackerUserData_RoleNamefor role-specific changes)

    Product

    Product

    SiteTrackerProductData (or SiteTrackerProductData_RoleName for role-specific changes)

    Order

    Primary Table:

    • ProntoSalesOrder

    Additional Tables:

    • ProntoSalesOrderLine

    • Product

    SiteTrackerOrderData (or SiteTrackerOrderData_RoleName for role-specific changes)

    Finally, construct the tracking code per the format below.

  • First parameter is the data to manipulate (e.g. "userDetail" in sample code)

  • Second parameter is the type of manipulation:

    • extend

    • override

  • The third parameter is the function that will perform the manipulation (e.g. "EmailAddress: data.EmailAddress" in sample code)

    The data is the raw data that can be used for manipulation (and includes the additional data from the JSON field groups described above) 
    Code Block
    titleSample Data Extension code
    $.cv.css.tracker.track("userDetail", "extend", function(data) {
    	return { EmailAddress: data.EmailAddress };
    });

    Possible extension methods:

    • userDetail

    • pageType (this is for Digital Remarketing)

    • productImpressions

    • productClick

    • questionnaire

    • checkout

    • checkoutOption

    • transactionProducts

    • loginSuccess

    • logoutSuccess

    • addToCart

    • removeFromCart

    • promoCodes

    • viewOrder

    • viewTemplate

    Related help

    Overview

    Analytics collects usage and behaviour data from user interactions on your CV ecommerce store. This can be used with Google Tag Manager to produce enhanced ecommerce data and reports. These in turn can be used for Google Services such as Google Ads and other digital remarketing tools to deliver more relevant and personalised ads, and produce more insightful reports that detail traffic and engagement patterns on your website.

    From version 2022.3, GA4 is available for selection. It is pre-configured to push unified data for both Universal Analytics (v3) and GA4 (v4).  The latest version supports Analytics' latest capabilities for tracking and managing content through Google Services. In the CMS, you can select what optional data are collected to suit your marketing and reporting needs. Learn more: Google Analytics

    Which version in the CMS?

    • If your site has never implemented Analytics, choose the GA4 version.
    • If your site is using UA (v3), you can choose UA or GA4. Selecting GA4 will still mean your UA implementation also receives data.  
    • If you choose UA, you want to start thinking of migrating to GA4 as UA will be deprecated by Google on the 1st July 2023. Remember, by selecting GA4, you can start to implement GA4 while continuing to use UA. 

    Migration Plan 

    • The GA4 solution has adopted Google's dual tagging, so both UA and GA4 requirements can be handled at the same time.
    • In your Google account, leave your UA implementation unchanged. You can populate GA4 events as well a UA ones. These will operate independently side by side, doing slightly different things. 
    • Continue to use UA until you are comfortable that your GA4 data has built enough of a historical record to be useful (or until UA is deprecated by Google on the 1st July 2023). This time should also be used to understand UA → GA4 changes. 

    The CV Platform and GA4

    Info
    titleImplementing GA4
  • Code snippets for some events and in the default template used should have parameter name and data structure changes to reflect GA4 conventions.   

  • GA4 Google Tag Manager snippet must be added. Running both UA and GA4 concurrently? This tag will also tell Google to automatically convert GA4 properties to UA and vice versa. 

    Warning
    titleIMPORTANT

    While the gtag.js can automatically translate GA4/UA properties, not all events and parameters can be translated so it's important you review the behavior, incompatibilities and trade-offs you may have to make when relying on automatic translation.

    Learn more: Event Compatibility Reference

       

    Prerequisites 

    1. Set up Google account and get ID and Google Tag Manager snippet

    NOTE - This guide only documents the steps that are required to obtain credentials and the Google Tag Manager code snippet. Learn more at Google: Set up GA4  

    If you do not have an account, go to analytics.google.com and create an account.
    Set up a new product or app. 
    Image Removed
    Follow the instructions to create a new GA4 data stream. TIP - Copy the Measurement ID as you will need to add it into a CV resource later.
    Image Removed
  • To retrieve the generated tag js script for your account, click View Tag Instructions
    Image Removed
  • To view the tag, click 'Install manually'.
    Image Removed

    Copy the tag. It will have your Measurement ID added to it.

    Info
    titleGoogle Tag Manager

    Here is an example with the Measurement ID in yellow:

    Image Removed

    In the CMS, go to ContentAdvanced Content Resources.
  • Use the Search tool to find: rcGoogleTagManagerInitialiserHead
    Image Removed
  • Click Modify.

    In Resource Value, add the Google Tag Manager snippet you copied. It will look like this except the {0} placeholders will have your data stream's Measurement ID.

    Code Block
    titleThis tag will output the 'snippet' required by the Google Tag manager.
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id={0}"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', '{0}');
    </script>
    Example of snippet in Resource Value:
    Image Removed
  • Click Save.
  • 2. Check templates/widgets are set up for capturing the Product Click event

    To capture products clicked by users for GA4, in the CMS, make sure the following are in place:

    •  Product List Grid widget: zoned layouts are enabled for Products and Categories.
      (Pages & Templates → ProductsProduct List Grid widget)
      Image Removed
    •  Items Recently Viewed widget is added to Home Page
      (Pages & Templates → Home PageI
      tems Recently Viewed widget)
    •  CrossSell/Upsell widgets: are added to Product Detail
      (Pages & Templates → Products → Product Detail page → CrossSell/Upsell widget)
    •  Campaign Slider: is added to Home Page
      (Pages & Templates → Home PageCampaign Slider widget)

    3. Enable Favourites for Prior Purchases:

    For each role your customers use and you want tracked:

  • Go to EcommerceUsersRoles.
    Image Removed
  • Select the Role, then click the Functions tab.
  • Find and tick Enable Customer Favourites.
    Image Removed
  • Click OK
  • Repeat steps 1-4 for all roles needed.
  • Configure GA4 Analytics 

    1. Select GA4 version

    In the CMS, go to: SettingsSettingsSystemsAnalytics.
    With Analytics enabled on your site, click Configure.
    In Analytics Feature Settings, toggle ON Enable Analytics.
    In Analytics Version, select which version you are configuring: 'UA' or 'GA4'. NOTE - We recommend you select GA4 whether your site is new to Analytics or on a migration plan.       
    In Google Tag Manager ID, enter the ID from your Google Tag Manager account. 
    Example: 
    Image Removed
    When an ID is entered, Analytics functions available are listed. Tick at least Digital Remarketing or Enhanced eCommerce.
    Image Removed
    - Digital Remarketing -  use Analytics with remarketing tools such as Google Ads or dynamic remarketing. Visitor and purchaser behaviour events from Analytics can be included to personalise ads shown to users after they leave your site and continue to browse the internet.
    - Enhanced Ecommerce - collect richer details about user behaviours on your site that goes beyond transactional info. This data can be used with Google Tag Manager to produce reports on patterns of user activity, e.g., how users interact with specific products, where they go to on your site and where they go next, when they abandon their carts and leave your site.  
    - Enhanced Rich Snippet - add a snippet to enhance search results visually.
  • Click Save.  
  • 2. Set templates (optional)

    This step is needed only if you do not want to use the default global template use.

    You can select to include all users or a subgroup based on Role by setting relevant templates:

    • Set global - one template for all users
    • Set role-based - template for users in a specific role.
    Info

    The system will first check for a role-based template. If one is not found against the role, the global template will be used. The default template is called CV_OpeningBodyTemplate. You can find from the Content menu.
    Image Removed

    Set Global

    To set the global template, go to the default templates admin page. Set the Opening Body Template to the default template or another template you created.

    Role-based

    To use the tag manager for users in specific roles, go to the role management admin page (see Templates tab). Set the Opening Body Template to the default template or another template you created.

    Anchorremarketingremarketing

    Digital Remarketing

    Tip

    The 'Data Layer Doctor' extension for Chrome may be useful in viewing data objects during testing. It allows you to check the contents of a data layer and verify it against your specifications.

    Remarketing uses Analytics with Google's digital marketing and remarketing solutions, e.g., Google Ads etc by personalising ads shown to past visitors of your website who are still on Google or partner websites. What ads are shown to a user is based on their past behaviour matching a behavioral profile. When there is a match, the user is added to that user segment. Segment rules set up personalise what kind of ads are displayed. For example, you might create a segment of 'website visitors' - users who leave your site without making a purchase. You could have rules that show them ads of products they clicked on or added to cart, when they continue to browse and search the internet. Remarketing in a targeted way like this may help bring them back to your site and make a purchase.

    See: Remarketing with Google Analytics 

    Remarketing data from every page of the website are pushed to Google. What data (property + its value) is sent with each page type are listed. 

    Property

    Value

    Notes

    event

    'remarketing'

    ecomm_pagetype

    • other
    • home

    • category

    • product

    • cart

    • purchase

    Value determined by the page the user is on. For example:

    • 'other' = any other page not specifically listed (eg. Favourites, Checkout Delivery Address, Dashboard, etc).
    • 'home' = the site's home page

    • 'category' = a category page listing products

    • 'product' = the product detail page

    • 'cart' = the shopping cart

    • 'purchase' = the confirmation screen once an order has successfully been submitted

    ecomm_prodid

    One of the following:

    • Product code (product pages)

    • Array of product codes (category, cart, purchase pages)

    Optional. Value determined by the page the user is on, and does not apply to page types 'home' or 'other'.

    ecomm_totalvalue

    The total value of all products and charges (if any)

    Optional. Only applies to page types 'product', 'cart, and 'purchase'.

    google_conversion_value

    The total value of all products and charges

    Optional. Only applies to page type 'purchase'.

    check

    Code Block
    languagejs
    titleSample Remarketing data
    {
        "event": "remarketing",
    	"ecomm_pagetype": "home",
    	"ecomm_prodid": ["ProductCode", "ProductCode"] or "ProductCode",
    	"ecomm_totalvalue": "99.99",
    	"google_conversion_value": "99.99"
    }
    Anchorecommerceecommerce

    Enhanced Ecommerce

    Enhanced Ecommerce is extra functionality you can add to Google Analytics. Used with Tag Manager, it allows the gathering of richer data about buyers and visitors on your website. Instead of just the standard ecommerce transactional information at the Order Confirmation step, activities such as when they add items to cart, when they remove items, when they abandon their carts and leave without purchasing, where they begin checkout, etc, are also collected. This data can be used to produce reports that analyse shopper behaviour patterns on your site. 

    Enhanced ecommerce data is pushed for nearly every event type on the website. The general event name is ecommerce. How CV data fields match Analytics parameters and values are outlined below. 

    AnchorecomimpressionsecomimpressionsProduct Impressions (Products in List Viewed)

    Product Impression data is pushed whenever a list of product results is displayed, e.g., products in search results, a category list, the user's favourites. 

    In GA4, this is the view_item_list event. Data sent includes the items array parameter containing the displayed items. 

    View List Parameters

    UA

    GA4

    Notes

    Event Typeimpressions-Not used in GA4Event TypeecommerceecommerceEvent Nameview_item_listWhen infinite scrolling is ON: some pages may load additional data after the initial page load. For this reason, impressions are pushed via an event. Infinite scrolling creates a new event, and therefore a new data push. This also pushes the data in blocks to ensure Google's object data limit is not reached.

    Item list type

    list

    item_list_name

    See: List Names

    products in the list

    products

    items

    Array with each included item.

    Required: yes

    Products / Items Parameters

    UA Value

    GA Value

    Notes

    See: Products/Items event parameters and values for data sent on each item

    Product/item event parameters and values

    In GA4, product data are now in 'items'.

    Event = items

    Parameter

    UA

    GA4

    Notes

    product description

    name 

    item_name

    One of item_id or item_name is required.

    product code

    id

    item_id

    One of item_id or item_name is required.

    product category

    category

    item_category

    GA4: item_category = top level category. Specify up to 5 categories:

    item_category: "Apparel",
    item_category2
    : "Adult",
    item_category3
    : "Shirts",
    item_category4
    : "Crew",
    item_category5
    : "Short sleeve

    UA: when setting the items[].category parameter, you use / as a delimiter to specify up to five levels of hierarchy.

    Info
    titleGA4 changes

    GA4 uses enumerated category parameters. Up to five levels can be specified.

    Category translation between UA ↔ GA4:

    • GA4 → UA: enumerated categories will be combined into a single category parameter, with each category delimited by /.
    • UA → GA4: the value of the category parameter will be split to populate the corresponding GA4 enumerated categories.

    NOTE - If you intend to send GA4 events to UA, it's recommended that you do not use the / character in category values, since this will be interpreted as a category delimiter when translating to UA.

    • Only the first 5 category levels

    list name

    list *

    item_list_name

    Value determined by the list in which the product is located.

    See: List Names

    *NOTE - Zoned Product Layout must be in use for Enhanced Ecommerce to work with lists.

    product's brand

    brand

    item_brand

    product's position / sequence in the list

    position

    index

    Monetary nett price of the item, in units of the specified currency parameterprice

    price

    price

    If 'hide pricing' is enabled at Role level, this data is not pushed.

    item level currency

    currencyCode

    currency

    In 3-letter ISO 4217 format.

    Multiple currencies per event is not supported. Each item should set the same currency.

    GA4 - currency can be set at both item and event levels. If set at item level, event-level currency is ignored.

    Item level structure: ecommerce.items.currency

    Anchorlist_typelist_typeList Types

    Lists are used for product impressions, product clicks and add to cart tracking. The value of item_list_name is the list type viewed by the user.  

    Item List Type

    List Type Values

    Product Detail

    Product Details

    Product Category

    Product List

    Search Results

    Search Results

    Recently Viewed

    Items Recently Viewed

    Campaign

    Campaign - (sent as the Campaign Description, not the Campaign Code)

    Alternate products

    CrossSell

    Accessories / Related products

    Upsell

    User Favourites

    User Favourites

    Prior Purchases

    Prior Purchases

    Product Details

    Product Details

    Products Viewed in a List GA4 example:

    Code Block
    languagejs
    titleSample Product Impression data
    collapsetrue
    gtag("event", "view_item_list", {
      item_list_name: "Related products",
      items: [
        {
          item_id: "SKU_12345",
          item_name: "Stan and Friends Tee",
          currency: "AUD",
          index: 1,
          item_brand: "CV",
          item_category: "Apparel",
          item_category2: "Adult",
          item_category3: "Shirts",
          item_category4: "Crew",
          item_category5: "Short sleeve",
          item_list_name: "Related Products",
          price: 9.99,
          }
      ]
    });   ]
    	}
    }

    UA example:

    Impressions Data
    Code Block
    languagejs
    titleSample Product Impression data
    collapsetrue
    {
    	"event": "enhancedEcomm",
    	"event_type": "impression",
    	"ecommerce": {
    		"currencyCode": "AUD",
    		"impressions": [
    		{
    			"name": "Product Description",
    			"id": "ProductCode",
    			"list": "list name",
    			"category": "/first level/second level/third level",
    			"brand": "brand name",
    			"position": 1,
    			"price": "99.99"
    		}
    		]
    	}
    }

    Product Detail Impression Data:

    Code Block
    languagejs
    titleSample Product Detail Impression data
    collapsetrue
    {
    	"event": "enhancedEcomm",
    	"event_type": "impression",
    	"ecommerce": {
    		"currencyCode": "AUD",
    		"detail": {
    			"actionField": {
    				"list": "list name"
    			},
    			"products": [
    			{
    				"name": "Product Description",
    				"id": "ProductCode",
    				"category": "/first level/second level/third level",
    				"brand": "brand name",
    				"price": "99.99"
    			}
    			]
    		}
    	}
    }
    AnchorecomclicksecomclicksProduct Clicks

    Product Click data is pushed on any click of a product link, e.g., a product on a page of search results or on the user's favourites list.

    In GA4, the event is called select_item.

    Parameters

    UA

    GA4

    Notes

    event

    productClick

    select_item

    event

    click

    -

    Event 'click' is not used in GA4. 

    event type

    click.actionField

    -

    Event type 'click.actionField' is not needed in GA4. 

    List type product was located on when selected

    list *

    item_list_name

    Where product was clicked. See: List Names

    Event structure:

    • GA4 - ecommerce.items.item_list_name
    • UA - ecommerce.click.actionField.list

    * NOTE - Zoned Product Layout must be in use for Enhanced Ecommerce to work with lists.

    products/items

    products

    items

    * The items array is expected to have a single element, representing the selected item. If multiple elements are provided, only the first element in items will be used.

    Item Parameters

    UA

    GA4

    product description

    name

    ecommerce.click.products.name

    item_name

    ecommerce.items.item_name

    Product code

    id

    ecommerce.click.products.id

    item_id

    ecommerce.items.item_id

    product category

    category -  primary category

    ecommerce.click.products.category

    'item_category' - top level category

    ecommerce.items.item_category

    Specify up to 5 levels:

    E.g.,

    item_category: "Apparel",
    item_category2
    : "Adult",
    item_category3
    : "Shirts",
    item_category4
    : "Crew",
    item_category5
    : "Short sleeve

    All levels of the category structure can be shown. 'category' by itself = product's primary category.

    In UA, when setting the items[].category parameter, you use / as a delimiter to specify up to five levels of hierarchy.

    Info
    titleGA4 changes

    GA4 uses enumerated category parameters. Up to five levels can be specified.

    Category translation between UA ↔ GA4:

    • GA4 → UA: enumerated categories will be combined into a single category parameter, with each category delimited by /.
    • UA → GA4: the value of the category parameter will be split to populate the corresponding GA4 enumerated categories.

    NOTE - If you intend to send GA4 events to UA, it's recommended that you do not use the / character in category values, since this will be interpreted as a category delimiter when translating to UA.

    • Only the first 5 category levels will be used, regardless of how many are defined.

    product's brand

    brand

    item_brand

    Event structure:

    GA4 - ecommerce.items.brand

    UA - ecommerce.click.products.brand

    Product's position / sequence in its list

    position

    ecommerce.click.products.position

    index

    ecommerce.items.index

    Product price

    (nett price for 1)

    price

    ecommerce.click.products.price

    price

    ecommerce.items.price

    If 'hide pricing' is enabled at Role level, this data is not pushed.

    Currency

    -

    currency

    In 3-letter ISO 4217 format.

    Multiple currencies per event is not supported. Each item should set the same currency.

    GA4 - currency can be set at both item and event levels. If set at item level, event-level currency is ignored.

    Item level structure: ecommerce.items.currency

    Total amount

    -

    value

    Sum of product price x quantity

    Structure: ecommerce.value

    Product Click/Select Item - GA4 example:

    Code Block
    languagejs
    titleSample Product Click data
    collapsetrue
    gtag("event", "select_item", {
      item_list_name: "Related products",
      items: [
        {
          item_id: "SKU_12345",
          item_name: "CV Tee",
          currency: "AUD",
          index: 0,
          item_brand: "CV",
          item_category: "Apparel",
          item_category2: "Adult",
          item_category3: "Shirts",
          item_category4: "Crew",
          item_category5: "Short sleeve",
          item_list_name: "Related Products",
          price: 10.00,
          quantity: 1
        }
      ]
    });

    UA example: 

    Code Block
    languagejs
    titleSample Product Click data
    collapsetrue
    {
    	"event": "productClick",
    	"ecommerce": {
    		"click": {
    			"actionField": {
    				"list": "list name"
    			},
    			"products": [
    			{
    				"name": "Product Description",
    				"id": "ProductCode",
    				"category": "/first level/second level/third level",
    				"brand": "brand name",
    				"price": "99.99",
    				"position": 1
    			}
    			]
    		}
    	}
    }
    AnchorecomuserecomuserUser Details

    User Detail data is pushed on every page of the site.  There is the option to push data for logged in users only.

    • 'User_ID' = the user's unique identifier (database field = user.userid ) 

    Code Block
    languagejs
    titleSample User Detail data
    collapsetrue
    {
    	"User_ID": "unique user id"
    }
    AnchorecomquestionecomquestionQuestionnaire

    Questionnaire data is only pushed for non-widget-based questionnaires.

    Since the URL does not change post submission, a virtual URL is pushed. (In contrast, widget-based questionnaires have a URL redirect post submission.)

    Code Block
    languagejs
    titleSample Questionnaire data
    collapsetrue
    {
    	"virtualURL": "thank you URL"
    }
    AnchorecomcheckoutecomcheckoutCheckout Steps & Options

    Steps - pushed as the user progresses through the various steps of the checkout process.

    Checkout Event

    UA

    GA4

    Notes

    event 

    'checkout'

    begin_checkout

    event type

    'checkout'

    Not used in GA4.

    Event structure

    "ecommerce":

    { "checkout":

    { "actionField":

    { "step": 1

    Not required in GA4.

    In UA:

    The checkout step numbers are:

    • 1 - going to cart

    • 2 - attempting checkout, but login required

    • 3 - selecting delivery option

    • 4 - selecting payment option

    • 5 - submitting the order

    • Steps 3 & 4 will trigger additional 'Product Option' data to be pushed, in the form of the option selected at this step.
      • For example, the freight option selected at Step 3 or the payment method selected at Step 4 (sample provided below).

    products in the cart

    products

    items

    Includes products in the cart.

    • Standard product data will be pushed for each product in the cart (e.g. name, id, category, brand, price).

    GA example:

    Code Block
    languagejs
    titleSample Checkout Steps data
    collapsetrue
    gtag("event", "begin_checkout", {
      currency: "AUD",
      value: 20.00,
      items: [
        {
          item_id: "SKU_12345",
          item_name: "CV Tee",
          currency: "AUD",
          index: 0,
          item_brand: "CV",
          item_category: "Apparel",
          item_category2: "Adult",
          item_category3: "Shirts",
          item_category4: "Crew",
          item_category5: "Short sleeve",
          item_list_name: "Related Products",
          price: 10.00,
          quantity: 2
        }
      ]
    });

    UA example:

    Code Block
    languagejs
    titleSample Checkout Steps data
    collapsetrue
    {
    	"event": "checkout",
    	"event_type": "checkout",
    	"ecommerce": {
    		"checkout": {
    			"actionField": {
    				"step": 1
    			},
    			"products": [
    			{
    				"name": "Product Description",
    				"id": "ProductCode",
    				"category": "/first level/second level/third level",
    				"brand": "brand name",
    				"price": "10.00"
    			}
    			]
    		}
    	}
    }

    check for GA4

    Options - pushed whenever the Checkout Step value (detailed above) is either 3 or 4. 

    Parameter Options

    UA

    GA4

    Notes

    event

    'checkoutOption'

    event_type

    'checkout'

    step

    3 or 4

    Value determined by the step number in 'Checkout Steps' data above.

    option

    The option selected at this step

    For example - 'pickup' at Step 3 or 'BPAY' at Step 4.

    UA example:

    Code Block
    languagejs
    titleSample Checkout Option data
    collapsetrue
    {
    	"event": "checkoutOption",
    	"event_type": "checkout",
    	"ecommerce": {
    		"checkout_option": {
    			"actionField": {
    				"step": 4,
    				"option": "BPAY"
    			}
    		}
    	}
    }
    AnchorecomtransecomtransTransactions / Purchase

    When an order is submitted, Transaction and Product/Items data are pushed. 

    The purchase event consists of the transaction (payment) and the items purchased. 

    Property

    UA

    GA4

    Notes

    event name

    purchase

    purchase

     sales order number

    id

    transaction_id

    order value

    revenue

    value

    total value of order

    tax amount

    tax

    tax

    shipping amount

    shipping

    shipping

    Property

    UA

    GA4

    Notes

    event name

    purchase

    purchase

    product description 

    name

    item_name

    Repeated for each product in the transaction.

    product code

    id

    item_id

    Repeated for each product in the transaction.

    product's primary category

    category

    item_category

    Includes all levels of the category structure for the product's primary category.

    Repeated for each product in the transaction.

    product price (nett for 1)

    price

    price

    Repeated for each product in the transaction.

    GA4 example:

    Code Block
    languagejs
    titleSample Transaction data
    collapsetrue
    gtag("event", "purchase", {
        transaction_id: "100000000",
        value: 25.99,
        tax: 4.90,
        shipping: 5.99,
        currency: "AUD",
        items: [
         {
          item_id: "SKU_12345",
          item_name: "CV Tee",
          currency: "AUD",
          index: 0,
          item_brand: "CV",
          item_category: "Apparel",
          item_category2: "Adult",
          item_category3: "Shirts",
          item_category4: "Crew",
          item_category5: "Short sleeve",
          item_list_name: "Related Products",
          price: 10.00,
          quantity: 1
        },
        {
          item_id: "SKU_12346",
          item_name: "CV Grey Women's Tee",
          currency: "AUD",
          index: 1,
          item_brand: "CV",
          item_category: "Apparel",
          item_category2: "Adult",
          item_category3: "Shirts",
          item_category4: "Crew",
          item_category5: "Short sleeve",
          item_list_name: "Related Products",
          price: 10.00,
          quantity: 1
        }]
    });

    UA example:

    Code Block
    languagejs
    titleSample Transaction data
    collapsetrue
    {
    	"event": "payment",
    		"ecommerce": {
    		"purchase": {
    			"actionField": {
    				"id": 100000000,
    				"revenue": 25.99,
    				"tax": 4.90,
    				"shipping": 5.99
    			}
    		},
    		"products": [
    		{
    			"name": "CV tee",
    			"id": "SKU_12345",
    			"category": "/first level/second level/third level",
    			"price": "10.00"
    		}
    	
    		{
    			"name": "CV Grey Women's Tee",
    			"id": "SKU_12346",
    			"category": "/first level/second level/third level",
    			"price": "10.00"
    		}
    		]  
    }
    AnchorecomloginecomloginLogin Success   check

    Login Success data is pushed on any successful user login. 

    • The 'event' always = "login"

    • The 'widgetName'/'method' = name of the widget used to initiate the login 

    GA4 example:

    Code Block
    languagejs
    titleSample Login Success data
    collapsetrue
    gtag("event", "login", {
      method: "widget-name"
    });

    UA example:

    Code Block
    languagejs
    titleSample Login Success data
    collapsetrue
    {
    	"event": "login",
    	"widgetName": "widget-name"
    }
    AnchorecomlogoutecomlogoutLogout Success

    Logout Success data is pushed on any successful user logout.  

    • The 'event' always = "logout"

    • The 'widgetName' = that of the widget used to initiate the logout 

    Code Block
    languagejs
    titleSample Logout Success data
    collapsetrue
    {
    	"event": "logout",
    	"widgetName": "widget-name"
    }
    AnchorecomaddtocartecomaddtocartAdd to Cart

    Add To Cart data is pushed every time a user successfully adds a product to their cart. 

    Event

    UA

    GA4

    Notes

    event name

    'addToCart'

    add_to_cart

    Parameters

    monetary value of the event

    value

    value

    * value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value.
    * currency is required if you set value.

    currency of event

    currencyCode

    currency

    Currency code of the current event, in 3-letter ISO 4217 format.
    If set, item-level currency is ignored. If not set, currency from the first item in items is used.
    * If you set value then currency is required for

    This reference doc


    Excerpt
    hiddentrue

    Events guide for Google Analytics 4 (GA4)


    GA4 and Tag Manager

    Info
    titleChanges in GA4

    Some Ecommerce event and scope structures and parameter names have changed for GA4.  

    Warning
    titleIMPORTANT

    Note that not all events in UA and GA4 are translatable. It is important that you review and understand the differences and incompatibilities.

    Learn more: Event Compatibility Reference

    Learn more: Google Tag Manager Setup for GA4


    Every time a tracked interaction occurs on your site, certain types of data relevant to ecommerce are sent. The current out-of-the-box implementation includes data from these events: 

    • search (Version 4.40+)
    • add_to_cart
    • remove_from_cart
    • view_cart (Version 4.40+)
    • view_item
    • view_item_list
    • add_to_wishlist (Version 4.40+)
    • begin_checkout
    • add_shipping_info (Version 4.40+)
    • add_payment_info (Version 4.40+)
    • purchase


    Info
    titleAnalytics Options in CMS

    When the version GA4 is enabled in the CMS, GA4 data from these events is automatically sent. Important - 'Enhanced Ecommerce' option is required always for GA4, but you do not have to configure and add further code for it to work. The 'Remarketing' option only applies to UA.




    Panel

    On this page:

    Table of Contents
    indent18px


    Before You Begin 

    1. CMS Analytics feature enabled in CMS

    If Analytics is not enabled, contact Commerce Vision.

    2. Templates/Widgets Setup

    To track product clicks (select_item event in GA4) for certain List Types check that templates where users can select a product has these setups:

    •  

      Product List Grid widget: zoned layouts are enabled for Products and Categories. Affects List Type: Product List 

      (Go to Pages & Templates → Products and check the Product List Grid widget is using a zoned layout.)

      Image Added

    •  

      List Type: Items Recently Viewed works with the Recently Viewed widget added on a page or template

    •  

      List Types: Cross Sell, Upsell works with the CrossSell/Upsell widget added on a page or template, e.g., Product Detail page. 

    •  

      List Type: Campaign works with the Campaign Slider widget added on a page or template.


    Set CMS Analytics to GA4 

    1. Select GA4 version

    1. In the CMS, go to: SettingsFeature ManagementSystem → Analytics.

    2. With Analytics enabled on your site, click Configure.

    3. In Analytics Feature Settings, toggle ON Enable Analytics.

    4. In Analytics Version, select 'GA4'. TIP - GA4 should be selected if you are implementing Tag Manager for the first time.

    5. In Google Tag Manager ID, enter the Tag Manager ID. 

    6. When the ID was entered in step 5, three options appear. 
      Image Added
      1. Digital Remarketing -  does not apply to GA4
      2. Enhanced Rich Snippet - this allows you to add a code snippet that enhances search results visually, e.g., include ratings when a product's page is listed. See: Enhanced Rich Snippets

    7. Tick Enhanced Ecommerce so it's on

    8. Click Save.  

    Event and Parameter Reference Guide

    This section details the data sent for each event.


    Info
    titleHow we structured the event properties

    All data pushed has been matched to the structure that Google recommends as closely as possible (as per 2024 guidelines), this should mean that no data transformation / restructuring is in the data layer / Google Tag Manager.



    Anchor
    item
    item
    search

    This event is triggered when the search results render from any of the following widgets

    • Product Search With Category Widget

    • Product Search Widget

    • Product Search With Preview Widget

    • Product Favourites page

    • Cart

    Item parameters below are included out-of-the-box.

    Name

    items

    Parameter

    CV Value

    Notes

    search_term

    Search term

    The search term used for search query


    Anchor
    item
    item
    view_item

    The view_item event triggers when the product details page loads.

    Item parameters below are included out-of-the-box.

    Name

    items

    Parameter

    CV Value

    Notes

    item_name

    product description

    Product description. One of item_id or item_name is required.

    item_id

    product code

    Product code. One of item_id or item_name is required.

    item_category

    product category

    top level/primary category.

    You can specify up to 5 categories:

    item_category: "Apparel",
    item_category2
    : "Adult",
    item_category3
    : "Shirts",
    item_category4
    : "Crew",
    item_category5
    : "Short sleeve

    item_list_name

    list type

    List type of list product was in:

    • Product Detail
    • Product Category
    • Search Results
    • Recently Viewed
    • Campaign
    • Alternate Products
    • Related Products
    • Cart Fast Order Entry
    • Product Compare
    • User Favourites
    • Prior Purchases
    • Cart Lines

    *NOTE - Zoned Product Layout must be in use for Ecommerce to work with lists.

    If set, event-level item_list_name is ignored.
    If not set, event-level item_list_name is used, if present.

    item_brand

    brand

    Product's brand. NOTE - Currently not standard inclusion from CV ecommerce platform. Must be custom added. 

    index

    numerical value

    position of item presented in list (if applicable)

    price

    Monetary nett price of the product, in  the specified currency.

    If 'hide pricing' is enabled at Role level, this data is not pushed.

    currency

    currency of site in 3-letter ISO 4217 format



    Multiple currencies per event is not supported. Each item should set the same currency.

    For GA4, currency can be set at both item and event levels. When item level currency has been set, any event-level setting is ignored.

    Event level structure: event.currency

    value

    Total item value

    The same as price, but shown outside of the items array

    Event level structure: event.value


    view_item_list 

    The view_item_list event is logged when the user has been presented with a list of items from a certain category or search results, e.g., from a search results, a category list or user's favourites. 

    Data sent include items, to specify each product with their details. 

    Event Name

    view_item_list

    Parameter

    Value

    Notes

    item_list_name

    list type

    For list type names, see: List Names

    Ignored if set at the item-level.

    Event

    items [ ]

    An array with each product in the list.

    Required: yes

    See: items event and variables/values for product data sent.


    Anchor
    ecomclicks
    ecomclicks
    select_item

    The select_item event signifies an item was selected from a list, i.e., product was clicked. Data is pushed on any click on a product link, e.g., on a search results page or from the user's favourites list. It includes data from the items array with the clicked product as the only product.  

    Event Name

    select_item

    Variable

    Value

    Notes

    item_name

    product description

    Product description. One of item_id or item_name is required.

    item_id

    product code

    Product code. One of item_id or item_name is required.

    item_category

    product category

    top level/primary category.

    You can specify up to 5 categories:

    item_category: "Apparel",
    item_category2
    : "Adult",
    item_category3
    : "Shirts",
    item_category4
    : "Crew",
    item_category5
    : "Short sleeve

    item_list_name

    list type

    List type of list product was in:

    • Product Detail
    • Product Category
    • Search Results
    • Recently Viewed
    • Campaign
    • Alternate Products
    • Related Products
    • Cart Fast Order Entry
    • Product Compare
    • User Favourites
    • Prior Purchases
    • Cart Lines

    *NOTE - Zoned Product Layout must be in use for Ecommerce to work with lists.

    If set, event-level item_list_name is ignored.
    If not set, event-level item_list_name is used, if present.

    item_brand

    brand

    Product's brand. NOTE - Currently not standard inclusion from CV ecommerce platform. Must be custom added. 

    index

    numerical value

    position of item presented in list (if applicable)

    price

    Monetary nett price of the product, in  the specified currency.

    If 'hide pricing' is enabled at Role level, this data is not pushed.

    currency

    currency of site in 3-letter ISO 4217 format



    Multiple currencies per event is not supported. Each item should set the same currency.

    For GA4, currency can be set at both item and event levels. When item level currency has been set, any event-level setting is ignored.

    Event level structure: event.currency

    value

    Total item value

    The same as price, but shown outside of the items array

    Event level structure: event.value

    Anchor
    ecomclicks
    ecomclicks
    add_to_wishlist

    The add_to_wishlist event signifies an item was added to the favourites

    Event Name

    select_item

    Variable

    Value

    Notes

    item_list_name

    list type


    List type product was on when selected. See: List Names

    * NOTE - Zoned Product Layout must be in use for Enhanced Ecommerce to work with lists.

    value

    Monetary value of product price x quantity


    items [array]

    selected product details

    The items array with the selected product. See: Items object for product data values. 

    If multiple products are provided, only the first product will be used. 


    Anchor
    ecomcheckout
    ecomcheckout
    begin_checkout

    The begin_checkout event is triggered when the "Begin Checkout" button is clicked from the cart.

    Event Name

    begin_checkout

    VariableValueNotes

    currency

    currency of site in 3-letter ISO 4217 format

    Multiple currencies per event is not supported. Each item should set the same currency.

    For GA4, currency can be set at both item and event levels. When item level currency has been set, any event-level setting is ignored.

    value

    Monetary value of all products

    Total cost of products in cart

    coupon

    Campaign name

    If name of any promotion

    items

    items [ ]

    Array contains each product in the cart.

    • Standard product data (e.g. name, id, category, brand, price) are included for each product. See: items event for product data values. 


    Anchor
    ecomtrans
    ecomtrans
    purchase

    The purchase event is triggered when the cart is checked out

    Event Name

    purchase

    Variable

    Value

    Notes

    Event

    transaction


    transaction_id

    sales order number

    generated from your system

    value

    total order value


    tax

    total tax value

    will depend on whether inc or exc tax has been set

    shipping

    total shipping value


    currency

    currency of site in 3-letter ISO 4217 format

    Event level structure: event.currency


    Anchor
    ecomaddtocart
    ecomaddtocart
    add_to_cart

    The add_to_cart event is triggered every time a user successfully adds items to cart. This is recommended for businesses with online sales. 

    These parameters are included.

    Event

    add_to_cart


    Parameter

    Value

    Notes

     value

    value

     monetary value of the event* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value.

    * currency is required if you set value.

    currency

    Currency code of the current event, in 3-letter ISO 4217 format.

    If set, item-level currency is ignored. If not set, currency from the first item in items is used.

    Event level structure: event.currency

    * If you set value then curr
    ency is required for revenue metrics to be computed accurately.

    Array

    Items [ ]

    An array with each product and standard product data (e.g. name, id, category, quantity, brand, price) included. See: items for product data values. 

    Product data can also include the item_list_name parameter to provide information on the list type from which the product was added.

    *NOTE - Zoned Product Layout must be used in order to collect data from lists. See: List Names


    Anchor
    ecomaddtocart
    ecomaddtocart
    add_payment_info

    The add_payment_info event is triggered every time a user successfully adds payment info during checkout. 

    These parameters are included.

    Event

    add_to_cart


    Parameter

    Value

    Notes

     value

    value

     monetary value of the event* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value.

    currency is required if you set value.

    currency

    Currency code of the current event, in 3-letter ISO 4217 format.

    If set, item-level currency is ignored. If not set, currency from the first item in items is used.

    * If you set value then currency is required for revenue metrics to be computed accurately.

    payment type

    They type of payment

    Where the payment originated from:

    • Account payment
    • Order

    step

    Number 4

    The number of the step from the checkout flow, for this event it's 4

    Array

    Items [ ]

    An array with each product and standard product data (e.g. name, id, category, quantity, brand, price) included. See: items for product data values. 

    Product data can also include the item_list_name parameter to provide information on the list type from which the product was added.

    *NOTE - Zoned Product Layout must be used in order to collect data from lists. See: List Names


    Anchor
    ecomaddtocart
    ecomaddtocart
    add_shipping_info

    The add_shipping_info event is triggered every time a user successfully adds payment info during checkout. 

    These parameters are included.

    Event

    add_to_cart


    Parameter

    Value

    Notes

     value

    value

     monetary value of the event* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value.

    currency is required if you set value.

    currency

    Currency code of the current event, in 3-letter ISO 4217 format.

    If set, item-level currency is ignored. If not set, currency from the first item in items is used.

    * If you set value then currency is required for revenue metrics to be computed accurately.

    payment type

    They type of payment

    Where the payment originated from:

    • Account payment
    • Order

    step

    Number

    The number of the step from the checkout flow, for this event it's 1

    Array

    Items [ ]

    An array with each product and standard product data (e.g. name, id, category, quantity, brand, price) included. See: items for product data values. 

    Product data can also include the item_list_name parameter to provide information on the list type from which the product was added.

    *NOTE - Zoned Product Layout must be used in order to collect data from lists. See: List Names


    Anchor
    ecomremovefromcart
    ecomremovefromcart
    remove_from_cart

    The remove_from_cart event is triggered whenever a product is successfully removed from the shopper's cart.

    NOTE - This can be a whole line deletion, or a decrease in quantity. Both actions are sent as 'Remove From Cart' data.

    Event

    remove_from_cart

    Parameter

    Value

    Notes

    value

    value

    value of order line (product x quantity)

    currency

    currency code

    currency code for the current account

    array

    items [ ] 

    An array containing each product removed with its details (e.g. name, id, category, quantity, brand, price)  included. See: items event for product data values. 



    Anchor
    richsnippets
    richsnippets
    Enhanced Rich Snippets

    You can add rich snippets to include key summary details about a website page when it displays in Google search results. An example might be to show ratings for a product's page on your site.   

    Learn more: https://developers.google.com/search/blog/2009/05/introducing-rich-snippets


    Related Resources

    Content by Label
    showLabelsfalse
    max5
    spacesKB
    showSpacefalse
    sortmodified
    reversetrue
    typepage
    excludeCurrenttrue
    cqllabel in ("google","analytics") and type = "page" and space = "KB"
    labelsGoogle Analytics