将推荐事件添加到您的网站或移动应用有助于您衡量更多功能和行为，并生成更实用的报告。由于这类事件需要更多上下文才有意义，因此系统不会自动发送它们。
您可以使用本文中的链接查看各个事件的指定参数。此外，您应该发送带有指定参数的推荐事件，以便在报告中获得最详细的信息，并在未来功能和集成服务推出时充分利用它们。
如需了解如何在网站或应用中设置推荐事件，请参阅设置事件。
所有媒体资源
我们建议所有行业的所有客户都实现下表所列事件。本文后面的部分列出了其中一部分事件，以及我们建议针对给定用例发送相应事件的时机。
| 事件 | 何时触发 |
|---|---|
| ad_impression | 当用户看到广告展示时触发（仅限应用） |
| earn_virtual_currency | 当用户获得虚拟货币（金币、宝石、代币等）时触发 |
| 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 | 当用户开始结账时触发 |
| generate_lead | 当用户提交表单或信息请求时触发 |
| 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 | 当用户解锁成就时触发 |
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 架构格式会发生变化。商品/产品数据将开始显示在重复字段中，以支持在单个事件中分析多种产品。在此次升级过程中，您应注意调整引用商品/产品数据字段的任何查询