Shopify 事件参数

Google & YouTube 应用可帮助自动为 Google 代码发送重要事件和参数。这些事件和参数是从 Shopify 的标准事件映射而来的。此外，Google & YouTube 应用还会发送标准衡量事件，例如 session_start、user_engagement 和 first_visit。

Google 代码事件参数：

• 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

page_view 事件用于记录客户访问网页的实例。当 page_viewed 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 page_view 相关联的目标 ID。

Google 代码事件参数
page_path
page_title
page_location
shopify_event_name
ext_client_id
event_id
user data email phone_number address first_name last_name 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

view_cart

view_cart 事件用于记录客户查看购物车页面的实例。

Google 代码事件参数
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

view_item

view_item 事件用于记录客户访问商品详情页面的实例。当 product_viewed 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 view_item 关联的目标 ID。

Google 代码事件参数
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
ecomm_pagetype 注意：此字符串的值对于此事件为“product”。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

view_item_list

view_item_list 事件用于记录客户访问产品集合索引页面的实例。此活动可在网店页面上找到。

Google 代码事件参数
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

add_to_cart

add_to_cart 事件用于记录客户将商品添加到购物车的情况。当 product_added_to_cart 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 add_to_cart 相关联的目标 ID。

Google 代码事件参数
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype 注意：对于此事件，此字符串的值为“cart”。
value
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

purchase

当访问者完成购买时，系统会记录 purchase 事件。当 checkout_completed 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 purchase 相关联的目标 ID。

自 2025 年 4 月 24 日起，通过 Shopify 上的 Google & YouTube 应用加载的 Google 代码报告的购买价值已更新为将折扣纳入考虑范围（即价值 = 小计 - 折扣）。

Google 代码事件参数
new_customer 注意：在升级后的致谢页上，如果这是用户的首笔订单，此参数值将为 true，否则为 false。
customer_type 注意：在升级后的致谢页上，如果用户是首次下单，此参数值将为“new”，否则为“returning”。
transaction_id
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

begin_checkout

begin_checkout 事件用于记录客户开始结账流程的实例。当 checkout_started 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 begin_checkout 相关联的目标 ID。

自 2025 年 4 月 24 日起，通过 Shopify 上的 Google & YouTube 应用加载的 Google 代码报告的 begin_checkout 值已更新为将折扣纳入考虑范围（即价值 = 小计 - 折扣）。

Google 代码事件参数
ecomm_prodid[]
ecomm_totalvalue
ecomm_pagetype 注意：对于此事件，此字符串的值将为“cart”。
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

搜索

search 事件用于记录客户在店面中执行搜索的实例。当 search_submitted 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 search 关联的目标 ID。

Google 代码事件参数
search_term
shopify_event_name
event_id
ext_client_id
user data email phone_number address first_name last_name 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

remove_from_cart

remove_from_cart 事件用于记录客户从购物车中移除商品的实例。此活动可在网店页面上找到。

Google 代码事件参数
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

add_payment_info

add_payment_info 事件用于记录客户提交支付信息的实例。当 payment_info_submitted 事件的监听器被调用时，它会在设置对象中查找与 gtag 事件名称 add_payment_info 关联的目标 ID。

Google 代码事件参数
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
total 注意：此参数已弃用。请改用 value 参数。
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

add_shipping_info

add_shipping_info 事件用于记录客户在结账时提供配送或地址详细信息的实例。此事件仅在已启用结账可扩展性以进行自定义的结账流程中可用。

Google 代码事件参数
value 注意：此参数会同时考虑商品级折扣和订单级折扣，但不包含运费和税费。
currency 注意：如果事件数据中未设置任何币种，则此字符串的值默认为美元。
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 注意：并非所有事件都包含用户数据。用户数据收集取决于用户同意情况和 Google Analytics 设置。

注意：如果您想从 Google Analytics 报告中排除特定事件数据，可以使用 shopify_event_name 参数在 Google Analytics 中创建过滤器。详细了解过滤参数。 如果您希望停止从应用传输所有 Google Analytics 数据（包括购买事件和您依赖的其他数据），可以在 Shopify 管理中心的 Google & YouTube 应用设置中断开 Google Analytics 集成。断开连接后，您将无法在 Google Analytics 中监控 Shopify 商店的效果和用户行为，