Статья написана в пользовательском блоге — редакция Партнеркина не вносит изменения в текст. Вся орфография, пунктуация и содержание сохранены Подробнее про пользовательские блоги и о том, как зарабатывать до 3 000 ₽ за статью 😎

Главная – Блоги – Блог code

24 декабря 0 1925

Как настроить таргетинг кампаний в Moloco

Как настроить таргетинг кампаний в Moloco

В рамках Moloco существует несколько способов целевой аудитории для рекламных кампаний. Можно работать как со списками конкретных пользователей - включая или исключая их из показов, так и формировать аудиторию по условиям: страна, язык, тип операционной системы и множество других параметров.

На практике чаще всего используют два подхода:

списки пользователей через Customer Set
логический таргетинг через audience_target и подключение его к ad group

Разберём оба варианта с точки зрения реального использования.

Вариант 1. Customer Set - работа со списками пользователей

Customer Set - это объект, представляющий собой набор идентификаторов пользователей для рекламы - IDFA для iOS или ADID для Android. Такой набор можно точно использовать как для включения аудитории в таргетинг, так и для ее исключения.

Типичные сценарии:

ретаргетинг существующих пользователей
исключение уже сконвертированной аудитории
white / black list источников
проверка качества трафика
работа с тестовыми сегментами

Подготовка данных

Для создания Customer Set нужно подготовить CSV-файл со списком IDFA или ADID. В одном наборе допускается только один тип идентификаторов - либо Android, либо iOS.

Загрузка Customer Set в Google Cloud Storage через Moloco API

Процесс загрузки файла состоит из двух шагов.

Вакансии

CRM/Retention Manager

1win

После собеседования

Удаленно

Middle/Senior Mediabuyer / Медиабайер с опытом

Удаленно

Удаленно

Шаг 1. Получение сессии загрузки

Сначала отправляется POST-запрос, который возвращает временные URL для загрузки файла.

$ cat asset.json
{
"asset_kind": "CSV",
"mime_type": "text/csv"
}
$ curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "@asset.json" \
"https://api.moloco.cloud/cm/v1/creative-assets?ad_account_id=$AD_ACCOUNT_ID"

В ответе вы получаете:

asset_url - адрес, по которому файл будет доступен после загрузки
content_upload_url - временный URL для отправки CSV в хранилище

Шаг 2. Загрузка CSV-файла

Далее выполняется PUT-запрос с самим файлом.

$ curl -X PUT \
--data-binary "@$ASSET_PATH" \
-H "Content-Type: text/csv" \
$UPLOAD_URL

Если API возвращает HTTP 200 или 201 - файл успешно загружен. Именно asset_url понадобится на следующем шаге.

Проверка целостности файла

Работа с большими списками или автоматизацией в продакшене подразумевает немалые риски, в частности, повреждение файла при загрузке. Лингвистически это значит, что проверка целостности загруженного файла может оказаться не лишней. Проверить загруженный файл можно двумя способами. Либо дополнительным запросом к upload URL, либо просто с помощью gsutil сравнив хеши файла.

Создание Customer Set

После загрузки CSV создаётся объект Customer Set. Обратите внимание: необходимо указать тип идентификаторов - GOOGLE_ADID для Android или IDFA для iOS. Использовать оба типа одновременно нельзя.

$ cat customer_set.json
{
"title": "Test CustomerSet",
"description": "Test CustomerSet",
"id_type": "GOOGLE_ADID",
"data_file_path": "$CUSTOMER_SET_ASSET_URL"
}
$ curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "@customer_set.json" \
"https://api.moloco.cloud/cm/v1/customer-sets?ad_account_id=$AD_ACCOUNT_ID"

В ответе вы получите customer_set_id - он понадобится для настройки аудиторий.

Вариант 2. Audience Target - логика таргетинга

Audience Target - это не что иное как такой объект, который обрисовывает правила таргетинга. Тут задаются логика: кого показывать, кого исключать, какие списки использовать и как их между собой комбинировать. Чаще всего audience_target строится на основе одного или нескольких Customer Set.

Создание audience_target

Пример ниже показывает, как создать аудиторию, включающую пользователей из конкретного Customer Set.

$ cat audience_target.json
{
"title": "Test AudienceTarget",
"targeting_condition": {
"custom_audience_set": {
"include_having_any": {
"user_lists": [
"$CUSTOMER_SET_ID"
]
}
}
}
}
$ curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "@audience_target.json" \
"https://api.moloco.cloud/cm/v1/audience-targets?ad_account_id=$AD_ACCOUNT_ID"

В ответе возвращается audience_target_id - готовая аудитория для использования в кампаниях.

Подключение audience_target к ad group

Шаг 1. Получить текущий ad group

$ curl -X GET \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
"https://api.moloco.cloud/cm/v1/ad-groups/$AD_GROUP_ID?campaign_id=$CAMPAIGN_ID"

Шаг 2. Обновить ad group и добавить аудиторию

$ cat ad_group_updated.json
{
"id": "$AD_GROUP_ID",
"campaign_id": "$CAMPAIGN_ID",
"ad_account_id": "$AD_ACCOUNT_ID",
"enabling_state": "ENABLED",
"audience": {
"shared_audience_target_ids": [
"$AUDIENCE_TARGET_ID"
]
}
}
$ curl -X PUT \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "@ad_group_updated.json" \
"https://api.moloco.cloud/cm/v1/ad-groups/$AD_GROUP_ID?campaign_id=$CAMPAIGN_ID"

После этого ad group начинает работать с заданной аудиторией.

Важно: все описанные шаги - создание Customer Set, настройка Audience Target и подключение аудитории к ad group - выполняются через Moloco API.

Этот подход используется для автоматизации, масштабирования и точного контроля таргетинга без работы в интерфейсе платформы. Он особенно актуален для команд с собственными скриптами, BI и потоками данных, где аудитории и логика обновляются динамически.

Что важно понимать на практике