Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

配置目标位置和标头

在使用 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 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 合作伙伴访问权限，其中凭据所对应的 Google 账号是 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 要么不设置 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` 标头。

以下示例展示了直接访问场景的 Destination，用于将数据发送给 Display & Video 360 合作伙伴：

注入

{
  "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 广告客户，并且您的凭据所对应的 Google 账号是该广告客户的父 Display & Video 360 合作伙伴账号中的用户，请执行以下操作：

注入

目的地

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` 标头。

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

注入

{
  "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 Ads 账号或数据合作伙伴账号中的用户所用的 Google 账号，以及账号之间的合作伙伴关联。

数据合作伙伴、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 的目的地，将数据发送到经理账号 M2、客户账号 C1 或客户账号 C2。

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

充当数据合作伙伴 D2

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

作为数据合作伙伴 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 与 Google Ads 客户 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` 标头。

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

注入

{
  "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` 标头。

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

注入

{
  "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 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 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 标头，则这是默认值。
- Google Ads 经理账号或 Display & Video 360 合作伙伴账号，是 IngestionService 请求中 operating_account 的父级账号，也是资源管理请求中目标账号的父级账号。
- 在 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 界面获取转化操作 ID，请执行以下操作：

前往 Google Ads 界面中的转化。
点击转化操作名称即可查看详情。

转化操作 ID 是名为 ctId 的网址查询参数的值。

  https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...

如需通过 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 Analytics

Floodlight

详细要求

账户字段

商品目的地 ID

Google Ads 受众群体

Google Ads 界面

Data Manager API

Google Ads 活动

Display & Video 360 受众群体

Display & Video 360 界面

Data Manager API

Google Analytics 事件

Floodlight 事件

配置目标位置和标头