The [Google \& YouTube app](https://apps.shopify.com/google) helps automatically
send important events and parameters for Google tags. These events and
parameters are mapped from
[Shopify's standard events](https://shopify.dev/docs/api/web-pixels-api/standard-events).
In addition, the [Google \& YouTube app](https://apps.shopify.com/google) sends
standard measurement events, such as `session_start`, `user_engagement`, and
`first_visit`.

## Google tag event parameters:

- [page_view](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#page_view)
- [view_cart](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#view_cart)
- [view_item](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#view_item)
- [view_item_list](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#view_item_list)
- [add_to_cart](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#add_to_cart)
- [purchase](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#purchase)
- [begin_checkout](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#begin_checkout)
- [search](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#search)
- [remove_from_cart](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#remove_from_cart)
- [add_payment_info](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#add_payment_info)
- [add_shipping_info](https://developers.google.com/tag-platform/gtagjs/reference/shopify-event-parameters#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] > **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] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **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] > **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] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **Note:** The value of this string is USD by default if no currency has been set in the event data. |
| `ecomm_pagetype` > [!NOTE] > **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] > **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] > **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] > **Note:** The value of this string is "cart" for this event. |
| `value` |
| `currency` > [!NOTE] > **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] > **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] > **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] > **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] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **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] > **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] > **Note:** The value of this string will be "cart" for this event. |
| `value` > [!NOTE] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **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] > **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] > **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] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **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] > **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] > **Note:** The value of this string is USD by default if no currency has been set in the event data. |
| `total` > [!NOTE] > **Note:** This parameter is deprecated. Use the `value` parameter instead. |
| `value` > [!NOTE] > **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] > **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] > **Note:** This parameter takes into account both item and order level discounts but does not include shipping charges and taxes. |
| `currency` > [!NOTE] > **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] > **Note:** Not all events contain user data. User data collection depends on consent and Google Analytics settings. |

> [!NOTE]
> **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.](https://developers.google.com/tag-platform/gtagjs/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.