版本说明

您可以在此处了解每个 Data Manager API 版本中的更改。

2026-07-30 v1.8

  • 向 IngestionService 添加了 RemoveAllAudienceMembers 方法，用于移除或替换指定用户名单的所有受众群体成员。
    • 如需开始操作，请查看有关从特定集成受众群体中移除所有成员的指南。例如，请参阅 Google Ads 或 Display & Video 360 的目标客户匹配指南。
  • 添加了对在事件和受众群体提取期间返回详细警告的支持。
    • 向 IngestEventsResponse 和 IngestAudienceMembersResponse 添加了 field_warnings 字段，该字段包含 FieldWarning 对象的列表。
    • 添加了 FieldWarning 资源，其中包含 reason（WarningReason）、description 和 field 路径。
    • 添加了 WarningReason 枚举，用于定义警告原因，例如未启用自定义变量或购物车数据中缺少商家 ID。
  • 新增了对发送其他地址字段的支持，以便 Google Analytics 提取事件。
    • 向 AddressInfo（在 UserData 中使用）添加了 address_line、city 和 administrative_area 字段。
  • 向 ErrorReason 枚举添加了 INVALID_REMOVE_AS_OF_TIME 和 REQUIRED_PREREQUISITE_LINK_MISSING 错误原因。

2026-05-28 v1.7

2026-05-07 v1.6

  • 新增了对使用 IngestEventsRequest 发送 Google Ads 实体店销售转化数据的支持。如需使用此功能，您的 Google Ads 账号必须满足某些资格要求。
    • 向 Event 添加了 event_location 字段，该字段支持提供实体 store_id.
    • 向 Event 添加了 third_party_user_data 字段，以便将提取的数据明确标记为归第三方所有。
    • 向 Item 资源添加了以下字段：
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables（接受 ItemCustomVariable 对象的列表）
    • 如需开始使用，请参阅以下指南：
  • 新增了对将任何非预留事件的网站或应用事件发送到 Google Analytics 的支持。
  • 添加了对以下功能的支持：将包含交易 ID 的任何事件作为附加数据源发送到网站和应用数据流，以用于代码或 Google Analytics for Firebase (GA4F) SDK 实现。
    • 此功能仅适用于列入许可名单的 Google Analytics 媒体资源；如果您有兴趣将自己的媒体资源添加到许可名单中，请填写此表单。
  • 向 CartData 添加了 coupon_codes 字段，以跟踪针对发送到 Google Ads 和 Google Analytics 的事件应用于购物车的所有优惠券代码。
    • 对于 Google Ads 中的优惠券兑换使用情形，请使用OFFLINE_PROMOTION_REDEMPTION转化类型。
  • 为与创建、搜索和删除合作伙伴链接相关的方法添加了新的 OAuth 范围 https://www.googleapis.com/auth/datamanager.partnerlink。
  • 向 ErrorReason 枚举添加了新值，以支持对实体店销售和 Google Analytics 事件提取进行详细验证。
  • 向 SizeInfo 资源添加了 youtube_members_count 和 gmail_members_count 字段。

2026-03-26

2026-02-17 v1.5

Data Manager API 现在支持管理受众群的整个端到端工作流程，包括受众群创建、提取和检索。

2026-02-10

现在，所有 Google Ads 账号都可以发送基于多个数据源的转化，以提升效果和数据质量。

此功能目前仍仅适用于已列入许可名单的 Google Analytics 媒体资源。 如果您有意将 Google Analytics 媒体资源添加到许可名单中，请填写此表单。

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 密钥管理服务 中的加密密钥。

  • 向 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

  • Data Manager 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

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