Google Analytics 推荐事件和自定义事件

使用 Data Manager API 发送 Google Analytics 推荐事件和 自定义事件。

发送推荐事件和自定义事件

如果您要从 Google Analytics Measurement Protocol 升级，请参阅 从 Measurement Protocol 升级到 Data Manager API，了解相关 说明。

工作流程概览

如需使用 Data Manager API 发送事件数据，请完成以下步骤：

  1. 准备目标位置： 为注入请求的 Destination对象定义destinations 字段，以指定目标账号和转化 或事件目标位置。如需了解 详情，请参阅 准备目标位置。

  2. 准备事件数据和标识符： 使用事件详细信息和 必需的标识符（例如广告点击、客户端或应用实例 标识符）填充 Event 字段。如果您在 userData中添加了用户联系信息，请根据 格式设置指南对标识符进行标准化处理 和 SHA-256 哈希处理，并可选择对其进行 加密。如需了解详情，请参阅 准备事件数据。

  3. 构建并发送注入请求： 提交 events.ingest 请求，其中包含 destinations、Event 记录和 encryptionInfo（如果您加密了 userData）。在发送商品数据之前，请使用 validateOnly: true 测试有效负载是否存在 快速失败错误 。如需了解 字段要求和代码示例，请参阅发送事件。

  4. 检查诊断信息： 检索异步处理 诊断信息，并使用 requestStatus.retrieve验证注入状态。

使用场景

以下是使用 Data Manager API 发送推荐事件和自定义事件的一些使用场景：

  • 将线上和线下行为联系起来。

  • 衡量客户端和服务器端的互动。

  • 发送在标准用户互动之外发生的事件，例如线下转化。

  • 发送来自无法使用自动收集功能的设备和应用（如自助服务终端、手表）的事件。

用户提供的数据

您可以在 userData 字段中发送第一方客户数据，例如经过哈希处理的电子邮件地址、电话 号码和实际地址，在 Event 中。这有助于改进 Google Analytics 中的转化衡量、归因和受众群体构建。

发送用户提供的数据时，请注意以下几点：

  • 随事件一起发送：在 Data Manager API 中，用户提供的数据必须 作为 Event 的一部分发送。系统不支持在没有事件的情况下单独上传。

  • 格式设置和哈希处理：个人标识符（例如电子邮件地址、 电话号码、姓名和街道地址）必须先经过标准化处理和 SHA-256 哈希处理，然后才能上传。其他字段（例如城市、州/省份、邮政编码和国家/地区代码）会进行标准化处理，但不会进行哈希处理。如需了解具体要求，请参阅 用户数据格式指南 。

  • 加密：您可以选择 对经过哈希处理的用户数据进行加密。

  • 用户 ID：我们建议您在提供 userData 的同时提供 userId（如果用户标识符保持一致）。

  • 实现：如需了解如何构建请求，请参阅添加用户提供的数据。

集成注意事项

使用 Data Manager API 时，请注意以下事项。

再营销

如果您启用 Google 信号，Google Analytics 支持对同一设备进行再营销。如需进行 跨设备再营销，还需提供 userId。

此外，您还可以发送用户提供的数据以启用 第一方受众群体匹配。

广告标识符

Google Analytics 会自动使用 clientId 或 appInstanceId 将线上互动期间收集的广告标识符（例如 GBRAID 或 WBRAID） 与 Data Manager API 事件合并。

隐私设置

Google Analytics 会使用 clientId 或 appInstanceId 将 Data Manager API 事件与线上互动合并，以便采用 “非个性化广告”和“限制广告跟踪”等用户隐私设置。

您还可以使用 consent 对象直接在每个事件中指定用户同意设置。

地理位置和设备信息

Google Analytics 会自动使用 clientId 或 appInstanceId 将标记中的最新地理位置和设备信息 与 Data Manager API 事件合并。 这可确保您的 Data Manager API 事件反映在包含地理位置和设备维度的报告中。

如果您希望 Data Manager API 事件反映特定会话中的地理位置和设备信息 ，而不是 clientId或appInstanceId的最新信息，请在 additionalEventParameters中添加一个条目，并将parameterName设置为session_id，将 value设置为特定会话的 ID，并在会话开始后的 24 小时内发送该事件。

您可以使用 地理位置信息 和 设备信息 为事件 提供 Data Manager API。

完整服务器到服务器

虽然仅使用 Data Manager API 可以将事件发送到 Google Analytics，但这样可能只能查看报告的部分内容。Data Manager API 旨在扩充通过 gtag、跟踪代码管理器或 Firebase 收集的现有事件。某些事件名称和参数名称是 预留的，供通过 自动收集使用，无法通过 Data Manager API 发送。

生成或重命名事件

使用 Data Manager API 发送的事件不会触发用于 生成或重命名事件的规则。您的应用应实现与在 Google Analytics 界面中配置的规则类似的逻辑，以便通过 Data Manager API 发送自定义事件。

下一页
发送事件