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

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

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

  • Используйте 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.

Ниже приведен пример сценария доступа к клиентскому аккаунту 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, чтобы отправлять данные в управляющий аккаунт M2, клиентский аккаунт C1 или клиентский аккаунт C2, используя целевой аккаунт с параметром login_account, заданным как аккаунт партнера по обработке данных D1, и параметром linked_account, заданным как управляющий аккаунт M2.

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

Представь, что ты партнер по обработке данных D2.

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

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

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

В этом разделе приведены подробные требования к полям аккаунта 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. Аккаунт для входа в систему относится к одному из следующих типов:

Поле 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:

  • В интерфейсе Google Аналитики перейдите в раздел Потоки данных, нажмите на нужный поток и найдите ИДЕНТИФИКАТОР ПРИЛОЖЕНИЯ FIREBASE.
  • Консоль Firebase.

Событие Floodlight

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

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

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

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

Campaign Manager 360 API

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

  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. Убедитесь, что у аккаунта есть роль пользователя с разрешением Вставлять офлайн-конверсии.