Настройте адреса назначения и заголовки.

Как концепция Destination , так и заголовки запроса часто встречаются при работе с API Data Manager. Прочитайте это руководство, чтобы понять, как настроить назначения и заголовки для различных сценариев.

Когда использовать адреса назначения или заголовки

• Используйте Destination в запросах на прием данных . Запрос на прием данных использует IngestionService для добавления или удаления участников в аудитории или отправки событий. Список destinations в IngestAudienceMembersRequest или IngestEventsRequest определяет:

  1. Аккаунт, получающий данные. Например, аккаунт Google Ads или ресурс Google Analytics.
  2. Объект назначения для данных в рамках аккаунта, например, действие конверсии в Google Ads или поток данных Google Analytics.
  3. Путь доступа к учетным данным запроса для учетной записи, получающей данные.

  В одном запросе на загрузку можно указать несколько пунктов назначения.

  Совет: Не устанавливайте заголовки запроса в запросе IngestionService . API Data Manager игнорирует заголовки в запросе на прием данных.

• Используйте заголовки запросов в запросах на управление ресурсами , которые создают, обновляют, удаляют или извлекают ресурсы. Заголовки определяют путь доступа к учетным данным запроса для целевой учетной записи запроса на управление ресурсами. Вот список ресурсов с методами управления ресурсами, поддерживающими заголовки запросов:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

Например, если вы хотите создать аудиторию, добавить в нее участников, проверить диагностику, а затем получить данные об аудитории, чтобы проверить ее размер, вот каждый шаг, тип используемого запроса и следует ли использовать целевые объекты или заголовки запроса:

Шаг	Тип запроса	Заголовки назначения или запроса
Создайте аудиторию	Управление ресурсами	Заголовки запроса
Добавить участников в аудиторию	Приём внутрь	Направления
Проверьте диагностику	Приём внутрь	Направления
Возвращение аудитории	Управление ресурсами	Заголовки запроса

Для переключения между подробными сведениями в этом руководстве для каждого типа запроса щелкните вкладку «Прием данных» или «Управление ресурсами» рядом с каждой таблицей.

Если вы рекламодатель или агентство , перейдите к разделу «Сценарии для рекламодателей» , где приведены примеры того, как устанавливать заголовки и создавать Destination :

• Google Реклама
• Дисплей и видео 360
• Google Аналитика

Если вы являетесь партнером по данным , перейдите к разделу «Сценарии для партнеров по данным» , где приведены примеры того, как устанавливать заголовки и создавать Destination для управления ресурсами и отправки данных в учетную запись, связанную с продуктом вашей учетной записи партнера по данным:

• Google Реклама
• Дисплей и видео 360
• Google Аналитика

В разделе «Подробные требования» подробно описаны требования и правила проверки.

Сценарии для рекламодателей

Вот как настроить Destination или заголовки запроса для распространенных сценариев использования рекламодателями и агентствами. На этой диаграмме показано, как API Data Manager использует учетные данные и поля Destination для доступа к учетной записи рекламодателя.

Google Реклама

Вот диаграмма, демонстрирующая пример набора аккаунтов и пользователей Google Ads.

Управляющий счет M1

У M1 есть два прямых дочерних счета:

1. Управляющий аккаунт M2
2. Клиентский счет C1

Пользователь Google с ником [e-mail] зарегистрирован в M1.

Управляющий аккаунт M2

У M2 есть два прямых дочерних счета:

1. Клиентский счет C1
2. Клиентский аккаунт C2

Аккаунт Google [e-mail] является пользователем в M2.

Клиентский счет C1

У C1 есть два прямых родительских аккаунта для управления:

1. Управляющий счет M1
2. Управляющий аккаунт M2

Пользователь Google с ником [e-mail] находится в C1.

Клиентский аккаунт C2

Управляющий счет M2 является единственным непосредственным родительским счетом для счета C2.

Ни один из перечисленных аккаунтов Google не является пользователем в C2.

Сценарии прямого доступа и доступа менеджера показывают, как настроить место назначения для отправки данных в эти учетные записи.

сценарий прямого доступа

Если вы хотите отправить данные в аккаунт Google Ads, и ваши учетные данные относятся к аккаунту Google, который является пользователем этого аккаунта Google Ads:

Приём внутрь

Место назначения
operating_account	account_id Идентификатор клиента аккаунта Google Ads account_type GOOGLE_ADS
login_account	Либо не задавайте login_account , либо установите для него те же значения, что и для operating_account .
linked_account	Не задавайте значение поля linked_account .
product_destination_id	Идентификатор аудитории или действия конверсии.

Управление ресурсами

Заголовки запроса
login-account	accountTypes/GOOGLE_ADS/accounts/ GOOGLE_ADS_CUSTOMER_ID
linked-account	Не устанавливайте заголовок linked-account .

Вот пример сценария прямого доступа с использованием учетных записей из схемы и учетных данных для аккаунта Google [e-mail] :

Приём внутрь

{
  "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 Ads Manager, где аккаунт рекламодателя является дочерним аккаунтом:

Приём внутрь

Место назначения
operating_account	account_id Идентификатор клиента аккаунта Google Ads account_type GOOGLE_ADS
login_account	account_id Идентификатор клиента аккаунта Google Ads Manager. account_type GOOGLE_ADS
linked_account	Не задавайте значение поля linked_account .
product_destination_id	Идентификатор аудитории или действия конверсии.

Управление ресурсами

Заголовки запроса
login-account	accountTypes/GOOGLE_ADS/accounts/ MANAGER_CUSTOMER_ID
linked-account	Не устанавливайте заголовок linked-account .

Вот пример сценария доступа администратора к клиентскому аккаунту C2 Google Ads из схемы , а также учетные данные для аккаунта Google [e-mail] :

Приём внутрь

{
  "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 .

Вот ещё один пример сценария доступа к учетной записи C2 клиента Google Ads и учетных данных для аккаунта Google [e-mail] , который является пользователем учетной записи M1 менеджера Google Ads:

Приём внутрь

{
  "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 .

Дисплей и видео 360

Передавать данные на Display & Video 360 можно двумя способами:

1. Прямой доступ, при котором используются учетные данные аккаунта Google, принадлежащего пользователю рекламного или партнерского аккаунта Display & Video 360.
2. Доступ для партнеров Display & Video 360, где учетные данные относятся к учетной записи Google, являющейся пользователем партнерской учетной записи Display & Video 360, а операционная учетная запись — это рекламная учетная запись Display & Video 360 в рамках партнерской учетной записи.

Сценарии прямого доступа

Если вы хотите отправить данные в рекламный аккаунт Display & Video 360, и ваши учетные данные относятся к учетной записи Google, которая является пользователем в этом рекламном аккаунте:

Приём внутрь

Место назначения
operating_account	account_id Идентификатор рекламного аккаунта Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	Либо не задавайте login_account , либо установите для него те же значения, что и для operating_account .
linked_account	Не задавайте значение поля linked_account .
product_destination_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 account_type DISPLAY_VIDEO_PARTNER
login_account	Либо не задавайте login_account , либо установите для него те же значения, что и для operating_account .
linked_account	Не задавайте значение поля linked_account .
product_destination_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 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Идентификатор партнерского аккаунта Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
linked_account	Не задавайте значение поля linked_account .
product_destination_id	Идентификатор аудитории.

Управление ресурсами

Заголовки запроса
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/ DISPLAY_VIDEO_PARTNER_ID
linked-account	Не устанавливайте заголовок linked-account .

Вот пример Destination для сценария доступа партнера для отправки данных рекламодателю Display & Video 360. В этом сценарии учетные данные должны принадлежать учетной записи Google, которая является пользователем в партнерской учетной записи Display & Video 360 DISPLAY_VIDEO_PARTNER_ID , а учетная запись рекламодателя 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 Аналитика

Примечание: Если operating_account — это учетная запись Google Analytics, то либо не задавайте login_account , либо задайте ему те же значения, что и operating_account . В противном случае запрос завершится с ошибкой OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH .

Приём внутрь

Место назначения
operating_account	account_id Идентификатор ресурса Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	Либо не задавайте login_account , либо установите для него те же значения, что и для operating_account .
linked_account	Не задавайте значение поля linked_account .
product_destination_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 .

Сценарии взаимодействия с партнерами по данным

Вот как настроить Destination для распространенных сценариев, когда партнер по данным отправляет данные в рекламные аккаунты, имеющие установленную связь продукта с аккаунтом партнера по данным.

Примечание: Во всех сценариях с участием партнера по данным учетные данные должны принадлежать учетной записи Google, которая является пользователем в учетной записи партнера по данным.

На этой диаграмме показано, как API Data Manager использует поля учетных данных и Destination для доступа к учетной записи рекламодателя через ссылку на продукт.

Google Реклама

Вот диаграмма, демонстрирующая пример набора аккаунтов Google Ads и аккаунтов партнеров по данным. На диаграмме также показано, какой аккаунт Google является пользователем в каждом аккаунте Google Ads или аккаунте партнера по данным, а также связи между аккаунтами по продуктам.

Партнер по данным D1

Между аккаунтом D1 и аккаунтом Google Ads Manager M2 существует продуктовая связь.

Пользователь с учетной записью Google [e-mail] находится в D1.

Партнер по данным D2

Между D2 и клиентским аккаунтом Google Ads C1 существует продуктовая связь.

Пользователь Google Account [e-mail] зарегистрирован в D2.

Управляющий счет M1

У M1 есть два прямых дочерних счета:

1. Управляющий аккаунт M2
2. Клиентский счет C1

Управляющий аккаунт M2

У M2 есть два прямых дочерних счета:

1. Клиентский счет C1
2. Клиентский аккаунт C2

Клиентский счет C1

У C1 есть два прямых родительских аккаунта для управления:

1. Управляющий счет M1
2. Управляющий аккаунт M2

Клиентский аккаунт C2

Управляющий счет M2 является единственным непосредственным родительским счетом для счета C2.

Вот что вы можете сделать с этим набором учетных записей:

Выступать в качестве партнера по данным D1

Чтобы выступать в качестве партнера по данным D1, используйте учетные данные аккаунта Google [e-mail] для отправки данных в учетную запись менеджера M2, клиентскую учетную запись C1 или клиентскую учетную запись C2, указав в качестве login_account учетную запись партнера по данным D1 и linked_account учетную запись менеджера M2.

Будучи партнером по данным D1, вы не можете отправлять данные в учетную запись менеджера M1, поскольку между D1 и M1 отсутствует связь между продуктами.

Выступать в качестве партнера по данным D2

Чтобы выступать в качестве партнера по данным D2, используйте учетные данные аккаунта Google [e-mail] для отправки данных на клиентский аккаунт 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 account_type GOOGLE_ADS
login_account	account_id Идентификатор клиента учетной записи партнера по данным. account_type DATA_PARTNER
linked_account	Не задавайте значение поля linked_account .
product_destination_id	Идентификатор аудитории или действия конверсии.

Управление ресурсами

Заголовки запроса
login-account	accountTypes/DATA_PARTNER/accounts/ DATA_PARTNER_ID
linked-account	Не устанавливайте заголовок linked-account .

Вот пример сценария прямой связи продукта с использованием учетных записей из диаграммы и соответствующих заголовков запросов для управления ресурсами. В этом сценарии партнер по данным D2 отправляет данные об участниках аудитории клиенту Google Ads C1, используя связь продукта между D2 и C1, а также учетные данные для учетной записи Google [e-mail] :

Приём внутрь

{
  "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 Manager и вашим партнерским аккаунтом данных:

Приём внутрь

Место назначения
operating_account	account_id Идентификатор клиента аккаунта Google Ads account_type GOOGLE_ADS
login_account	account_id Идентификатор клиента учетной записи партнера по данным. account_type DATA_PARTNER
linked_account	account_id Идентификатор клиента аккаунта Google Ads Manager. account_type GOOGLE_ADS
product_destination_id	Идентификатор аудитории или действия конверсии.

Управление ресурсами

Заголовки запроса
login-account	accountTypes/DATA_PARTNER/accounts/ DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/ MANAGER_CUSTOMER_ID

Вот пример сценария связи продукта с менеджером, использующий учетные записи из диаграммы . В этом сценарии партнер по данным D1 отправляет данные об участниках аудитории клиенту Google Ads C2, используя связь продукта между D1 и M2, а также учетные данные для учетной записи Google [e-mail] :

Приём внутрь

{
  "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

Дисплей и видео 360

В качестве партнера по передаче данных вы можете отправлять данные в учетную запись Display & Video 360 двумя способами:

1. Используйте прямую связь между учетной записью партнера по данным и учетной записью партнера или рекламодателя Display & Video 360.
2. Отправляйте данные рекламодателю, использующему платформу Display & Video 360, посредством связи между партнерской учетной записью и основной партнерской учетной записью рекламодателя, использующей платформу Display & Video 360.

Сценарии прямых ссылок на товары

Если вы хотите отправлять данные рекламодателю, использующему Display & Video 360, и связь между продуктом существует между аккаунтом рекламодателя Display & Video 360 и аккаунтом вашего партнера по данным:

Приём внутрь

Место назначения
operating_account	account_id Идентификатор рекламного аккаунта Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Идентификатор клиента учетной записи партнера по данным. account_type DATA_PARTNER
linked_account	Не задавайте значение поля linked_account .
product_destination_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 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id Идентификатор клиента учетной записи партнера по данным. account_type DATA_PARTNER
linked_account	Не задавайте значение поля linked_account .
product_destination_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 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Идентификатор клиента учетной записи партнера по данным. account_type DATA_PARTNER
linked_account	account_id Идентификатор партнерского аккаунта Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
product_destination_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 Аналитика

API Data Manager не поддерживает отправку данных в аккаунт Google Analytics с помощью ссылки на продукт. Вместо этого используйте подход , описанный в сценариях для рекламодателей в Google Analytics .

Подробные требования

В этом разделе приведены подробные требования к полям учетной записи в поле Destination для запроса IngestionService , эквивалентные заголовки запроса для запросов управления ресурсами, советы по установке значения product_destination_id и способы определения того, к чему имеют доступ ваши учетные данные .

Поля учетной записи

Для одного Destination может быть создано до 3 различных учетных записей:

operating_account

Требуется указать operating_account .

Параметр operating_account указывает, какой аккаунт получает данные в запросе. operating_account может принимать любое из следующих значений:

• Аккаунт Google Ads
• Рекламный аккаунт Display & Video 360
• Партнерский аккаунт Display & Video 360
• Ресурс Google Analytics
• Учетная запись партнера по данным используется, если данные отправляются аудитории, принадлежащей этой учетной записи партнера по данным.

В заголовке запроса отсутствует поле operating_account объекта Destination . При отправке запроса на управление ресурсами целевой учетной записью запроса является операционная учетная запись.

Поле login_account и заголовок запроса login-account

Учетная login_account не всегда обязательна и по умолчанию использует operating_account в запросе IngestionService и целевую учетную запись в запросе на управление ресурсами. В запросе на управление ресурсами используйте заголовок запроса login-account для идентификации учетной записи для входа.

API менеджера данных проверяет следующее:

1. Учетная запись Google, к которой относятся данные, принадлежит пользователю, вошедшему в систему.

2. Для входа в систему используется одна из следующих учетных записей:

   • Аналогично operating_account . Это значение по умолчанию, если вы не задаете login_account для Destination в запросе IngestionService или не задаете заголовок login-account в запросе на управление ресурсами.

   • Аккаунт менеджера Google Ads или партнерский аккаунт Display & Video 360 , являющийся родительским для operating_account в запросе IngestionService , или родительским для целевого аккаунта в запросе на управление ресурсами.

   • Партнерская учетная запись, содержащая ссылку на продукт, указывает на linked_account в запросе IngestionService или на заголовок linked-account в запросе на управление ресурсами.

Поле linked_account и заголовок запроса linked-account

Примечание: Связанную учетную запись следует указывать только в том случае, если для учетной записи входа установлено account_type равное DATA_PARTNER , и родительская operating_account связана с учетной записью партнера по данным. Если operating_account напрямую связана с учетной записью партнера по данным, не следует указывать linked_account .

Параметр linked_account указывает, какая учетная запись связана с учетной записью login_account запроса IngestionService или с целевой учетной записью запроса на управление ресурсами.

Идентификатор назначения продукта

Параметр product_destination_id объекта Destination определяет, какой объект в operating_account получает данные. Например, это может быть идентификатор аудитории для Google Ads или Display & Video 360, идентификатор действия конверсии для Google Ads или идентификатор измерения для потока Google Analytics.

Вот как найти идентификатор для каждого типа назначения товара.

Аудитория Google Ads

Идентификатор целевого продукта для сбора данных об участниках аудитории — это идентификатор аудитории. Получить этот идентификатор можно с помощью пользовательского интерфейса Google Ads или API Data Manager.

Пользовательский интерфейс Google Ads

Чтобы получить идентификатор аудитории из пользовательского интерфейса Google Ads:

1. Перейдите в раздел «Управление аудиториями» в пользовательском интерфейсе Google Ads.
2. Нажмите на название аудитории, чтобы просмотреть подробную информацию.
3. Идентификатор аудитории указан рядом с идентификатором списка .

API менеджера данных

Получите список UserList с помощью метода List , указав заголовки запроса при необходимости , и используйте id UserList в качестве идентификатора целевого продукта.

Мероприятие Google Ads

Идентификатор назначения продукта для обработки событий — это идентификатор действия конверсии.

Чтобы получить идентификатор действия конверсии из пользовательского интерфейса Google Ads:

1. Перейдите в раздел «Конверсии» в пользовательском интерфейсе Google Ads.
2. Нажмите на название действия конверсии, чтобы просмотреть подробности.

3. Идентификатор действия конверсии — это значение параметра запроса URL с именем ctId .

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

Чтобы получить идентификатор действия конверсии из API Google Ads:

1. Отправьте запрос Search или SearchStream в GoogleAdsService со следующим содержимым:

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

2. Получите идентификатор действия конверсии из поля id в переменной conversion_action в ответе.

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

Аудитория Display & Video 360

Идентификатор продукта, используемый для сбора данных об участниках аудитории, — это идентификатор аудитории. Получить этот идентификатор можно с помощью пользовательского интерфейса Display & Video 360 или API Data Manager.

Дисплей и видео 360 UI

Чтобы получить идентификатор аудитории из пользовательского интерфейса Display & Video 360:

1. Войдите в пользовательский интерфейс Display & Video 360 по адресу https://displayvideo.google.com .
2. Перейдите к партнеру или рекламодателю Display & Video 360, которого вы используете для operating_account .
3. В левом меню перейдите в раздел «Аудитории» , затем выберите «Все аудитории» .
4. Найдите аудиторию в списке. Идентификатор аудитории — это число рядом с именем в столбце «Имя» .

API менеджера данных

Получите список UserList с помощью метода List , указав заголовки запроса при необходимости , и используйте id UserList в качестве идентификатора целевого продукта.

Событие Google Analytics

Идентификатор назначения продукта для приема событий — это идентификатор измерения потока данных.

Определите, откуда у учетных данных есть доступ.

Учетные данные, используемые для авторизации запроса к API Data Manager, связаны с конкретной учетной записью Google.

• При использовании учетных данных пользователя запросы авторизуются от имени учетной записи Google того пользователя, который предоставил разрешение действовать от его имени при создании учетных данных.
• При использовании учетных данных сервисного аккаунта запросы авторизуются от имени аккаунта Google сервисного аккаунта.

Вот как проверить, что учетная запись Google, для которой вы используете свои данные, имеет доступ к аккаунтам Google Ads, Display & Video 360 или Google Analytics.

Google Ads или партнер по обработке данных

1. В пользовательском интерфейсе Google Ads перейдите в раздел «Доступ и безопасность» для учетной login_account .
2. Выберите вкладку «Пользователи» .
3. Если login_account — это аккаунт Google Ads Manager, отключите переключатель « Показывать пользователей в полной иерархии», чтобы скрыть пользователей из дочерних аккаунтов.
4. Убедитесь, что учетная запись Google, для которой вы используете свои учетные данные, присутствует в списке учетных записей, отображаемом на вкладке «Пользователи» .

Дисплей и видео 360

1. В пользовательском интерфейсе Display & Video 360 перейдите в раздел «Управление пользователями и настройки электронной почты» .
2. Убедитесь, что в разделе « Управление пользователями» отображается информация о том, что учетная запись Google, для которой вы используете ваши учетные данные, зарегистрирована в учетной login_account .

Google Аналитика

1. Перейдите в раздел «Управление доступом к ресурсам» в пользовательском интерфейсе Google Analytics.
2. Убедитесь, что выбрано свойство Google Analytics, указанное в поле login_account .
3. Убедитесь, что учетная запись Google, к которой относятся ваши учетные данные, имеет роль редактора или администратора на данном ресурсе.