版本说明

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

2025-10-06 v1.3

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

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

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

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

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

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

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

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

2025-08-06 v1.2

  • 新增了对使用 IngestEvents 方法向 Google Ads 目标平台发送线下转化数据和增强型潜在客户转化数据的支持。如需了解如何为这些转化配置加密,请参阅更新后的加密指南
  • EventSource 枚举添加了 APPIN_STOREPHONEOTHER 值。线下转化和增强型潜在客户转化需要使用 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 AdsDisplay & Video 360
  • 添加了对 gRPCREST 的支持。
  • 添加了 IngestionService,其中包含用于管理观众成员的 IngestAudienceMembersRemoveAudienceMembers 方法,这些方法使用以下数据类型:
  • 只有至少有 1,000 名成员的受众群体才能通过 Data Manager API 进行管理,并符合定位条件。