В этом документе описывается, как использовать Management API для управления аудиториями ремаркетинга Google Analytics.
Введение
API управления позволяет create
, get
, delete
, составлять list
, update
и patch
аудитории ремаркетинга для ресурса Google Analytics. Дополнительную информацию о том, как работают аудитории ремаркетинга, можно найти в статье Справочного центра «Об аудиториях ремаркетинга в Analytics» .
Случаи использования
Ресурс «Аудитория ремаркетинга» поддерживает методы get , delete , list , patch и update , но основными вариантами использования являются:
- Составьте список аудиторий ремаркетинга .
- Создайте новую аудиторию ремаркетинга .
- Обновите существующую аудиторию ремаркетинга .
Получение списка аудиторий ремаркетинга
Чтобы вывести список всех аудиторий ремаркетинга для ресурса:
- Используйте Management API или Account Explorer , чтобы получить
accountId
иwebPropertyId
. - Выполните метод
list
ресурса «Аудитории ремаркетинга».
Подробную информацию о методе list
для ресурса аудитории ремаркетинга см. в справочнике по API.
Создайте новую аудиторию ремаркетинга
Чтобы создать новую аудиторию ремаркетинга для ресурса:
- Используйте Management API или Account Explorer , чтобы получить
accountId
иwebPropertyId
. - Используйте Management API или Account Explorer , чтобы получить идентификатор представления (профиля) для свойства
linkedViews []
. - Используйте коллекцию ссылок Google Рекламы , чтобы получить идентификатор аккаунта Google Рекламы для
linkedAdAccounts.linkedAccountId
.- Свойство
linkedAdAccounts[]
в настоящее время ограничено только однимlinkedForeignAccount
. - Тип
linkedAdAccounts[].type
может иметь значениеADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
илиOPTIMIZE
.
- Свойство
- Используйте коллекцию Segments для параметров установки свойства
segment
includeConditions
, а при создании аудитории на основе состояния сделайте то же самое дляexcludeConditions
. Также см. справочник по сегментам для определения сегмента.-
includeConditions
может дополнительно иметь значенияmembershipDurationDays
daysToLookBack
. -
excludeConditions.exclusionDuration
может быть установлен в значениеPERMANENT
.
-
- Выполните метод
insert
ресурса «Аудитория ремаркетинга».
API позволяет создавать два типа аудиторий: SIMPLE
и STATE_BASED
. Для SIMPLE
аудитории вам нужно создать audienceDefinition
только с положительным segment
без оператора NOT (символ !
) . Если вы хотите включить условие исключения, вы должны определить statebasedDefinition
; дополнительные сведения см. в разделе «Аудитории на уровне штата» . Подробности смотрите в справочном примере .
Обновите существующую аудиторию ремаркетинга
Чтобы обновить существующую аудиторию ремаркетинга для ресурса:
- Если у вас уже есть идентификатор аудитории ремаркетинга, вы можете вызвать
get
, в противном случае вы можете вызватьlist
и выбрать аудиторию, которую хотите обновить. - Обновите любое из полей, доступных для записи , и вызовите передачу
update
в обновленном объекте аудитории.