• Tracking with Google Analytics 4 (GA4) and Google Tag Manager (GTM) happens via the dataLayer object, which can be accessed by any JavaScript running on the page.

  • There is a difference in formatting between events meant for GA4 and events meant for GTM, although both can be accessed via data layer variables in Google Tag Manager.

  • Each event can be turned on or off on demand by our support staff, but GA4 events do require the Convious Google Analytics 4 integration to be active on your website. Here is our Convious guide to enable the Google Analytics 4 integration.

     

Google Analytics 4 data layer events

Below is an overview of events that our Checkout can track to Google Analytics 4.
In order to access the parameters in these events via Google Tag Manager data layer variables, the field names should be prefixed with eventModel., e.g. eventModel.item_list_id.

page_view

Tracked when the user visits a page inside the Checkout widget. No parameters are included in the dataLayer for this event, but Google Analytics 4 does collect things like page title and url for it.

view_item_list

Tracked when the user views a list of products.

Parameters

Name

Type

Example value

Description

item_list_id

string

"ce68fff6-4ce9-4996-b5d1-1020baf7d0ad"

The ID of the list in which the item was presented to the user

item_list_name

string

"Dated Tickets"

The name of the list in which the item was presented to the user

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

items

Array<item>

[{ "item_id": ... }]

The products that were viewed

add_to_cart

Tracked when the user adds products to their cart.

Parameters

Name

Type

Example value

Description

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

items

Array<item>

[{ "item_id": ... }]

The products that were added to the cart

begin_checkout

Tracked when the user reaches the cart review screen

Parameters

Name

Type

Example value

Description

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

items

Array<item>

[{ "item_id": ... }]

The items that the user had in their cart when they reached the cart review screen

view_cart

Tracked when the user reaches the cart review screen

Parameters

Name

Type

Example value

Description

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

items

Array<item>

[{ "item_id": ... }]

The items that the user had in their cart when they reached the cart review screen

view_item

Tracked when the user views an upsell item on the cart review page.

Parameters

Name

Type

Example value

Description

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

items

Array<item>

[{ "item_id": ... }]

The items that were viewed

purchase

Tracked when the user completes a purchase.

Parameters

Name

Type

Example value

Description

transaction_id

string

"bd968afc-d4fe-48bd-9f94-a691544ec63a"

The unique identifier of the order

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

value

number

38.25

The total value of the order

coupon

string

"DISCOUNT20|SUMMERSALE"

The coupon codes that were used, separated by a pipe character

items

Array<item>

[{ "item_id": ... }]

The products that were purchased

 

item parameters

The following parameters are tracked for each item in the items Array when available

Name

Type

Example value

Description

item_id

string

"40cfb7a9-feac-47c3-a85b-6b35b8024fa5"

The ID of the product

item_name

string

"Adult day ticket"

The name of the product

price

number

12.75

The price of the product

quantity

number

3

The number of products that were added to the cart or purchased

 

Google Tag Manager data layer events

The Google Tag Manager tracking is considered a legacy feature. It is highly recommended to use Google Analytics 4 events instead.

Below is an overview of events that our Checkout can track to Google Tag Manager.

convious-pageview

Tracked when the user views a page inside the Checkout widget.

Parameters

Name

Type

Example value

Description

category

string

"/pick-your-place"

The event category

action

string

"convious-pageview"

The event action, always "convious-pageview"

label

string

"convious-pageview"

The event label, always "convious-pageview"

page

string

"/pick-your-place"

The page path

title

string

"Convious Checkout Page"

The page title

convious-order

Tracked when the visitor completes their purchase.

Parameters

Name

Type

Example value

Description

email

string

"name@domain.com"

The user's email address

transactionId

string

"10385321"

The internal order ID

transactionAffiliation

string

"convious"

Affiliation of the order, always "convious"

transactionTotal

string

38.25

Total order value

transactionShipping

number

0

Shipping cost of the order, always 0

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

transactionProducts

Array<transactionProduct>

[{ "sku": ... }]

The purchased products
transactionProduct parameters

Name

Type

Example value

Description

sku

string

"convious-Adult ticket"

Product SKU, generated from a convious prefix and internal product name

name

string

"convious-Adult day ticket"

Product name with a convious prefix

category

string

"regular-rtp"

The product's category, generated from the article type and pricing type

price

string

"12.75"

The price of the product as a string

quantity

number

3

The number of products purchased

convious-order-v2

An updated version of convious-order, with somewhat more useful data.

Parameters

Name

Type

Example value

Description

email

string

"name@domain.com"

The user's email address

transactionId

string

"101211336"

The order number as displayed in the Control Panel

transactionAffiliation

string

"convious"

Affiliation of the order, always "convious"

transactionTotal

string

38.25

Total order value

transactionShipping

number

0

Shipping cost of the order, always 0

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

transactionProducts

Array<transactionProduct>

[{ "sku": ... }]

The purchased products
transactionProduct parameters

Name

Type

Example value

Description

sku

string

"1789"

Product ID

name

string

"convious-Adult day ticket"

Product name

category

string

"regular-rtp"

The product's category, generated from the article type and pricing type

price

string

"12.75"

The price of the product as a string

quantity

number

3

The number of products purchased

purchase

Tracked when the visitor completes their purchase.

Parameters

Name

Type

Example value

Description

ecommerce

object

{"transaction_id": ...}

The ecommerce object, see below
Ecommerce parameters

Name

Type

Example value

Description

transaction_id

string

"10385321"

The internal order ID

currency

string

"EUR"

Currency of the items associated with the order, in 3-letter ISO 4217 format

value

number

38.25

Affiliation of the order, always "convious"

coupon

string

"DISCOUNT20"

The coupon used during the purchase

user_data

object

{ "email_address": "name@domain.com", "address": {} }

An object containing the user's email_address. The address property is always an empty object.

x-fb-event_id

string

"fb-event-purchase-10385321"

An event ID used for Facebook tracking, generated by a prefix and the internal order ID

items

Array<item>

[{ "item_id": ... }]

The purchased products
item parameters

Name

Type

Example value

Description

item_id

string

"convious-Adult ticket"

Product ID, generated from a convious prefix and internal product name

item_name

string

"convious-Adult day ticket"

Product name with a convious prefix

item_category

string

"regular-rtp"

The product's category, generated from the article type and pricing type

price

string

"12.75"

The price of the product as a string

quantity

number

3

The number of products that were added to the cart or purchased