本页介绍如何使用 gtag.js 发送 Google Analytics(分析)事件。
发送事件
要在已添加 Google 代码的网页上发送 Google Analytics(分析)事件,请按照以下语法使用 gtag.js event
命令:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
<action> |
string |
将在 Google Analytics(分析)事件报告中显示为事件操作的值。 | |
<category> |
string |
"general" |
事件的类别。 |
<label> |
string |
事件的标签。 | |
<value> |
number |
将显示为事件价值的非负整数。 |
以下命令发送了一个操作为 'aaa'
、类别为 'bbb'
、标签为 'ccc'
的事件:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
如果省略 <category>
或 <label>
,它们将设置为默认值 "(not set)"
。
如需详细了解 Google Analytics(分析)如何解读事件结构,请参阅 Google Analytics(分析)事件参数剖析。
默认 Google Analytics(分析)事件
您应该使用默认的 Google Analytics(分析)事件,这些事件已预设类别和标签。使用这些事件有助于保证报告的一致性及与未来功能的互操作性。
下表列出了默认的 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
});