Как настроить целевые сервисы и заголовки

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

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

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

    1. Аккаунт, который получает данные. например аккаунт Google Рекламы или ресурс Google Аналитики.
    2. Целевой объект для данных в аккаунте, например действие-конверсия Google Рекламы или поток Google Аналитики.
    3. Путь доступа для учетных данных запроса к аккаунту, который получает данные.

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

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

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

Шаг Тип запроса Заголовки целевой страницы или запроса
Как создать аудиторию Управление ресурсами Заголовки запроса
Как добавить участников в аудиторию Передача данных Направления
Посмотреть данные диагностики Передача данных Направления
Получение аудитории Управление ресурсами Заголовки запроса

Чтобы переключаться между сведениями о каждом типе запроса, нажимайте на вкладку Загрузка или Управление ресурсами рядом с каждой таблицей.

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

Если вы партнер по обработке данных, перейдите к разделу Сценарии для партнеров по обработке данных. В нем приведены примеры того, как задавать заголовки и создавать Destination для управления ресурсами и отправки данных в аккаунт, связанный с вашим аккаунтом партнера по обработке данных.

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

Возможные ситуации для рекламодателей

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

Путь доступа рекламодателя

Google Реклама

На диаграмме ниже показан пример набора аккаунтов Google Рекламы и пользователей.

Аккаунты и пользователи Google Рекламы

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

У M1 есть два дочерних аккаунта:

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

Аккаунт Google cloudysanfrancisco@gmail.com – пользователь в M1.

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

У M2 есть два дочерних аккаунта:

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

Аккаунт Google baklavainthebalkans@gmail.com – пользователь в M2.

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

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

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

Аккаунт Google jeffersonloveshiking@gmail.com – это пользователь в C1.

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

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

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

В сценариях Прямой доступ и Доступ через управляющий аккаунт показано, как настроить целевой сервис для отправки данных в эти аккаунты.

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

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

Передача данных
Место назначения
operating_account
account_id Идентификатор клиента аккаунта Google Рекламы.
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 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 Рекламы, а ваши учетные данные относятся к аккаунту Google, который является пользователем в управляющем аккаунте Google Рекламы, где аккаунт рекламодателя является дочерним аккаунтом:

Передача данных
Место назначения
operating_account
account_id Идентификатор клиента в клиентском аккаунте Google Рекламы.
account_type GOOGLE_ADS
login_account
account_id Идентификатор клиента управляющего аккаунта Google Рекламы.
account_type GOOGLE_ADS
linked_account Не заполняйте поле linked_account.
product_destination_id Идентификатор аудитории или действия-конверсии.
Управление ресурсами
Заголовки запроса
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account Не задавайте заголовок linked-account.

Ниже приведен пример сценария доступа управляющего аккаунта к клиентскому аккаунту Google Рекламы 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 Рекламы C2 и учетных данных аккаунта Google cloudysanfrancisco@gmail.com, который является пользователем управляющего аккаунта Google Рекламы 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.

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

Отправлять данные в Дисплей и Видео 360 можно двумя способами:

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

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

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

Передача данных
Место назначения
operating_account
account_id Идентификатор аккаунта рекламодателя в Дисплее и Видео 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 для сценария прямого доступа, в котором данные отправляются рекламодателю Дисплея и Видео 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.

Аналогично, если вы хотите отправить данные в аккаунт партнера Дисплея и Видео 360 и ваши учетные данные относятся к аккаунту Google, который является пользователем в аккаунте партнера:

Передача данных
Место назначения
operating_account
account_id Идентификатор партнерского аккаунта Дисплея и Видео 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 для сценария прямого доступа, в котором данные отправляются партнеру Дисплея и Видео 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.

Сценарий доступа партнера Дисплея и Видео 360

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

Передача данных
Место назначения
operating_account
account_id Идентификатор аккаунта рекламодателя в Дисплее и Видео 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Идентификатор партнерского аккаунта Дисплея и Видео 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 для сценария с доступом партнера, который позволяет отправлять данные рекламодателю Дисплея и Видео 360. В этом случае учетные данные должны относиться к аккаунту Google, который является пользователем в партнерском аккаунте Дисплея и Видео 360 DISPLAY_VIDEO_PARTNER_ID, а аккаунт рекламодателя Дисплея и Видео 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 Аналитики, то либо не задавайте login_account, либо задайте для него те же значения, что и для operating_account. В противном случае запрос не будет выполнен и появится сообщение об ошибке OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Передача данных
Место назначения
operating_account
account_id Идентификатор ресурса Google Аналитики.
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 Аналитику:

Передача данных
{
  "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.
Если ваш рекламодатель является дочерним по отношению к родительскому, используйте идентификатор родительского рекламодателя в Менеджере кампаний 360 в качестве идентификатора конфигурации Floodlight. В противном случае используйте идентификатор рекламодателя. Подробнее о том, как найти идентификатор рекламодателя в интерфейсе Менеджера кампаний 360…
account_type FLOODLIGHT_CONFIG
login_account Не задавайте login_account или задайте для него те же значения, что и для operating_account.
linked_account Не заполняйте поле linked_account.
product_destination_id Идентификатор действия Floodlight

Ниже приведен пример тега Destination для отправки событий в Floodlight.

Передача данных
        {
          "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 Реклама

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

Аккаунты и пользователи партнера по обработке данных и аккаунтов Google Рекламы

Партнер по обработке данных D1

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

Аккаунт Google 222larabrown@gmail.com – пользователь в домене D1.

Партнер по обработке данных D2

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

Аккаунт Google jeffersonloveshiking@gmail.com – пользователь в 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 222larabrown@gmail.com для выполнения следующих действий:

  • Отправьте данные в клиентский аккаунт C1 или C2, используя целевой сервис, в котором для параметра login_account задан аккаунт партнера по обработке данных D1, а для параметра linked_account – управляющий аккаунт M2.

  • Отправлять данные напрямую в аккаунт менеджера M2, используя целевой сервис, в котором для параметра login_account задан аккаунт партнера по обработке данных D1. Не указывать linked_account.

Как партнер по обработке данных D1, вы не можете отправлять данные в управляющий аккаунт M1, поскольку между D1 и M1 нет партнерской связи.

Действовать от имени партнера по обработке данных D2

Чтобы действовать в качестве партнера по обработке данных D2, используйте учетные данные аккаунта Google jeffersonloveshiking@gmail.com для отправки данных в клиентский аккаунт C1, используя целевой сервис, в котором login_account задан как аккаунт партнера по обработке данных D2. Не указывать linked_account.

Партнер по обработке данных D2 не может отправлять данные в управляющие аккаунты M1 и M2, а также в клиентский аккаунт C2, поскольку между D2 и этими аккаунтами или их родительскими управляющими аккаунтами нет партнерской связи.

Основное различие между партнерами по обработке данных D1 и D2 заключается в том, как они связаны с аккаунтами Google Рекламы.

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

Если вы хотите отправлять данные в аккаунт Google Рекламы и партнерская связь установлена между аккаунтом Google Рекламы и аккаунтом партнера по обработке данных:

Передача данных
Место назначения
operating_account
account_id Идентификатор клиента аккаунта Google Рекламы.
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 Рекламы C1, используя партнерскую связь между D2 и C1 и учетные данные аккаунта Google jeffersonloveshiking@gmail.com.

Передача данных
{
  "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 Рекламы, а связь с партнером установлена между родительским управляющим аккаунтом Google Рекламы и аккаунтом партнера по обработке данных:

Передача данных
Место назначения
operating_account
account_id Идентификатор клиента в клиентском аккаунте Google Рекламы.
account_type GOOGLE_ADS
login_account
account_id Идентификатор клиента в аккаунте партнера по обработке данных.
account_type DATA_PARTNER
linked_account
account_id Идентификатор клиента управляющего аккаунта Google Рекламы.
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 Рекламы C2, используя партнерскую связь между D1 и M2 и учетные данные аккаунта Google 222larabrown@gmail.com.

Передача данных
{
  "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

Партнер по обработке данных может отправлять данные в аккаунт Дисплея и Видео 360 двумя способами:

  1. Используйте прямую партнерскую связь между аккаунтом партнера по обработке данных и аккаунтом партнера или рекламодателя в Дисплее и Видео 360.
  2. Отправлять данные рекламодателю Дисплея и Видео 360, используя партнерскую связь между аккаунтом партнера по обработке данных и родительским партнерским аккаунтом рекламодателя в Дисплее и Видео 360.

Если вы хотите отправить данные рекламодателю Дисплея и Видео 360, а партнерская связь установлена между аккаунтом рекламодателя Дисплея и Видео 360 и вашим аккаунтом партнера по обработке данных, выполните следующие действия:

Передача данных
Место назначения
operating_account
account_id Идентификатор аккаунта рекламодателя в Дисплее и Видео 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 для сценария прямой связи с партнером, чтобы отправлять данные рекламодателю Дисплея и Видео 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.

Чтобы отправлять данные в аккаунт партнера Дисплея и Видео 360, необходимо установить партнерскую связь между аккаунтом партнера Дисплея и Видео 360 и аккаунтом партнера по обработке данных.

Передача данных
Место назначения
operating_account
account_id Идентификатор партнерского аккаунта Дисплея и Видео 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 для сценария прямой связи с партнером, чтобы отправлять данные партнеру Дисплея и Видео 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.

Если вы хотите отправить данные рекламодателю Дисплея и Видео 360, а партнерская связь с вашим аккаунтом партнера по обработке данных установлена с партнерским аккаунтом Дисплея и Видео 360, в котором аккаунт рекламодателя является дочерним:

Передача данных
Место назначения
operating_account
account_id Идентификатор аккаунта рекламодателя в Дисплее и Видео 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Идентификатор клиента в аккаунте партнера по обработке данных.
account_type DATA_PARTNER
linked_account
account_id Идентификатор партнерского аккаунта Дисплея и Видео 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 для сценария, в котором данные передаются рекламодателю Дисплея и Видео 360 с помощью партнерской связи между партнером по обработке данных и родительским партнером рекламодателя в Дисплее и Видео 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 Менеджер рекламы;

Если вы хотите отправлять данные в аккаунт Google Менеджера рекламы и у вас есть партнерская связь между аккаунтом партнера по обработке данных и аккаунтом Google Менеджера рекламы:

Передача данных
Место назначения
operating_account
account_id Идентификатор связи с аудиторией аккаунта Google Менеджера рекламы.
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
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 для отправки данных в аккаунт Google Менеджера рекламы с помощью партнерской ссылки.

Передача данных
      {
        "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 Аналитика

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

Floodlight

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

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

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

Поля аккаунта

У Destination может быть до трех разных аккаунтов:

operating_account

operating_account – обязательный атрибут.

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

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

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

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

Data Manager API проверяет следующее:

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

  2. Аккаунт для входа – один из следующих:

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

    • Управляющий аккаунт Google Рекламы или аккаунт партнера Дисплея и Видео 360, который является родительским для operating_account в запросе IngestionService или для целевого аккаунта в запросе на управление ресурсами.

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

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

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

Идентификатор целевого сервиса для товара

Свойство product_destination_id объекта Destination определяет, какой объект в operating_account получает данные. Например, это может быть идентификатор аудитории для Google Рекламы или Дисплея и Видео 360, идентификатор действия-конверсии для Google Рекламы или идентификатор потока данных Google Аналитики.

Ниже рассказывается, как найти идентификатор для каждого типа целевого сервиса.

Аудитория Google Рекламы

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

Чтобы получить идентификатор аудитории в интерфейсе Google Рекламы, выполните следующие действия:

  1. В интерфейсе Google Рекламы перейдите в Менеджер аудиторий.
  2. Чтобы посмотреть подробные сведения, нажмите на название аудитории.
  3. Идентификатор аудитории указан рядом с полем Идентификатор списка.

Data Manager API

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

Событие Google Рекламы

Идентификатор целевого сервиса для получения событий – это идентификатор действия-конверсии. Этот идентификатор можно получить в интерфейсе Google Рекламы или с помощью Google Ads API.

Чтобы получить идентификатор действия-конверсии в интерфейсе Google Рекламы, выполните следующие действия:

  1. В интерфейсе Google Рекламы перейдите в раздел Конверсии.
  2. Нажмите на название действия-конверсии.
  3. Перейдите на вкладку Details (Сведения).
  4. Идентификатор действия-конверсии – это число рядом с надписью Идентификатор типа конверсии.

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

  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"
          }
        }
      ]
    }
  ]

Аудитория Дисплея и Видео 360

Идентификатор целевого продукта для добавления участников аудитории – это идентификатор аудитории. Получить этот идентификатор можно в интерфейсе Дисплея и Видео 360 или с помощью Data Manager API.

Интерфейс Дисплея и Видео 360

Чтобы получить идентификатор аудитории в интерфейсе Дисплея и Видео 360, выполните следующие действия:

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

Data Manager API

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

Событие Google Аналитики

Идентификатор целевого сервиса зависит от типа потока данных.

Веб-поток
Используйте идентификатор потока данных.
Поток данных приложения

Используйте идентификатор приложения Firebase для потока данных. Вот два способа найти идентификатор приложения Firebase:

Событие Floodlight

Идентификатор целевого сервиса для передачи событий в Floodlight – это идентификатор действия Floodlight. Этот идентификатор можно получить в интерфейсе или API Менеджера кампаний 360.

Интерфейс Менеджера кампаний 360

Чтобы получить идентификатор действия Floodlight в интерфейсе Менеджера кампаний 360, выполните следующие действия:

  1. Войдите в интерфейс Менеджера кампаний 360.
  2. Перейдите к рекламодателю Менеджера кампаний 360, которого вы используете для operating_account.
  3. В меню слева выберите Floodlight > Действия.
  4. Найдите в списке нужное действие Floodlight. Идентификатор – это число рядом с названием в столбце Название действия.

Campaign Manager 360 API

Чтобы получить идентификатор действия Floodlight из API Менеджера кампаний 360:

  1. Отправьте запрос list ресурсу floodlightActivities.
  2. Укажите floodlightConfigurationId конфигурации Floodlight.
  3. При необходимости используйте параметр searchString, чтобы отфильтровать результаты по названию действия.
  4. Получите идентификатор действия Floodlight из поля id выбранного объекта FloodlightActivity в ответе.

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

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

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

Ниже описано, как проверить, есть ли у аккаунта Google, связанного с вашими учетными данными, доступ к аккаунту Google Рекламы, Дисплея и Видео 360, Google Аналитики или Менеджера кампаний 360.

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

  1. В интерфейсе Google Рекламы для login_account перейдите в раздел Доступ и безопасность.
  2. Откройте вкладку Пользователи.
  3. Если login_account – это управляющий аккаунт Google Рекламы, отключите переключатель Показать полную иерархию пользователей, чтобы скрыть пользователей дочерних аккаунтов.
  4. Убедитесь, что аккаунт Google, для которого вы создаете учетные данные, есть в списке на вкладке Пользователи.

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

  1. В интерфейсе Дисплея и Видео 360 выберите Управление доступом и настройки электронной рассылки.
  2. В разделе Управление доступом убедитесь, что аккаунт Google, учетные данные которого вы используете, является пользователем login_account.

Google Аналитика

  1. В интерфейсе Google Аналитики перейдите в раздел Управление доступом к ресурсу.
  2. Убедитесь, что выбран ресурс Google Аналитики, указанный в login_account.
  3. Убедитесь, что у аккаунта Google, который вы используете для входа, есть роль редактора или администратора для ресурса.

Floodlight (Менеджер кампаний 360)

  1. Войдите в интерфейс Менеджера кампаний 360.
  2. В меню слева выберите Администратор > Профили пользователей.
  3. Убедитесь, что аккаунт Google, для которого вы создаете учетные данные, есть в списке профилей.
  4. Нажмите на профиль и убедитесь, что у него есть доступ к аккаунту рекламодателя, который используется в качестве login_account. Если вы не укажете в запросе login_account, по умолчанию будет использоваться operating_account. Убедитесь, что в аккаунте есть роль пользователя с разрешением Добавление офлайн-конверсий.
Далее
Как форматировать пользовательские данные