版本说明

您可以在此处了解每个 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

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 名成员，才能用于定位。