您可以在此处了解每个数据管理器 API 版本中的变化。
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 进行管理,并符合定位条件。