Руководство для разработчиков аудиторий ремаркетинга

В этом документе описывается, как использовать Management API для управления аудиториями ремаркетинга Google Analytics.

Введение

API управления позволяет create , get , delete , составлять list , update и patch аудитории ремаркетинга для ресурса Google Analytics. Дополнительную информацию о том, как работают аудитории ремаркетинга, можно найти в статье Справочного центра «Об аудиториях ремаркетинга в Analytics» .

Случаи использования

Ресурс «Аудитория ремаркетинга» поддерживает методы get , delete , list , patch и update , но основными вариантами использования являются:

Получение списка аудиторий ремаркетинга

Чтобы вывести список всех аудиторий ремаркетинга для ресурса:

  1. Используйте Management API или Account Explorer , чтобы получить accountId и webPropertyId .
  2. Выполните метод list ресурса «Аудитории ремаркетинга».

Подробную информацию о методе list для ресурса аудитории ремаркетинга см. в справочнике по API.

Создайте новую аудиторию ремаркетинга

Чтобы создать новую аудиторию ремаркетинга для ресурса:

  1. Используйте Management API или Account Explorer , чтобы получить accountId и webPropertyId .
  2. Используйте Management API или Account Explorer , чтобы получить идентификатор представления (профиля) для свойства linkedViews [] .
  3. Используйте коллекцию ссылок Google Рекламы , чтобы получить идентификатор аккаунта Google Рекламы для linkedAdAccounts.linkedAccountId .
    • Свойство linkedAdAccounts[] в настоящее время ограничено только одним linkedForeignAccount .
    • Тип linkedAdAccounts[].type может иметь значение ADWORDS_LINKS , DBM_LINKS , MCC_LINKS или OPTIMIZE .
  4. Используйте коллекцию Segments для параметров установки свойства segment includeConditions , а при создании аудитории на основе состояния сделайте то же самое для excludeConditions . Также см. справочник по сегментам для определения сегмента.
    • includeConditions может дополнительно иметь значения membershipDurationDays daysToLookBack .
    • excludeConditions.exclusionDuration может быть установлен в значение PERMANENT .
  5. Выполните метод insert ресурса «Аудитория ремаркетинга».

API позволяет создавать два типа аудиторий: SIMPLE и STATE_BASED . Для SIMPLE аудитории вам нужно создать audienceDefinition только с положительным segment без оператора NOT (символ ! ) . Если вы хотите включить условие исключения, вы должны определить statebasedDefinition ; дополнительные сведения см. в разделе «Аудитории на уровне штата» . Подробности смотрите в справочном примере .

Обновите существующую аудиторию ремаркетинга

Чтобы обновить существующую аудиторию ремаркетинга для ресурса:

  1. Если у вас уже есть идентификатор аудитории ремаркетинга, вы можете вызвать get , в противном случае вы можете вызвать list и выбрать аудиторию, которую хотите обновить.
  2. Обновите любое из полей, доступных для записи , и вызовите передачу update в обновленном объекте аудитории.