感谢您预览 Google 的新代码文档!此网站为公开 Beta 版。(反馈

事件

Google 代码经过专门设计,让您能够对自己的网页和移动应用进行插桩,从而在某种事件发生时发送数据。此类数据可能包含与事件类型相关的信息,以及用于描述事件相关信息的参数。

什么是事件?

事件是指用户与您网站的组成部分进行互动。这些事件可能包括(但不限于):

  • 网页加载
  • 链接点击
  • 表单提交
  • 视频播放
  • 购买
  • 订阅
  • 应用安装

什么是参数?

参数是指与事件相关联的数据。参数示例包括:

  • 商品价值
  • 优惠券代码
  • 登录方法
  • 交易 ID
  • 币种

事件和参数不仅可为您提供有关客户偏好的更多信息,还可为您解疑答惑,例如:哪些产品页面获得的浏览次数最多?哪些按钮的点击频率更高?哪些广告系列促成了购买或订阅?

event 命令

全局网站代码的 event 命令用于发送事件数据。event 命令的原型如下所示:

gtag('event', '<type>', {<parameters>});

<type> 是事件类型,例如 Google Ads 转化事件或 Google Analytics(分析)4 事件名称。<parameters> 是名称/值对的对象,其中包含用于描述事件的数据。

跟踪代码管理器中的事件

跟踪代码管理器中的事件是根据正在使用的代码类型配置的。例如:

  • Google Ads 转化事件通过 Google Ads 转化跟踪代码发送。
  • Google Analytics(分析)4 中的事件通过 Google Analytics(分析):GA4 事件代码进行配置。
  • Universal Analytics 代码事件通过跟踪类型设置在 Google Analytics(分析):Universal Analytics 代码中进行配置。
  • Floodlight 事件通过 Floodlight 计数器Floodlight 销售代码进行配置。

跟踪代码管理器使用触发器指定要跟踪的事件,并监听您的网页或移动应用,看看相应事件是否会发生。如果事件发生,代码就会触发并将数据发送到指定产品。

Google Ads 转化事件衡量的是用户与广告互动后发生的活动。这些转化可以表示促成新订阅、购买或应用下载等操作的事件。在开始使用此代码之前,我们建议您先通过 Google Ads 帮助中心详细了解此功能的工作原理。

若要设置 Google Ads 转化跟踪代码,您需要输入必需的 Google Ads 转化 ID 和转化标签,以及可选的转化价值、货币代码和/或交易 ID。

gtag.js

对于全局网站代码植入,事件通过 gtag('event', 'conversion'...) 发送。例如:

  gtag('event', 'conversion', {
    'send_to': 'AW-CONVERSION_ID/CONVERSION_LABEL',
    'value': 1.0,
    'currency': 'USD',
    'transaction_id': '12345',
  });

跟踪代码管理器

  1. 在跟踪代码管理器中,创建新的 Google Ads 代码。在主屏幕中,依次选择新建代码 > 代码配置 > Google Ads 转化跟踪
  2. 登录您的 Google Ads 帐号,以收集用于完成代码设置的相应值:
    • 在您的 Google Ads 帐号中,点击工具和设置 (“工具与设置”图标) 菜单
    • 选择衡量:转化,系统将打开转化操作表格。
    • 转化操作列中选择要使用的转化的名称。
    • 展开“代码设置”标签页,以查看代码详细信息。
    • 选择使用 Google 跟踪代码管理器
    • 复制转化 ID转化标签
  3. 在跟踪代码管理器中,将在第 2 步中获取的必需的转化 ID转化标签值添加到相应的字段中。您还可以选择添加转化价值交易 ID货币代码。如果可以,请务必为这些字段值使用跟踪代码管理器变量。(例如,大多数情况下会为交易 ID 使用变量。)

  4. 在“触发条件”部分选择一个或多个触发器,指定代码应何时触发。

  5. 点击“保存”完成代码设置。

  6. 预览您所做的更改,并在准备就绪后发布

详细了解如何设置 Google Ads 转化。

Google Analytics(分析)4 事件

在 Google Analytics(分析)4 媒体资源中,每项可衡量的用户操作均会被视为事件。事件可以是网页加载、链接点击、表单填写、将商品添加到购物车、结账、页面滚动、视频观看、应用安装等等。Google Analytics(分析)4 事件支持自定义参数和用户属性,这使得 Google Analytics(分析)4 在如何衡量活动方面非常灵活。

Google 代码平台中表示的事件主要有三种类型。这些事件可能因产品而异,但通常可以归为以下几类:自动收集的事件、推荐事件和自定义事件。

  1. 自动收集的事件是指通过 gtag.js 或跟踪代码管理器代码发送的事件,无需您进行任何额外的插桩。自动收集的事件的常见示例包括 ad_clickpage_viewvideo_progress了解详情

  2. 推荐事件适用于常见的衡量场景,需要其他上下文才有意义。推荐事件的常见示例包括 loginpurchasesearch。由于推荐事件需要其他上下文,因此 Google 代码不会自动发送它们。了解详情

  3. 自定义事件是指您定义的事件。这些事件是尚未自动收集或推荐的事件。在实际操作时,您应尽可能试着使用自动收集的事件或推荐事件,并且仅在前面两种类型不符合您的要求时才使用自定义事件类型。了解详情

gtag.js

使用 gtag('event') 命令发送 Google Analytics(分析)4 事件:

gtag('event', '<event_name>', {<event_params>});

例如,您可以使用 gtag('event') 命令发送 generate_lead 事件:

gtag('event', 'generate_lead', {
  'value': '2',
  'currency': 'USD',
  'transaction_id': '1234'
});

跟踪代码管理器

若要在 Google 跟踪代码管理器中发送 Google Analytics(分析)4 事件,您需要以下两个组件:

  1. Google Analytics(分析):GA4 事件代码
  2. 可触发该代码的触发器

如需创建 Google Analytics(分析)4 事件代码,请参阅 Google Analytics(分析)4 事件代码帮助中心文档

Universal Analytics 事件

Universal Analytics 事件取决于旧版事件/类别/标签/价值模型。

gtag.js

请按照以下语法使用 gtag('event') 命令:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

以下命令发送了一个操作为 'Downloads'、类别为 'MP3'、标签为 `'Debussy - Clair de lune' 的事件:

gtag('event', 'Downloads', {
  'event_category' : 'MP3',
  'event_label' : 'Debussy - Clair de lune'
});

如果省略 <category><label>,它们将设置为默认值 (not set)

跟踪代码管理器

若要在 Google 跟踪代码管理器中发送 Universal Analytics 事件,您需要以下两个组件:

  1. Google Analytics(分析):Universal Analytics 代码
  2. 可触发该代码的触发器

如需了解详情,请参阅 Universal Analytics 代码帮助中心文档

Universal Analytics 事件信息的结构如下所示:

名称 类型 默认值 说明
<action> 字符串 将在 Google Analytics(分析)事件报告中显示为事件操作的值。
<category> 字符串 “(not set)” 事件的类别。
<label> 字符串 “(not set)” 事件的标签。
<value> 数值 将显示为事件价值的非负整数。

如需详细了解 Google Analytics(分析)如何解读事件结构,请参阅 Google Analytics(分析)事件参数剖析

Floodlight 活动

“Floodlight 活动”是指与您要衡量的特定事件相对应的转化,例如完成购买或访问网页。用户在看到您的某个广告后执行了操作,这就称为转化。了解详情

gtag.js

Floodlight 活动由全局网站代码通过 gtag('event', 'conversion') 发送。您应在定义 gtag() 函数后放置此代码,最好是放置在 <head> 部分,从而实现最佳性能。

数据字段作为 send_to 属性中的一系列参数发送。这些字段因代码类型、统计方法以及您要传递到代码中的其他数据而异。

以下是 Floodlight 转化活动示例:

  gtag('event', 'conversion', {
    'allow_custom_scripts': true,
    'u1': '[variable]', // custom Floodlight variable
    'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
  });

详细了解如何将全局网站代码用于 Floodlight 活动

跟踪代码管理器

Google 跟踪代码管理器可用于设置 Floodlight 活动。如需了解详情,请参阅帮助中心文档