跟踪 Google Analytics(分析)事件

本页介绍如何使用 gtag.js 发送 Google Analytics(分析)事件

发送事件

要在已添加跟踪代码段的网页上发送 Google Analytics(分析)事件,请按照以下语法使用 gtag.js event 命令:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});
  • <action> 是在 Google Analytics(分析)事件报告中显示为事件操作的字符串。
  • <category> 是显示为事件类别的字符串。
  • <label> 是显示为事件标签的字符串。
  • <value> 是一个显示为事件价值的非负整数。

以下示例会触发操作为“xyz”、默认类别为“general”、默认标签为“(not set)”的 Google Analytics(分析)事件:

gtag('event', 'xyz');

在代码中指定您自己的值,就可以替换默认参数值。以下示例触发操作为“aaa”、类别为“bbb”和标签为“ccc”的 Google Analytics(分析)事件:

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

详细了解 Google Analytics(分析)事件参数的解析(即类别、操作、标签和价值)。

默认 Google Analytics(分析)事件

在大多数情况下,您应该使用默认的 Google Analytics(分析)事件,这些事件已使用默认类别和标签进行了预先设置。使用这些事件有助于保证报告的一致性及与未来功能的互操作性。

下面的示例触发操作为“login”、类别为“engagement”和标签为“Google”的 Google Analytics(分析)事件:

gtag('event', 'login', { method : 'Google' });

下表列出了默认的 Google Analytics(分析)事件、相应默认类别和默认标签类型(如果提供)。对于未在此表中列出的事件名称(例如您创建的任意事件名称),默认类别为“engagement”,默认标签为“not set”。

事件名称 默认类别 默认标签类型
add_payment_info ecommerce  
add_to_cart ecommerce  
add_to_wishlist ecommerce  
begin_checkout ecommerce  
checkout_progress ecommerce  
generate_lead engagement  
login engagement method
purchase ecommerce  
refund ecommerce  
remove_from_cart ecommerce  
search engagement search_term
select_content engagement content_type
set_checkout_option ecommerce  
share engagement method
sign_up engagement method
view_item engagement  
view_item_list engagement  
view_promotion engagement  
view_search_results engagement search_term

发送非互动事件

要发送非互动事件,请将 non_interaction 参数设置为 true

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});