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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Google Реклама
• Дисплей и Видео 360
• Google Менеджер рекламы
• Google Аналитика
• Floodlight

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

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

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

Google Реклама

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

Управляющий аккаунт 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 Рекламы и ваши учетные данные относятся к аккаунту 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 [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 Рекламы, а ваши учетные данные относятся к аккаунту 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 [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.

Ниже приведен ещё один пример сценария доступа к клиентскому аккаунту Google Рекламы C2 с использованием учетных данных аккаунта Google [e-mail], который является пользователем управляющего аккаунта 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	Идентификатор потока данных сайта. Идентификатор приложения в Firebase для потока данных приложения.

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

Заголовки запроса
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 – это конфигурация Floodlight, не задавайте значение для login_account или задайте для него те же значения, что и для operating_account. В противном случае запрос завершится с ошибкой OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Передача данных

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

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

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

Google Реклама

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

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

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

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

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

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

Аккаунт Google [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, поскольку между ними нет связи.

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

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

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

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

• Партнер по обработке данных D1 связан с управляющим аккаунтом Google Рекламы. Это пример связи с партнером на уровне управляющего аккаунта.
• Партнер по обработке данных 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 [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 Рекламы, а связь с партнером установлена между родительским управляющим аккаунтом 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 [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

Партнер по обработке данных может отправлять данные в аккаунт Дисплея и Видео 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 может представлять собой:

• Аккаунт Google Рекламы
• Аккаунт рекламодателя Дисплея и Видео 360.
• Аккаунт партнера в Дисплее и Видео 360.
• Аккаунт Google Менеджера рекламы.
• ресурс Google Аналитики;
• Аккаунт партнера по обработке данных, если вы отправляете данные в аудиторию, принадлежащую этому аккаунту.

Заголовка запроса, соответствующего полю 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

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

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

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

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

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

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

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

Интерфейс Google Рекламы

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

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

Data Manager API

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

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

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

Интерфейс Google Рекламы

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

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

Google Ads API

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