版本说明

您可以在此处了解每个数据管理器 API 版本中的变化。

2025-11-05 v1.4

  • 新增了对发送 Google Analytics purchase 事件的支持，可将其作为代码转化数据的额外数据源，从而最大限度地提高广告互动信号，并增强数据和整体效果。

    • 向 AccountType 枚举添加了 GOOGLE_ANALYTICS_PROPERTY。
    • 向 Event 添加了多个字段：
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • 已将 additional_user_properties 添加到 UserProperties。

    如需详细了解如何发送 Google Analytics purchase 事件，以及如何将 Google Analytics 事件参数和用户属性映射到其 Data Manager API 等效项，请参阅事件指南。

  • 添加了 AwsWrappedKeyInfo 以支持使用 AWS Key Management Service 中的加密密钥。

  • 向 ErrorReason 添加了以下枚举值：

    • EVENT_TIME_INVALID
    • FIELD_VALUE_TOO_LONG
    • INVALID_EVENT_NAME
    • INVALID_PROPERTY_TYPE
    • INVALID_REQUEST_ID
    • INVALID_STREAM_TYPE
    • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
    • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
    • NOT_ALLOWLISTED
    • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
    • RESERVED_NAME_USED
    • TOO_MANY_ELEMENTS
    • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
    • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

  • 数据管理器 API 现已面向所有用户正式发布。

    目前，只有列入许可名单的账号才能发送使用多个数据源的转化，以提升效果和数据质量。如果您有兴趣添加账号，请填写表单。

    填写合作伙伴意向表单，表明您有意成为数据合作伙伴。

  • 添加了 RetrieveRequestStatus 方法，用于检索事件和受众群体提取请求的诊断信息。

  • ProductAccount 的 product 字段和 Product 枚举已被弃用。请改用 account_type 字段和新的 AccountType 枚举。

  • 添加了对在 IngestAudienceMembersRequest 中为每个 AudienceMember 指定 destination 的支持。您可以使用此功能，通过单个请求将受众群体数据发送到多个不同的目标位置。

  • 通过 API 提取的受众群体现在只要至少有 100 名成员，就可以用于定位。之前，会员人数门槛为 1, 000 名会员。

  • 现在，发送线下转化数据或增强型潜在客户转化数据时，Event的 transaction_id 为可选字段。将线下转化作为额外的数据源发送以提升效果和数据强度时，仍需要 transaction_id。

2025-08-06 v1.2

  • 新增了对使用 IngestEvents 方法向 Google Ads 目标平台发送线下转化数据和增强型潜在客户转化数据的支持。如需了解如何为这些转化配置加密，请参阅更新后的加密指南。
  • 向 EventSource 枚举添加了 APP、IN_STORE、PHONE 和 OTHER 值。线下转化和增强型潜在客户转化需要使用 event_source。
  • 向 Event 添加了 user_properties 字段。将此字段设置为 UserProperties 对象，以在发生相应事件时添加有关用户的广告客户评估信息。
  • 向 CustomVariable 添加了 destination_references 重复字段。使用此字段可仅将自定义变量值应用于 Event 的部分目的地。
  • 针对线下转化和增强型潜在客户转化添加了以下错误：
    • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
    • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
    • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

  • 向 IngestionService 添加了 IngestEvents 方法。使用 IngestEvents 作为代码转化的额外数据源，以最大限度地提高广告互动信号，并增强数据和整体效果。

2025-04-02 v1.0

  • 首次发布数据管理器 API，支持将受众群体数据发送到 Google Ads 和 Display & Video 360。
  • 添加了对 gRPC 和 REST 的支持。
  • 添加了 IngestionService，其中包含用于管理受众群体的 IngestAudienceMembers 和 RemoveAudienceMembers 方法，这些方法使用以下数据类型：
  • 只有至少有 1,000 名成员的受众群体才能通过 Data Manager API 进行管理，并符合定位条件。