Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

配置目标位置和标头

在使用 Data Manager API 时，Destination 概念和请求标头经常出现。请阅读本指南，了解如何针对不同场景配置目标位置和标头。

何时使用目标或标头

在注入请求中使用 Destination。提取请求使用 IngestionService 在受众群体中添加或移除成员，或发送事件。IngestAudienceMembersRequest 或 IngestEventsRequest 中的 destinations 列表定义了：
1. 接收数据的账号。例如 Google Ads 账号或 Google Analytics 媒体资源
2. 账号中数据的目标实体，例如 Google Ads 转化操作或 Google Analytics 数据流。
3. 请求的凭据到接收数据的账号的访问路径。
您可以在同一提取请求中包含多个目标位置。

提示：请勿在 IngestionService 请求中设置请求标头。Data Manager API 会忽略提取请求中的标头。
在创建、更新、删除或检索资源的资源管理请求中使用请求标头。标头定义了请求凭据到资源管理请求的目标账号的访问路径。以下是具有支持请求标头的资源管理方法的资源列表：

例如，如果您想创建受众群体、向受众群体添加成员、检查诊断信息，然后检索受众群体以检查其规模，请参阅下表，其中列出了每个步骤、要使用的请求类型，以及您应该使用目标还是请求标头：

步骤	请求类型	目标或请求标头
创建受众群体	资源管理	请求标头
向受众群体添加成员	注入	目的地
查看诊断信息	注入	目的地
检索受众群体	资源管理	请求标头

点击每个表格周围的提取或资源管理标签页，即可在本指南中切换查看每种请求类型的详细信息。

如果您是广告客户或代理机构，请跳转到广告客户场景，查看有关如何设置标头和构建 Destination 的示例：

Google Ads
Display & Video 360
Google Analytics
Floodlight

如果您是数据合作伙伴，请跳转到数据合作伙伴场景，查看如何设置标头和构建 Destination 以管理资源并将数据发送到具有指向您的数据合作伙伴账号的合作伙伴链接的账号的示例：

Google Ads
Display & Video 360
Google Ad Manager
Google Analytics
Floodlight

详细要求部分深入介绍了相关要求和验证规则。

广告客户场景

以下介绍了如何针对广告客户和代理机构的常见场景配置 Destination 或请求标头。此图表展示了 Data Manager API 如何使用凭据和 Destination 字段访问广告客户账号。

广告客户访问路径

Google Ads

下图展示了一组 Google Ads 账号和用户的示例。

Google Ads 账号和用户

经理账号 M1

M1 有两个直接子账号：

经理账号 M2
客户账号 C1

Google 账号 cloudysanfrancisco@gmail.com 是 M1 中的用户。

经理账号 M2

M2 有两个直接子账号：

客户账号 C1
客户账号 C2

Google 账号 baklavainthebalkans@gmail.com 是 M2 中的用户。

客户账号 C1

C1 有两个直接父级经理账号：

经理账号 M1
经理账号 M2

Google 账号 jeffersonloveshiking@gmail.com 是 C1 中的用户。

客户账号 C2

经理账号 M2 是 C2 的唯一直接父级账号。

列出的 Google 账号都不是 C2 中的用户。

直接访问场景和经理访问场景展示了如何配置目标账号，以便向这些账号发送数据。

直接访问场景

如果您想将数据发送到 Google Ads 账号，并且您的凭证对应的是 Google Ads 账号中某个用户的 Google 账号，请执行以下操作：

注入

目的地

operating_account

`account_id`	Google Ads 账号的客户 ID
`account_type`	`GOOGLE_ADS`

login_account 请勿设置 login_account，或将其设置为与 operating_account 相同的值。

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下是直接访问场景的示例，其中使用了图表中的账号和 Google 账号 jeffersonloveshiking@gmail.com 的凭据：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

经理账号访问权限场景

如果您想将数据发送到 Google Ads 账号，并且您的凭证属于 Google 账号，而该 Google 账号是 Google Ads 经理账号中的用户，且广告客户账号是该经理账号的子账号：

注入

目的地

operating_account

`account_id`	Google Ads 客户账号的客户 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	Google Ads 经理账号的客户 ID
`account_type`	`GOOGLE_ADS`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了图表中 Google Ads 客户账号 C2 的经理访问权限场景，以及 Google 账号 baklavainthebalkans@gmail.com 的凭证：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

下面是另一个示例，展示了 Google Ads 客户账号 C2 的经理访问权限场景，以及 Google 账号 cloudysanfrancisco@gmail.com（Google Ads 经理账号 M1 的用户）的凭证：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

Display & Video 360

您可以通过以下两种方式将数据发送到 Display & Video 360：

直接访问：凭据对应的是 Display & Video 360 广告客户或合作伙伴账号中的用户 Google 账号。
Display & Video 360 合作伙伴访问权限，其中凭证适用于 Display & Video 360 合作伙伴账号中的用户 Google 账号，而操作账号是合作伙伴账号下的 Display & Video 360 广告客户账号。

直接访问场景

如果您想将数据发送到 Display & Video 360 广告客户账号，并且您的凭证属于广告客户账号中的用户 Google 账号，请执行以下操作：

注入

目的地

operating_account

`account_id`	Display & Video 360 广告客户账号的 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account 请勿设置 login_account，或将其设置为与 operating_account 相同的值。

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了在直接访问场景中，如何使用 Destination 将数据发送到 Display & Video 360 广告客户：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

同样，如果您想将数据发送到 Display & Video 360 合作伙伴账号，并且您的凭证对应的是合作伙伴账号中的用户 Google 账号，请执行以下操作：

注入

目的地

operating_account

`account_id`	Display & Video 360 合作伙伴账号的 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account 请勿设置 login_account，或将其设置为与 operating_account 相同的值。

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下是直接访问场景中用于向 Display & Video 360 合作伙伴发送数据的 Destination 示例：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

Display & Video 360 合作伙伴访问权限场景

如果您想将数据发送到 Display & Video 360 广告客户，并且您的凭证适用于该广告客户的父级 Display & Video 360 合作伙伴账号中的用户 Google 账号：

注入

目的地

operating_account

`account_id`	Display & Video 360 广告客户账号的 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	Display & Video 360 合作伙伴账号的 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下是合作伙伴访问场景的 Destination 示例，用于将数据发送到 Display & Video 360 广告客户。在这种情况下，凭证必须属于 Display & Video 360 合作伙伴账号 DISPLAY_VIDEO_PARTNER_ID 中的用户 Google 账号，并且 Display & Video 360 广告客户账号 DISPLAY_VIDEO_ADVERTISER_ID 必须是合作伙伴账号 DISPLAY_VIDEO_PARTNER_ID 的子账号。

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

Google Analytics

注意：如果 operating_account 是 Google Analytics 账号，则不要设置 login_account，或将其设置为与 operating_account 相同的值。否则，请求将失败并显示错误 OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH。

注入

目的地

operating_account

`account_id`	Google Analytics 媒体资源的 ID
`account_type`	`GOOGLE_ANALYTICS_PROPERTY`

login_account 请勿设置 login_account，或将其设置为与 operating_account 相同的值。

linked_account 请勿设置 linked_account 字段。

product_destination_id

网站数据流的衡量 ID。
应用数据流的 Firebase 应用 ID。

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下是用于向 Google Analytics 发送事件的 Destination 示例：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID`
`linked-account`	请勿设置 `linked-account` 标头。

Floodlight

注入

目的地

operating_account

`account_id`	Floodlight 配置 ID 如果您的广告客户是父级广告客户的子级，请使用 Campaign Manager 360 中父级广告客户的 ID 作为 Floodlight 配置 ID。否则，请使用广告客户的 ID。了解如何在 Campaign Manager 360 界面中查找广告客户 ID。
`account_type`	`FLOODLIGHT_CONFIG`

login_account 请勿设置 login_account，或将其设置为与 operating_account 相同的值。

linked_account 请勿设置 linked_account 字段。

product_destination_id Floodlight 活动 ID

以下是用于向 Floodlight 发送事件的 Destination 示例：

注入

        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

数据合作伙伴场景

以下是如何为常见场景配置 Destination 的示例，其中数据合作伙伴会将数据发送到与数据合作伙伴账号建立了合作伙伴关联的广告客户账号。

此图表展示了 Data Manager API 如何使用凭据和 Destination 字段通过合作伙伴链接访问广告客户账号。

数据合作伙伴访问路径

Google Ads

下图展示了一组 Google Ads 账号和数据合作伙伴账号的示例。该图还显示了哪个 Google 账号是每个 Google Ads 或数据合作伙伴账号中的用户，以及账号之间的合作伙伴关联。

数据合作伙伴和 Google Ads 账号及用户

数据合作伙伴 D1

D1 与 Google Ads 经理账号 M2 之间存在合作伙伴关联。

Google 账号 222larabrown@gmail.com 是 D1 中的用户。

数据合作伙伴 D2

D2 与 Google Ads 客户账号 C1 之间存在合作伙伴关联。

Google 账号 jeffersonloveshiking@gmail.com 是 D2 中的用户。

经理账号 M1

M1 有两个直接子账号：

经理账号 M2
客户账号 C1

经理账号 M2

M2 有两个直接子账号：

客户账号 C1
客户账号 C2

客户账号 C1

C1 有两个直接父级经理账号：

经理账号 M1
经理账号 M2

客户账号 C2

经理账号 M2 是 C2 的唯一直接父级账号。

您可以使用这组账号执行以下操作：

充当数据合作伙伴 D1

如需充当数据合作伙伴 D1，请使用 Google 账号 222larabrown@gmail.com 的凭据执行以下操作：

使用 login_account 设置为数据合作伙伴账号 D1 且 linked_account 设置为经理账号 M2 的目标，将数据发送到客户账号 C1 或客户账号 C2。
使用 login_account 设置为数据合作伙伴账号 D1 的目标账号，将数据直接发送到经理账号 M2。请勿设置 linked_account。

作为数据合作伙伴 D1，您无法向经理账号 M1 发送数据，因为 D1 和 M1 之间没有合作伙伴关联。

充当数据合作伙伴 D2

如需充当数据合作伙伴 D2，请使用 Google 账号 jeffersonloveshiking@gmail.com 的凭据，通过将 login_account 设置为数据合作伙伴账号 D2 的目标位置，将数据发送到客户账号 C1。请勿设置 linked_account。

作为数据合作伙伴 D2，您无法向经理账号 M1、经理账号 M2 或客户账号 C2 发送数据，因为 D2 与这些账号或其父级经理账号之间没有合作伙伴关联。

数据合作伙伴 D1 和 D2 之间的主要区别在于数据合作伙伴与 Google Ads 账号的关联方式。

数据合作伙伴 D1 与 Google Ads 经理账号相关联。这是经理合作伙伴关联场景的一个示例。
数据合作伙伴 D2 与 Google Ads 客户账号相关联。这是直接合作伙伴链接场景的一个示例。

直接合作伙伴链接场景

如果您想将数据发送到 Google Ads 账号，并且合作伙伴关联是在 Google Ads 账号与您的数据合作伙伴账号之间建立的，请执行以下操作：

注入

目的地

operating_account

`account_id`	Google Ads 账号的客户 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了使用图表中的账号的直接合作伙伴链接场景，以及资源管理请求的相应请求标头。在此场景中，数据合作伙伴 D2 使用 D2 与 C1 之间的合作伙伴关联以及 Google 账号 jeffersonloveshiking@gmail.com 的凭据，将受众群体成员数据发送到 Google Ads 客户顾客 C1：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

管理合作伙伴关联场景

如果您想将数据发送到 Google Ads 账号，并且合作伙伴关联是在 Google Ads 父级经理账号与您的数据合作伙伴账号之间建立的，请执行以下操作：

注入

目的地

operating_account

`account_id`	Google Ads 客户账号的客户 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	Google Ads 经理账号的客户 ID
`account_type`	`GOOGLE_ADS`

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	`accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID`

以下是使用图表中的账号建立经理合作伙伴关联的示例。在此场景中，数据合作伙伴 D1 使用 D1 与 M2 之间的合作伙伴关联以及 Google 账号 222larabrown@gmail.com 的凭证，将受众群体成员数据发送到 Google Ads 客户顾客 C2：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID`
`linked-account`	`accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID`

Display & Video 360

作为数据合作伙伴，您可以通过以下两种方式向 Display & Video 360 账号发送数据：

在数据合作伙伴账号与 Display & Video 360 合作伙伴或广告客户账号之间建立直接合作伙伴关联。
使用数据合作伙伴账号与广告客户的父级 Display & Video 360 合作伙伴账号之间的合作伙伴关联，将数据发送给 Display & Video 360 广告客户。

直接合作伙伴关联场景

如果您想将数据发送到 Display & Video 360 广告客户，并且合作伙伴关联是在 Display & Video 360 广告客户账号与您的数据合作伙伴账号之间建立的：

注入

目的地

operating_account

`account_id`	Display & Video 360 广告客户账号的 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了在直接合作伙伴关联场景中，用于向 Display & Video 360 广告客户发送数据的 Destination，以及资源管理请求的相应请求标头：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

如果您想将数据发送到 Display & Video 360 合作伙伴账号，则必须在 Display & Video 360 合作伙伴账号与您的数据合作伙伴账号之间建立合作伙伴关联。

注入

目的地

operating_account

`account_id`	Display & Video 360 合作伙伴账号的 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了在直接合作伙伴关联场景中，向 Display & Video 360 合作伙伴发送数据的 Destination，以及资源管理请求的相应请求标头：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

父级合作伙伴关联场景

如果您想将数据发送到 Display & Video 360 广告客户，并且与您的数据合作伙伴账号建立合作伙伴关联的 Display & Video 360 合作伙伴账号是该广告客户账号的子账号，请执行以下操作：

注入

目的地

operating_account

`account_id`	Display & Video 360 广告客户账号的 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	Display & Video 360 合作伙伴账号的 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

product_destination_id 受众群体或转化操作的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`

以下是合作伙伴关联场景的 Destination 示例，该场景使用数据合作伙伴与广告客户的父级 Display & Video 360 合作伙伴之间的合作伙伴关联，将数据发送到 Display & Video 360 广告客户：

注入

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	`accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID`

Google Ad Manager

如果您想将数据发送到 Google Ad Manager 账号，并且您的数据合作伙伴账号与 Google Ad Manager 账号之间存在合作伙伴关联：

注入

目的地

operating_account

`account_id`	Google Ad Manager 账号的受众群体关联 ID
`account_type`	`GOOGLE_AD_MANAGER_AUDIENCE_LINK`

login_account

`account_id`	数据合作伙伴账号的客户 ID
`account_type`	`DATA_PARTNER`

linked_account 请勿设置 linked_account 字段。

product_destination_id 受众群体的 ID。

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

以下示例展示了如何使用合作伙伴链接将数据发送到 Google Ad Manager 账号：Destination

注入

      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }

资源管理

请求标头
`login-account`	`accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID`
`linked-account`	请勿设置 `linked-account` 标头。

Google Analytics

Data Manager API 不支持使用合作伙伴链接将数据发送到 Google Analytics 账号。请改用 Google Analytics 的广告客户场景方法。

Floodlight

Data Manager API 不支持使用合作伙伴链接将数据发送到 Floodlight 配置。请改用适用于 Floodlight 的广告客户场景方法。

详细要求

本部分详细介绍了 IngestionService 请求的 Destination 账号字段的要求、资源管理请求的等效请求标头、如何设置 product_destination_id 的提示，以及如何确定您的凭据有权访问的位置。

账户字段

一个Destination最多可以有 3 个不同的账号：

operating_account

operating_account为必填项。

operating_account 表示哪个账号会接收请求中的数据。operating_account 可以是以下任意一项：

Google Ads 账号
Display & Video 360 广告客户账号
Display & Video 360 合作伙伴账号
Google Ad Manager 账号
Google Analytics 媒体资源
如果将数据发送到数据合作伙伴账号拥有的受众群体，则需要数据合作伙伴账号。

没有与 Destination 的 operating_account 字段对应的请求标头。发送资源管理请求时，请求的目标账号即为操作账号。

login_account 个字段和 login-account 个请求标头

login_account 并非始终是必需的，在 IngestionService 请求中默认为 operating_account，在资源管理请求中默认为目标账号。在资源管理请求中，使用 login-account 请求标头来标识登录账号。

Data Manager API 会验证：

凭据的 Google 账号是登录账号中的用户。
登录账号是以下账号之一：
- 与 operating_account 相同。如果您未在 IngestionService 请求中设置 Destination 的 login_account，或未在资源管理请求中设置 login-account 标头，则这是默认设置。
- IngestionService 请求中 operating_account 的父级 Google Ads 经理或 Display & Video 360 合作伙伴账号，或资源管理请求中目标账号的父级账号。
- 在 IngestionService 请求中具有指向 linked_account 的合作伙伴链接的数据合作伙伴账号，或资源管理请求中的 linked-account 标头。

linked_account 个字段和 linked-account 个请求标头

linked_account 指示哪个账号与 IngestionService 请求的 login_account 具有合作伙伴关联，或指示资源管理请求的目标账号。

商品目标平台 ID

Destination 的 product_destination_id 用于标识 operating_account 中的哪个对象接收数据。例如，这可以是 Google Ads 或 Display & Video 360 的受众群体 ID、Google Ads 的转化操作 ID，或 Google Analytics 数据流的衡量 ID。

以下是查找每种商品目标平台 ID 的方法。

Google Ads 受众群体

用于提取受众群体成员的产品目标 ID 是受众群体 ID。您可以使用 Google Ads 界面或 Data Manager API 检索此 ID。

Google Ads 界面

如需从 Google Ads 界面获取受众群体 ID，请执行以下操作：

在 Google Ads 界面中，前往受众群体管理器。
点击受众群体名称即可查看详情。
受众群体 ID 会列在名单 ID 旁边。

Data Manager API

使用 List 方法检索 UserList，根据需要提供请求标头，并将 UserList 的 id 用作商品目标 ID。

Google Ads 事件

用于提取事件的产品目标 ID 是转化操作 ID。您可以使用 Google Ads 界面或 Google Ads API 检索此 ID。

Google Ads 界面

如需从 Google Ads 界面中获取转化操作 ID，请执行以下操作：

前往 Google Ads 界面中的转化。
点击转化操作名称。
点击详细信息标签页。
转化操作 ID 是转化类型 ID 旁边的数字。

Google Ads API

如需从 Google Ads API 获取转化操作 ID，请执行以下操作：

使用以下查询向 GoogleAdsService 发送 Search 或 SearchStream 请求：

  SELECT
    conversion_action.id,
    conversion_action.name
  FROM conversion_action
  WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

从响应中 conversion_action 的 id 字段获取转化操作 ID。

  [
    {
      "results": [
        {
          "conversionAction": {
            "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
            "id": "CONVERSION_ACTION_ID",
            "name": "CONVERSION_ACTION_NAME"
          }
        }
      ]
    }
  ]

Display & Video 360 受众群体

用于提取受众群体成员的产品目标 ID 是受众群体 ID。您可以使用 Display & Video 360 界面或 Data Manager API 检索此 ID。

Display & Video 360 界面

如需从 Display & Video 360 界面获取受众群体 ID，请执行以下操作：

登录 Display & Video 360 界面，网址为 https://displayvideo.google.com。
前往您要用于 operating_account 的 Display & Video 360 合作伙伴或广告客户。
前往左侧菜单中的受众群体，然后选择所有受众群体。
在列表中找到相应受众群体。受众群体 ID 是名称列中名称旁边的数字。

Data Manager API

使用 List 方法检索 UserList，根据需要提供请求标头，并将 UserList 的 id 用作商品目标 ID。

Google Analytics 事件

产品目标 ID 取决于数据流的类型。

网站数据流

使用数据流的衡量 ID。

应用数据流

使用数据流的 Firebase 应用 ID。您可以通过以下两种方法查找 Firebase 应用 ID：

在 Google Analytics 界面中，前往数据流，点击相应数据流，然后查找 FIREBASE 应用 ID。
使用 Firebase 控制台。

Floodlight 事件

用于将事件提取到 Floodlight 的产品目标 ID 是 Floodlight 活动 ID。使用 Campaign Manager 360 界面或 Campaign Manager 360 API 检索此 ID。

Campaign Manager 360 界面

如需从 Campaign Manager 360 界面获取 Floodlight 活动 ID，请执行以下操作：

登录 Campaign Manager 360 界面。
前往您要用于 operating_account 的 Campaign Manager 360 广告客户。
前往左侧菜单中的 Floodlight，然后选择活动。
在列表中找到相应的 Floodlight 活动。该 ID 是活动名称列中名称旁边的数字。

Campaign Manager 360 API

如需通过 Campaign Manager 360 API 获取 Floodlight 活动 ID，请执行以下操作：

向 floodlightActivities 资源发送 list 请求。
指定 Floodlight 配置的 floodlightConfigurationId。
（可选）使用 searchString 参数按活动名称进行过滤。
从响应中所选 FloodlightActivity 的 id 字段中获取 Floodlight 活动 ID。

确定凭证有权访问的位置

您用于为 Data Manager API 请求授权的凭证与特定 Google 账号相关联。

如果您使用用户凭据，则系统会以在您生成凭据时授权代表其执行操作的用户的 Google 账号身份对请求进行授权。
如果您使用服务账号凭证，则请求会以服务账号的 Google 账号身份获得授权。

以下方法可验证您的凭据所对应的 Google 账号是否有权访问 Google Ads、Display & Video 360、Google Analytics 或 Campaign Manager 360 账号。

Google Ads 或数据合作伙伴

在 Google Ads 界面中，前往 login_account 的访问权限和安全。
选择用户标签。
如果 login_account 是 Google Ads 经理账号，请关闭显示整个层次结构中的用户切换开关，以隐藏子账号中的用户。
验证您的凭据对应的 Google 账号是否在用户标签页上显示的账号列表中。

Display & Video 360

前往 Display & Video 360 界面中的用户管理和邮件接收设置。
验证用户管理是否显示您的凭据的 Google 账号是 login_account 上的用户。

Google Analytics

在 Google Analytics 界面中，前往媒体资源访问管理。
确认已选择 login_account 中指定的 Google Analytics 媒体资源。
验证您的凭据对应的 Google 账号是否对媒体资源拥有“编辑者”或“管理员”角色。

Floodlight (Campaign Manager 360)

登录 Campaign Manager 360 界面。
在左侧菜单中，依次前往管理 > 用户个人资料。
验证您的凭据对应的 Google 账号是否在显示的个人资料列表中。
点击该配置文件，并验证其是否有权访问用作 login_account 的广告客户账号。如果您未在请求中设置 login_account，则默认为 operating_account。确保该账号具有包含插入线下转化权限的用户角色。

设置用户数据的格式

配置目标位置和标头 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

何时使用目标或标头

广告客户场景

Google Ads

直接访问场景

注入

资源管理

注入

资源管理

经理账号访问权限场景

注入

资源管理

注入

资源管理

注入

资源管理

Display & Video 360

直接访问场景

注入

资源管理

注入

资源管理

注入

资源管理

注入

资源管理

Display & Video 360 合作伙伴访问权限场景

注入

资源管理

注入

资源管理

Google Analytics

注入

资源管理

注入

资源管理

Floodlight

注入

注入

数据合作伙伴场景

Google Ads

直接合作伙伴链接场景

注入

资源管理

注入

资源管理

管理合作伙伴关联场景

注入

资源管理

注入

资源管理

Display & Video 360

直接合作伙伴关联场景

注入

资源管理

注入

资源管理

注入

资源管理

注入

资源管理

父级合作伙伴关联场景

注入

资源管理

注入

资源管理

Google Ad Manager

注入

资源管理

注入

资源管理

Google Analytics

Floodlight

详细要求

账户字段

商品目标平台 ID

Google Ads 受众群体

Google Ads 界面

Data Manager API

Google Ads 事件

配置目标位置和标头