Настройте пункты назначения

Каждый Destination в запросе IngestAudienceMembersRequest или IngestEventsRequest определяет:

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

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

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

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

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

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

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

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

Google Реклама

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

Управляющий счет 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 Ads, и ваши учетные данные относятся к аккаунту Google, который является пользователем этого аккаунта Google Ads:

Вот пример сценария прямого доступа с использованием учетных записей из схемы и учетных данных для аккаунта 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"
    }
  ]
}

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

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

Вот пример сценария доступа администратора к клиентскому аккаунту C2 Google Ads из схемы , а также учетные данные для аккаунта 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"
    }
  ]
}

Вот ещё один пример сценария доступа к учетной записи C2 клиента Google Ads и учетных данных для аккаунта Google cloudysanfrancisco@gmail.com , который является пользователем учетной записи M1 менеджера Google Ads:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

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

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

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

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

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

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

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

Вот пример Destination для сценария прямого доступа к данным, отправляемым партнеру Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Сценарий доступа для партнеров Display & Video 360

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

Вот пример Destination для сценария доступа партнера к данным для отправки их рекламодателю Display & Video 360. В этом сценарии учетные данные должны принадлежать учетной записи Google, которая является пользователем в партнерской учетной записи Display & Video 360 с PARTNER_ID , а учетная запись рекламодателя Display & Video 360 с идентификатором ADVERTISER_ID должна быть дочерней по отношению к партнерской учетной записи PARTNER_ID .

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Аналитика

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

Вот пример Destination для отправки событий в Google Analytics:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

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

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

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

Google Реклама

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

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

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

Пользователь с учетной записью Google 222larabrown@gmail.com находится в D1.

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

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

Пользователь Google Account 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, поскольку между D1 и M1 отсутствует связь между продуктами.

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

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

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

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

• Партнер по данным D1 связан с аккаунтом менеджера Google Ads. Это пример сценария привязки продукта к аккаунту менеджера .
• Партнер по данным D2 связан с клиентским аккаунтом Google Ads. Это пример сценария прямой привязки продукта .

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

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

Вот пример сценария прямой ссылки на продукт с использованием учетных записей из диаграммы . В этом сценарии партнер по данным D2 отправляет данные об участниках аудитории клиенту Google Ads 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"
    }
  ]
}

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

Если вы хотите отправлять данные в аккаунт Google Ads, и связь между продуктом существует между основным аккаунтом Google Ads Manager и вашим партнерским аккаунтом данных:

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

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

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

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

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

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

Вот пример Destination для сценария прямой ссылки на продукт для отправки данных рекламодателю, использующему Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Для отправки данных в партнерский аккаунт Display & Video 360 необходимо наличие связи между партнерским аккаунтом Display & Video 360 и вашим партнерским аккаунтом по передаче данных.

Вот пример Destination для сценария прямой ссылки на продукт для отправки данных партнеру Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Сценарий взаимодействия партнеров по продуктам Display & Video 360

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

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Аналитика

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

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

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

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

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

operating_account

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

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

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

login_account

login_account не всегда обязателен и по умолчанию используется operating_account .

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

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

2. login_account может быть одной из следующих:

   • Аналогично параметру operating_account . Это значение по умолчанию, если вы не задали параметр login_account .

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

   • Партнерский аккаунт, содержащий ссылку на продукт в linked_account .

linked_account

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

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

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

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

Аудитория Google Ads

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

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

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

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

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

   SELECT
     user_list.id,
     user_list.name
   FROM user_list
   WHERE user_list.name = 'USER_LIST_NAME'
   

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

   [
     {
       "results": [
         {
           "userList": {
             "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
             "id": "USER_LIST_ID",
             "name": "USER_LIST_NAME"
           }
         }
       ]
     }
   ]
   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Событие Google Analytics

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

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

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

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

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

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

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

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

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

Google Аналитика

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