版本说明

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

2026-05-28 v1.7

• 添加了对 使用 向 Google Marketing Platform 产品（包括 Campaign Manager 360、 Search Ads 360 和 Display & Video 360）发送线下转化事件的支持 IngestEventsRequest。

  • 将 FLOODLIGHT_CONFIG 添加到 AccountType 枚举，以支持 Floodlight 目标。
  • 将 dclid、impression_id、match_id 和 encrypted_user_ids 字段添加到 AdIdentifiers。
  • 将 conversion_count 字段添加到 Event 资源，以 支持跟踪转化数量。

  如需开始使用，请参阅发送事件指南，或了解如何从 Campaign Manager 360 API升级。

• 将 composite_data 字段添加到 AudienceMember 资源，该字段接受 CompositeData 对象，让您可以 组合多种类型的标识符，例如 UserData 和 IpData。如需了解详情，请参阅复合 数据。

  • 添加了新状态 IngestCompositeDataStatus和 RemoveCompositeDataStatus ，其中包含 使用CompositeData的受众群体成员请求的诊断信息（record_count和data_type_counts）。

• 添加了对通过在复合数据中发送 IpData 来接收 Google Ads 目标客户 匹配 的 IP 地址的支持。

• 将新错误原因 FIELD_VALUE_TOO_SHORT、TOO_FEW_ELEMENTS、 BASELINE_LOCATION_AUTO_DETECTION_FAILED 和 INSIGHTS_MISSING_FOR_DIMENSION 添加到 ErrorReason 枚举。

• 向 ProcessingErrorReason添加了新的诊断值，以便为事件接收期间的失败提供更精细的反馈。

2026-05-07 v1.6

• 添加了对使用 IngestEventsRequest 发送 Google Ads 实体店销售转化 的支持。如需使用 此功能，您的 Google Ads 账号必须满足某些 资格 条件。
  • 将 event_location 字段添加到 Event，该字段支持 提供实体 store_id.
  • 将 third_party_user_data 字段添加到 Event，允许将接收的数据明确标记为归第三方所有。
    • 只有 数据 合作伙伴 才能填充此字段。
  • 将以下字段添加到 Item 资源：
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables（接受 ItemCustomVariable 对象列表）
  • 如需开始使用，请参阅以下指南：
    • 从 Google Ads 升级
    • 发送事件
• 添加了对向 Google Analytics 发送任何非预留 事件的网站或应用事件的支持。
  • 将 app_instance_id 字段添加到 Event 资源。
  • 将字段添加到 DeviceInfo，以提供 有关用户设备的元数据。
  • 将 mobile_device_id 字段添加到 AdIdentifiers。
  • 将 event_location 字段添加到 Event 以捕获 city、subdivision_code、region_code、 subcontinent_code 和 continent_code 等字段。
  • 如需开始使用，请参阅以下指南：
    • 发送推荐事件和自定义事件
    • 从 Measurement Protocol 升级
    • 推荐事件参考
• 添加了对将 任何包含交易 ID 的事件作为额外的网站和应用数据流 数据源发送的支持，以便用于您的代码或 Google Analytics for Firebase (GA4F) SDK 实现。
  • 此功能仅限于已列入许可名单的 Google Analytics 媒体资源； 如果您有意将您的媒体资源添加到许可名单，请填写此表单。
• 将 coupon_codes 字段添加到 CartData 以 跟踪发送到 Google Ads 和 Google Analytics 的事件的所有应用于购物车的优惠券代码。
  • 对于 Google Ads 中的优惠券兑换用例，请使用 OFFLINE_PROMOTION_REDEMPTION 转化类型。
• 添加了一个新的 OAuth 范围 https://www.googleapis.com/auth/datamanager.partnerlink，用于与创建、搜索和删除合作伙伴关联相关的方法。
• 向 ErrorReason 枚举添加了新值，以 支持对实体店销售和 Google Analytics 事件 接收进行详细验证。
• 将 youtube_members_count 和 gmail_members_count 字段添加到 SizeInfo 资源。

2026-03-26

• 将 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED 添加到 ErrorReason 枚举。

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

  自 2026 年 4 月 1 日 起，对于缺少 此声明的账号，以下操作可能会受到限制或失败，并显示错误 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED。

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

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

• 将 INVALID_MERCHANT_ID 添加到 ErrorReason 枚举。

2026-02-17 v1.5

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

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

2026-02-10

现在，所有 Google Ads 账号都可以使用基于多个数据源的转化跟踪，以提升效果和数据强度。

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

2025-11-05 v1.4

• 添加了对将 Google Analytics purchase 事件作为代码转化的额外数据源发送的支持，以最大限度地提高广告互动信号，并增强您的数据和整体效果。

  • 将 GOOGLE_ANALYTICS_PROPERTY 添加到 AccountType 枚举。
  • 将多个字段添加到 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 名成员，就有资格用于定位。以前，成员人数阈值为 1000 名成员。

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

2025-08-06 v1.2

• 添加了对使用 IngestEvents 方法向 Google Ads 目标发送线下转化和增强型潜在客户转化 潜在客户的支持。如需了解如何为这些转化配置 加密，请参阅更新后的 加密指南。
• 将 APP、IN_STORE、PHONE 和 OTHER 值添加到 EventSource 枚举。线下转化和增强型潜在客户转化需要 event_source。
• 将 user_properties 字段添加到 Event。将此 字段设置为 UserProperties 对象，以便在事件发生时添加 广告客户评估的 用户信息。
• 将 destination_references 重复字段添加到 CustomVariable。使用此字段可仅将自定义变量值应用于 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

• 将 IngestEvents 方法添加到 IngestionService。将 IngestEvents 用作代码转化的额外数据 源，以最大限度地提高广告互动信号，并增强您的数据和整体效果。

2025-04-02 v1.0

• Data Manager API 的第一个版本，支持向 Google Ads 和 Display & Video 360 发送受众群体数据。
• 添加了对 gRPC 和 REST 的支持。
• 添加了 IngestionService，其中包含 IngestAudienceMembers 和 RemoveAudienceMembers 方法，用于使用以下数据类型管理 受众群体成员：
  • 联系信息
  • 移动 ID
  • PAIR ID
• 使用 Data Manager API 管理的受众群体只有在至少有 1000 名成员时才有资格用于定位。