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

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

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

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

工作流程概览

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

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

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

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

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

使用场景

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

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

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

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

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

用户提供的数据

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

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

  • 随事件一起发送：在 Data Manager API 中，用户提供的数据必须作为 Event 的一部分发送。不支持不含事件的独立上传。

  • 格式设置和哈希处理：在上传之前，必须使用 SHA-256 对个人标识符（例如邮箱、电话号码、姓名和街道地址）进行标准化和哈希处理。其他字段（例如城市、州或省、邮政编码和国家/地区代码）会进行标准化，但不会进行哈希处理。请遵循设置用户数据格式指南，了解具体要求。

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

  • User-ID：只要有可用的用户标识符，我们建议您同时提供 userId 和 userData。

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

集成注意事项

使用 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 发送自定义事件。

下一页
发送事件