将推荐事件添加到您的网站或移动应用有助于您衡量更多功能和行为，并生成更实用的报告。由于这类事件需要更多上下文才有意义，因此系统不会自动发送它们。
您可以使用本文中的链接查看各个事件的指定参数。此外，您应该发送带有指定参数的推荐事件，以便在报告中获得最详细的信息，并在未来功能和集成服务推出时充分利用它们。
如需了解如何在网站中设置推荐事件，请参阅设置事件。如果是应用项目，请参阅记录事件。这些事件中的数据会自动更新预定义的维度和指标，以便您分析报告中的数据。
使用 Google Analytics（分析）中的推荐事件衡量用户活动
所有媒体资源
我们建议所有行业的所有客户都实现下表所列事件。本文后面的部分列出了其中一部分事件，以及我们建议针对给定用例发送相应事件的时机。
| 事件 | 在用户执行以下操作时触发… |
|---|---|
| ad_impression | 看到广告（仅限应用） |
| earn_virtual_currency | 获得虚拟货币（金币、宝石、代币等） |
| generate_lead | 提交表单或信息请求 |
| join_group | 加入群组 |
| login | 登录 |
| purchase | 完成购买 |
| refund | 收到退款 |
| search | 搜索您的网站或应用 |
| select_content | 选择您网站或应用中的内容 |
| share | 共享您网站或应用中的内容 |
| sign_up | 在您的网站或应用中注册帐号 |
| spend_virtual_currency | 支出虚拟货币（金币、宝石、代币等） |
| tutorial_begin | 在新手入门流程中开始教程 |
| tutorial_complete | 在新手入门流程中完成教程 |
线上销售
如果您想衡量网站或应用中的销售情况，我们建议您实现以下事件。它们适用于零售、电子商务、教育、房地产和旅游行业。发送这些事件会填充“电子商务购买”报告。如需详细了解这些事件，请参阅网站适用的衡量电子商务一文。如需了解应用项目中的事件，请参阅衡量电子商务（应用）一文。
| 事件 | 在用户执行以下操作时触发… |
|---|---|
| add_payment_info | 在结账过程中提交付款信息 |
| add_shipping_info | 在结账过程中提交配送信息 |
| add_to_cart | 将商品添加到购物车 |
| add_to_wishlist | 将商品添加到心愿单 |
| begin_checkout | 开始结账 |
| purchase | 完成购买 |
| refund | 收到退款 |
| remove_from_cart | 从购物车中移除商品 |
| select_item | 从商品或服务清单中选择商品 |
| select_promotion | 选择促销活动 |
| view_cart | 查看购物车 |
| view_item | 查看商品 |
| view_item_list | 查看商品或服务清单 |
| view_promotion | 在您的网站或应用中查看促销活动 |
游戏
我们建议为游戏媒体资源实现这些事件。发送这些事件可填充游戏报告。
| 事件 | 在用户执行以下操作时触发… |
|---|---|
| earn_virtual_currency | 获得虚拟货币（金币、宝石、代币等） |
| join_group | 加入群组 |
| level_end | 在游戏中完成关卡 |
| level_start | 在游戏中开始新关卡 |
| level_up | 在游戏中升级 |
| post_score | 发布得分 |
| select_content | 选择内容 |
| spend_virtual_currency | 支出虚拟货币（金币、宝石、代币等） |
| tutorial_begin | 在新手入门流程中开始教程 |
| tutorial_complete | 在新手入门流程中完成教程 |
| unlock_achievement | 解锁成就 |
验证事件
您可以使用 DebugView 工具监控完成设置的推荐事件，也可以查看“实时”报告来了解真实用户触发的事件。
Google Analytics（分析）提供的事件建议
事件报告会根据您已收集的数据，或者根据 Google Play 商店或 iOS App Store 中的应用类别（例如电子商务、旅游），向您建议应收集的事件。默认情况下，“事件”表格的顶部会显示三条建议。
- 如要查看更多建议：点击全部显示。
- 如要显示用于收集事件的代码段：点击相应事件所在的行。
- 如要拒绝建议：将鼠标悬停在相应事件名称上，然后点击
。
将 SDK 更新到 Android 17.2.5（或更高版本）和/或 iOS 16.20.0（或更高版本）时的注意事项
如果您使用的是旧版 SDK 并计划升级到 Android 17.2.5（或更高版本）和/或 iOS 16.20.0（或更高版本），则应考虑以下事项：
- 升级后，您将只能在重复 items 数组中访问商品数据；商品数据将不再在标准事件参数中可用，因为它低于这些 SDK 版本。
- 进行此项更改是为了支持多产品分析。
- 您可能需要因此调整对商品/产品数据的引用。
在此次升级过程中，BigQuery 架构格式会发生变化。商品/产品数据将开始显示在重复字段中，以支持在单个事件中分析多种产品。在此次升级过程中，您应注意调整引用商品/产品数据字段的任何查询
