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

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

Введение

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

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

Ресурс Remarketing Audience поддерживает методы get, 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 Links получите идентификатор аккаунта AdWords для linkedAdAccounts.linkedAccountId.
    • В настоящее время свойство linkedAdAccounts[] может содержать только один linkedForeignAccount.
    • Свойству linkedAdAccounts[].type можно присвоить значение ADWORDS_LINKS.
  4. Используйте коллекцию Segments, чтобы задать свойство segment объекта includudeConditions, а для создания аудитории с условиями по статусу или уровню задайте то же свойство для объекта 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, передав в него объект обновляемой аудитории.