[GA4] 自动收集的事件

自动收集的事件会在用户与您的应用和/或网站进行基本互动时触发(如下表中事件名称下所示)。只要您使用 SDKgtag.js,无需额外编写代码就能收集这些事件。

除非另有说明,否则 Analytics(分析)会针对 Android 和 iOS 应用收集这些事件。

Note

The following parameters are collected by default with every event, including custom events:

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution
事件名称 何时自动触发 参数

ad_click

(应用)

当用户点击广告时触发

这是从 AdMob 通过 Google 移动广告 SDK 传来的发布商事件

ad_event_id

ad_exposure

(应用)

当移动广告 SDK 投放的广告至少有一个在屏幕上时触发 firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time

ad_impression

(应用)

当用户看到展示的广告时触发

这是从 AdMob 通过 Google 移动广告 SDK 传来的发布商事件

ad_event_id

ad_query

(应用)

当移动广告 SDK 发出广告请求时触发 ad_event_id

ad_reward

(应用)

当移动广告 SDK 投放的激励广告授予奖励时触发 ad_unit_id、reward_type、reward_value

adunit_exposure

(应用)

当移动广告 SDK 投放的广告单元在屏幕上时触发 firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time

app_clear_data

(应用)

当用户通过重置/清除应用数据来移除所有设置和登录数据时触发

仅限 Android

 

app_exception

(应用)

当应用崩溃或引发异常时触发 fatal、timestamp、engagement_time_msec

app_remove

(应用)

当应用包从 Android 设备上移除(卸载)时触发

仅限 Android

此事件与“每日卸载该应用的设备数量”和“每日卸载该应用的用户数”指标不同,后面两个指标是由 Google Play 管理中心报告的。“app_remove”事件统计的是应用软件包的移除次数(不管安装来源),此数目会因您使用的报告日期范围的不同而有所变化。而“每日卸载该应用的设备数量”和“每日卸载该应用的用户数量”指标只统计从 Google Play 安装的应用包的移除次数,并且会按日报告数据。

 

app_store_refund

(应用)

当 Google Play 对应用内购买进行退款时触发

仅限 Android

此事件不会导出到 BigQuery。

product_id、value、currency、quantity

app_store_

subscription_cancel

(应用)

当用户在 Google Play 中取消付费订阅时触发

仅限 Android

要求首次订阅日期不能早于 2019 年 7 月 1 日。

此事件不会导出到 BigQuery。

product_id、price、value、currency、cancellation_reason

app_store_

subscription_convert

(应用)

当用户从免费试阅转换为付费订阅时触发

此事件设置为默认转化。

要求首次订阅日期不能早于 2019 年 7 月 1 日。系统会将首次免费试订阅记录为“in_app_purchase”,并将订阅参数设为“true”。

此事件不会导出到 BigQuery。

product_id、price、value、currency、quantity

app_store_

subscription_renew

(应用)

当用户续订付费订阅时触发

此事件设置为默认转化。

要求首次订阅日期不能早于 2019 年 7 月 1 日。

此事件不会导出到 BigQuery。

product_id、price、value、currency、quantity、renewal_count

app_update

(应用)

当应用更新到新版本并再次启动时触发

旧的应用版本 ID 会作为一个参数传递。

此事件在概念上与“每日升级该应用的设备数量”指标不同,后者由 Google Play 管理中心报告。升级是指更新应用二进制文件,而 app_update 事件是在升级后的应用启动时触发。

previous_app_version

点击

(网站)

每当用户点击会将他们带离当前网域的链接时触发

默认情况下通过增强型衡量功能收集。

系统不会收集任何参数
当用户通过动态链接再次打开应用时触发 source、medium、campaign、link_id、accept_time

当应用通过动态链接更新到新版本并打开时触发

仅限 Android

source、medium、campaign、link_id、accept_time
当用户通过动态链接首次打开应用时触发 source、medium、campaign、link_id、accept_time

错误

(应用)

当特定事件由于某种原因导致失效而无法记录时,系统就会改为记录此事件

_err (firebase_error)、_ev (firebase_error_value) 和 _el (firebase_error_length) 参数会提供额外的信息。
firebase_error、firebase_error_value

file_download

(网站)

当用户点击指向以下类型的文件(带有常见文件扩展名)的链接时触发:
  • 文档
  • 文本
  • 可执行文件
  • 演示文稿
  • 压缩文件
  • 视频
  • 音频

当文件扩展名符合以下正则表达式时,将会触发对应事件:

pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma

此事件默认情况下通过增强型衡量功能收集。

file_extension、file_name、link_classes、link_domain、link_id、link_text、link_url

firebase_campaign

(应用)

使用广告系列参数启动应用时触发 source、medium、campaign、term、content、gclid、aclid、cp1、anid、click_timestamp、campaign_info_source

firebase_in_app_

message_action

(应用)

当用户对 Firebase 应用内消息执行操作时触发 message_name、message_device_time、message_id

firebase_in_app_

message_dismiss

(应用)

当用户关闭 Firebase 应用内消息时触发 message_name、message_device_time、message_id

firebase_in_app_

message_impression

(应用)

当用户查看 Firebase 应用内消息时触发 message_name、message_device_time、message_id

first_open

(应用)

当用户在安装或重新安装应用后首次启动该应用时触发

此事件在用户首次使用该应用时触发,而不是在用户将该应用下载到设备上时触发。要查看原始下载量数据,请访问 Google Play 管理中心或 iTunesConnect。

支持衡量接受 Apple iOS 14 应用跟踪提示的用户的 first_open 转化次数。
previous_gmp_app_id、updated_with_analytics、previous_first_open_count、system_app、system_app_update、deferred_analytics_collection、reset_analytics_cause、engagement_time_msec

first_visit

(应用、网站)

当用户首次访问/启动启用了 Analytics(分析)的网站或 Android 免安装应用时触发  

in_app_purchase

(应用)

当用户完成由 iTunes 上的 App Store 或 Google Play 处理的应用内购买交易(包括首次订阅)时触发

产品 ID、产品名称、币种和数量会作为参数传递。

要查看 Android 应用的 in_app_purchase 数据,您需要将 Google Analytics(分析)关联到 Google Play

Google Analytics(分析)支持在 Android 和 iOS 设备上自动跟踪订阅情况。

只有包含 Firebase SDK 的应用版本才会触发此事件。注意:系统不会自动跟踪付费应用的购买收入和退款(仅限 iOS)。报告的收入可能与您在 Google Play 管理中心看到的值不同。标记为无效或沙盒(测试)的事件会被忽略。只有 iOS 事件会被标记为沙盒。点此可详细了解如何测试 Google Play 结算服务。

product_id、price、value、currency、quantity、subscription、free_trial、introductory_price

notification_dismiss

(应用)

当用户关闭 FCM 发出的通知时触发

仅限 Android

message_name、message_time、message_device_time、message_id、topic、label、message_channel

notification_foreground

(应用)

当设备收到 FCM 发出的通知且应用在前台运行时触发 message_name、message_time、message_device_time、message_id、topic、label、message_channel、message_type

notification_open

(应用)

当用户打开 FCM 发出的通知时触发 message_name、message_time、message_device_time、message_id、topic、label、message_channel

notification_receive

(应用)

当设备收到 FCM 发出的通知且应用在后台运行时触发

仅限 Android

message_name、message_time、message_device_time、message_id、topic、label、message_channel、message_type

notification_send

(应用)

当 FCM 发出通知时触发

仅限 Android

message_name、message_time、message_device_time、message_id、topic、label、message_channel

os_update

(应用)

当设备操作系统更新为新版本时触发。旧操作系统版本 ID 会作为参数传递 previous_os_version

page_view

(网站)

当网页加载或处于活动状态的网站更改浏览器历史记录状态时触发

默认情况下通过增强型衡量功能收集。

page_location(网页网址)、page_referrer(之前的网页网址)

screen_view

(应用)

当发生屏幕转换且符合以下任一条件时触发:
  • 之前没有设置屏幕
  • 新的屏幕名称与以前的屏幕名称不同
  • 新的屏幕类名称与以前的屏幕类名称不同
  • 新的屏幕 ID 与以前的屏幕 ID 不同
firebase_screen、firebase_screen_class、firebase_screen_id、firebase_previous_screen、firebase_previous_class、firebase_previous_id、engagement_time_msec

scroll

(网站)

当用户首次到达每个页面的底部时(即,当页面 90% 的垂直深度可见时)触发

默认情况下通过增强型衡量功能收集。

engagement_time_msec

session_start

(应用、网站)

当用户与应用或网站互动时触发  

user_engagement

(应用、网站)

当应用在前台运行,或者网页在活动窗口中显示时,定期触发 engagement_time_msec

video_complete

(网站)

当视频播放完毕时触发

适用于已启用 JS API 支持 的嵌入式 YouTube 视频。

默认情况下通过增强型衡量功能收集。

video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible(布尔值)

video_progress

(网站)

当视频播放时长超过 10%、25%、50% 和 75% 时触发

适用于已启用 JS API 支持 的嵌入式 YouTube 视频。

默认情况下通过增强型衡量功能收集。

video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible(布尔值)

video_start

(网站)

当视频开始播放时触发

适用于已启用 JS API 支持 的嵌入式 YouTube 视频。

默认情况下通过增强型衡量功能收集。

video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible(布尔值)

view_search_results

(网站)

当用户执行网站搜索时触发,此类事件以网址查询参数表示

默认情况下通过增强型衡量功能收集。

search_term、可选的“q_<additional key="">”(其中 <additional key=""> 与您在“高级设置”下指定要收集的另一个查询参数匹配)
该内容对您有帮助吗?
您有什么改进建议?
搜索
清除搜索查询
关闭搜索框
Google 应用
主菜单
搜索支持中心
true
5054967
false