配置目标位置和标头

在使用 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

如果您是数据合作伙伴，请参阅数据合作伙伴方案，了解如何设置标头和构建 Destination 以管理资源并将数据发送到与您的数据合作伙伴账号建立产品链接的账号：

Google Ads
Display & Video 360
Google Analytics

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

广告客户场景

下面介绍了如何为广告客户和代理机构的常见场景配置 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 广告客户，并且您的凭据对应的 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。

资源管理

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

数据合作伙伴方案

以下是针对数据合作伙伴的常见场景配置 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 与 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 广告客户，并且您与数据合作伙伴账号的产品关联是与 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 的广告客户方案方法。

详细要求

本部分详细介绍了 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 标头，则这是默认值。
- 在 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 界面获取转化操作 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。

确定凭据的访问范围

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

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

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

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 账号是否拥有相应媒体资源的“编辑者”或“管理员”角色。

设置用户数据的格式

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

何时使用目的地或标头

广告客户场景

Google Ads

直接访问方案

注入

资源管理

注入

资源管理

经理账号访问权限场景

注入

资源管理

注入

资源管理

注入

资源管理

Display & Video 360

直接访问方案

注入

资源管理

注入

资源管理

注入

资源管理

注入

资源管理

Display & Video 360 合作伙伴访问权限方案

注入

资源管理

注入

资源管理

Google Analytics

注入

资源管理

注入

资源管理

数据合作伙伴方案

Google Ads

直接商品链接方案

注入

资源管理

注入

资源管理

经理账号产品关联方案

注入

资源管理

注入

资源管理

Display & Video 360

直接商品链接使用场景

注入

资源管理

注入

资源管理

注入

资源管理

注入

资源管理

Display & Video 360 合作伙伴产品关联方案

注入

资源管理

注入

资源管理

Google Analytics

详细要求

账户字段

商品目的地 ID

Google Ads 受众群体

Google Ads 活动

Display & Video 360 受众群体

Google Analytics 事件

确定凭据的访问范围

Google Ads 或数据合作伙伴

Display & Video 360

Google Analytics

配置目标位置和标头