Google & YouTube app event parameters

The Google & YouTube app helps automatically send important events and parameters for Google tags. These events and parameters are mapped from Shopify's standard events.

Google tag event parameters:

page_view

The page_view event logs an instance where a customer visited a page. When the listener for page_viewed events is invoked, it will look up the Destination IDs associated with the gtag event name page_view in the settings object.

Parameters

Google tag event parameter
page_path
page_title
page_location

view_item

The view_item event logs an instance where a customer visited a product details page. When the listener for product_viewed events is invoked, it will look up the Destination IDs associated with the gtag event name view_item in the settings object.

Parameters

Google tag event parameter
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype
items

add_to_cart

The add_to_cart event logs an instance where a customer adds a product to their cart. When the listener for product_added_to_cart events is invoked, it will look up the Destination IDs associated with the gtag event name add_to_cart in the settings object.

Parameters

Google tag event parameter
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype
value
currency
id
name
brand
category
price
quantity
variant

purchase

The purchase event logs when a visitor completes a purchase. When the listener for checkout_completed events is invoked, it will look up the Destination IDs associated with the gtag event name purchase in the settings object.

Starting April 24, 2025, purchase values reported by Google tags loaded through the Google & YouTube app on Shopify have been updated to take discounts into account (i.e. value = subtotal - discounts).

Parameters

Google tag event parameter
new_customer
transaction_id
value
currency
tax
shipping
id
name
brand
category
coupon
price
quantity
variant

begin_checkout

The begin_checkout event logs an instance of a customer starting the checkout process When the listener for checkout_started events is invoked, it will look up the Destination IDs associated with the gtag event name begin_checkout in the settings object.

Starting April 24, 2025, begin_checkout values reported by Google tags loaded through the Google & YouTube app on Shopify have been updated to take discounts into account (i.e. value = subtotal - discounts).

Parameters

Google tag event parameter
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype
value
currency
coupon
id
name
brand
category
coupon
price
quantity
variant

The search event logs an instance where a customer performed a search on the storefront. When the listener for search_submitted events is invoked, it will look up the Destination IDs associated with the gtag event name search in the settings object.

Parameters

Google tag event parameter
search_term

add_payment_info

The add_payment_info event logs an instance of a customer submitting their payment information. When the listener for payment_info_submitted events is invoked, it will look up the Destination IDs associated with the gtag event name add_payment_info in the settings object.

Parameters

Google tag event parameter
currency
total