Shopify 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. In addition, the Google & YouTube app sends standard measurement events, such as session_start, user_engagement, and first_visit.

Google tag event parameters:

• page_view
• view_cart
• view_item
• view_item_list
• add_to_cart
• purchase
• begin_checkout
• search
• remove_from_cart
• add_payment_info
• add_shipping_info

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.

Google tag event parameter
page_path
page_title
page_location
shopify_event_name
ext_client_id
event_id
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

view_cart

The view_cart event logs an instance where a customer viewed the cart page.

Google tag event parameter
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
shopify_event_name
items items[].id items[].name items[].brand items[].category items[].variant items[].price items[].quantity items[].sku items[].variant_id
event_id
ext_client_id
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

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.

Google tag event parameter
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
ecomm_pagetype Note: The value of this string is "product" for this event.
ecomm_totalvalue
ecomm_prodid[]
shopify_event_name
items items[].id items[].name items[].brand items[].category items[].variant items[].variant_id items[].price items[].sku items[].quantity
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

view_item_list

The view_item_list event logs an instance where a customer visited a product collection index page. This event is available on the online store page.

Google tag event parameter
item_list_id
item_list_name
shopify_event_name
items items[].id items[].name items[].brand items[].category items[].variant items[].price items[].index items[].sku items[].variant_id
event_id
ext_client_id
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

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.

Google tag event parameter
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype Note: The value of this string is "cart" for this event.
value
currency Note: The value of this string is USD by default if no currency has been set in the event data.
shopify_event_name
event_id
ext_client_id
items items[].id items[].name items[].brand items[].category items[].variant items[].variant_id items[].price items[].sku items[].quantity
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

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).

Google tag event parameter
new_customer Note: On an upgraded thank you page, this parameter value will be true if this is the user's first order, and false otherwise.
customer_type Note: On an upgraded thank you page, this parameter value will be 'new' if this is the user's first order, and 'returning' otherwise.
transaction_id
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
tax
shipping
shopify_event_name
event_id
ext_client_id
items items[].id items[].name items[].brand items[].category items[].variant items[].variant_id items[].price items[].sku items[].quantity
market_id
coupon
user data email phone_number address first_name last_name street city region postal_code country Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

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).

Google tag event parameter
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype Note: The value of this string will be "cart" for this event.
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
coupon
shopify_event_name
event_id
ext_client_id
items items[].id items[].name items[].brand items[].category items[].variant items[].variant_id items[].price items[].sku items[].quantity items[].coupon
user data email phone_number address first_name last_name street city region postal_code country Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

search

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.

Google tag event parameter
search_term
shopify_event_name
event_id
ext_client_id
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

remove_from_cart

The remove_from_cart event logs an instance where a customer removes a product from their cart. This event is available on the online store page.

Google tag event parameter
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
shopify_event_name
items items[].id items[].name items[].brand items[].category items[].variant items[].price items[].quantity items[].sku items[].variant_id
event_id
ext_client_id
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

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.

Google tag event parameter
currency Note: The value of this string is USD by default if no currency has been set in the event data.
total Note: This parameter is deprecated. Use the value parameter instead.
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
payment_type
shopify_event_name
items items[].id items[].name items[].brand items[].category items[].coupon items[].variant items[].price items[].quantity items[].sku items[].variant_id
coupon
user data email phone_number address first_name last_name Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

add_shipping_info

The add_shipping_info event logs an instance where a customer provides shipping or address details at checkout. This event is only available in checkouts where Checkout Extensibility for customizations is enabled.

Google tag event parameter
value Note: This parameter takes into account both item and order level discounts but does not include shipping charges and taxes.
currency Note: The value of this string is USD by default if no currency has been set in the event data.
coupon
shipping
shopify_event_name
tax
items items[].id items[].name items[].brand items[].category items[].variant items[].variant_id items[].price items[].sku items[].quantity items[].coupon
event_id
ext_client_id
user data email phone_number address first_name last_name street city region postal_code country Note: Not all events contain user data. User data collection depends on consent and Google Analytics settings.

Note: If you want to exclude specific event data from your Google Analytics reports, you can use the shopify_event_name parameter to create filters within Google Analytics. Learn more about filtering parameters. If you prefer to stop all Google Analytics data transmission from the app, including purchase events and other data you rely on, you can disconnect the Google Analytics integration within the Google & YouTube app settings in your Shopify admin. Disconnecting will significantly limit your ability to monitor performance and user behavior from your Shopify store in Google Analytics.