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

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

Введение

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

Примеры использования

Ресурс Remarketing Audience поддерживает методы get, delete, list, patch и update, однако в основном он используется в следующих целях:

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

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

  1. C помощью Management API или инструмента Account Explorer получите идентификаторы аккаунта (accountId) и ресурса (webPropertyId).
  2. Выполните метод list ресурса Remarketing Audience.

Подробную информацию о методе list вы найдете в статье о ресурсе Remarketing Audience справочника по API.

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

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

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

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

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

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

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