版本说明

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

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 Ads 升级
    • 发送事件
• 新增了对将任何非预留事件的网站或应用事件发送到 Google Analytics 的支持。
  • 向 Event 资源添加了 app_instance_id 字段。
  • 向 DeviceInfo 添加了字段，以提供有关用户设备的元数据。
  • 向 AdIdentifiers 添加了 mobile_device_id 字段。
  • 向 Event 添加了 event_location 字段，以捕获 city、subdivision_code、region_code、subcontinent_code 和 continent_code 等字段。
  • 如需开始使用，请参阅以下指南：
    • 发送推荐事件和自定义事件
    • 从 Measurement Protocol 升级
    • 推荐事件参考文档
• 添加了对以下功能的支持：将包含交易 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

• 向 ErrorReason 枚举添加了 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED。

  为遵守《欧盟政治广告法规》(EU PAR)，Google 要求所有客户自行声明其广告是否根据 EU PAR 被视为政治广告。了解欧盟政治广告的定义以及 Google 针对欧盟政治广告的限制。

  自 2026 年 4 月 1 日起，如果账号缺少此声明，则可能会限制或禁止对该账号执行以下操作，并显示错误 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED。

  • UserListService（create、update 和 delete）
  • IngestionService （ingestAudienceMembers）

  如需解决此错误，广告客户必须在 Google Ads 界面中提供强制要求的声明。详细了解如何为您的账号确认。

• 向 ErrorReason 枚举添加了 INVALID_MERCHANT_ID。

2026-02-17 v1.5

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

• 添加了 UserList 资源和 UserListService，以允许创建、检索、更新和删除用户列表。
  • 请参阅 Google Ads 或 Display & Video 360 指南，了解如何使用 Data Manager API 创建、填充和验证“目标客户匹配”受众群体的端到端演示。
  • 如需了解迁移步骤，请参阅 Google Ads 或 Display & Video 360 升级指南。
• 新增了通过受众群体成员提取功能发送用户 ID 的支持，以便在 Google Ads 中与目标客户匹配功能搭配使用。
  • 已将 UserIdData 添加到 AudienceMember。
  • 向 RetrieveRequestStatus 方法返回的状态添加了 IngestUserIdDataStatus 和 RemoveUserIdDataStatus。您可以使用这些字段检索有关 User-ID 提取和移除的诊断信息。
• 添加了 PartnerLink 资源和 PartnerLinkService，用于创建和管理广告客户账号与数据合作伙伴账号之间的关联。
  • 如需了解使用入门，请参阅合作伙伴链接指南。

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 方法，这些方法使用以下数据类型：
  • 联系信息
  • 移动 ID
  • PAIR ID
• 只有至少有 1,000 名成员的受众群体才能通过 Data Manager API 进行管理，并符合定位条件。