使用 Data Manager API 发送 Google Analytics 推荐事件和自定义事件。
如需了解详情，请参阅发送事件。
如果您要从 Google Analytics Measurement Protocol 升级，请参阅从 Measurement Protocol 升级到 Data Manager API，了解相关说明。
使用场景
以下是一些使用 Data Manager API 发送推荐事件和自定义事件的应用场景：
将线上和线下行为联系起来。
衡量客户端和服务器端的互动。
发送在标准用户互动之外发生的事件，例如线下转化。
发送来自无法使用自动收集功能的设备和应用（如自助服务终端、手表）的事件。
用户提供的数据
您可以在 Event 的 userData 字段中发送第一方客户数据，例如经过哈希处理的电子邮件地址、电话号码和实际地址。这有助于改进 Google Analytics 中的转化衡量、归因和受众群体构建。
发送用户提供的数据时，请注意以下几点：
随事件一起发送：在 Data Manager API 中，用户提供的数据必须作为
Event的一部分发送。不支持不含事件的独立上传。格式设置和哈希处理：个人标识符（例如电子邮件地址、电话号码、姓名和街道地址）必须先进行规范化处理，然后使用 SHA-256 算法进行哈希处理，才能上传。其他字段（例如城市、州/省/自治区/直辖市、邮政编码和国家/地区代码）会进行标准化处理，但不会进行哈希处理。如需了解具体要求，请参阅设置用户数据格式指南。
加密：您可以选择加密经过哈希处理的用户数据。
实现：如需有关如何构建请求的说明，请参阅添加用户提供的数据。
集成注意事项
使用 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 发送自定义事件。