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

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

17 декабря 0 69

Как отслеживать события кампаний в Moloco

Как отслеживать события кампаний в Moloco: Log API, события, выгрузки и реальная польза для автоматизации

Когда‍‌‍‍‌ в Moloco говорят об автоматизации, многие сразу представляют сделки и бюджеты. Но без данных никакие авто-правила не дадут корректный результат.Вот почему Log API - один из самых важных инструментов, если вы:

строите авто-оптимизацию
работаете со скриптами
ведёте несколько аккаунтов или большие объёмы
хотите видеть реальные события, а не только агрегированные цифры в интерфейсе

Что такое Log API и зачем он нужен

Log API Moloco - это набор методов API для обработки журналов событий рекламы. Через него можно получить сырые данные об:

• показах (impressions)

• кликах (clicks)

• конверсионных событиях (conversion events)

Это важно, потому что в это же время стандартные отчеты - это все что у вас есть чтобы смотреть стату.

А как же редакция статистики, активации пикселей, проверки парсящего скрипта, пересчета метрик, подключения всех этих данные к автоправилам, авторизации автоматизации?

И все это - моментально, без 24 часов ожидания.

Сначала видите - потом мочите.

Плюс, как бонус, все эти данные сразу же появляются там, где они вам нужны.

Важно: по умолчанию API выключен. Чтобы его включить нужно написать своему акаунт менеджеру в Moloco и попросить включить вам API.

Какие действия доступны через Log API

Log API позволяет:

создавать лог-задачи (generate log files)
проверять статус генерации
скачивать готовые файлы
просматривать список логов
удалять старые логи

Каждый лог - это объект с чёткими параметрами:

Параметр	Что означает
ad_account_id	рекламный аккаунт
type	тип события
format	формат файла
date	дата данных

Что такое виды событий, которые мы собираем на аналитике по рекламе?

В старой реализации мы поддерживали всего три основных типа логов:

IMP - показы
CLICK - клики
CONVERSION - конверсии (install, purchase, FTD, custom events)

Именно conversion-логи чаще всего используются для:

расчёта реального CPA
контроля качества трафика
работы с LTV и post-event аналитикой
авто-отключений и скейла.

Форматы логов: CSV или AVRO

При создании лога можно выбрать формат файла:

CSV - простой вариант, удобен для:
- Google Sheets
- Excel
- быстрых проверок
AVRO - для больших объёмов данных и продакшн-аналитики:
- BigQuery
- ClickHouse
- Spark / Hadoop

Если данных много, Moloco автоматически разобьёт лог на несколько файлов.

Как создаётся лог (логика, а не просто код)

При создании лога файл немедленно не генерируется. Процесс начинается с подачи задачи вам, а Moloco начинает генерацию файла.

Что это значит?

1. Вы вам создаете log-object с заданными параметрами.

2. Moloco принимает задачу.

3. Построение файла.

4. Подготовка временной ссылки для загрузки файла.

5. Загрузка данных и использование.

Сначала запрос, потом готовность.

Как понять, что лог готов

После создания лог-объекта вы получаете:

log_id - уникальный ID
status URL - endpoint для проверки статуса
href - ссылка для скачивания (когда лог будет готов)

Возможные статусы:

Статус	Что значит
ACCEPTED	генерация началась
READY	файл готов к скачиванию
FAILED	ошибка при генерации

Скачивать лог можно только в статусе READY.

Где брать файл и почему нельзя хардкодить ссылки

Когда лог готов, API возвращает:

location_csv или location_avro
это временная подписанная ссылка

Важно:

❗ путь к хранилищу ($LOG_STORAGE) может меняться
❗ нельзя писать код, завязанный на структуру URL
❗ всегда используйте ссылку, которую возвращает API

Это критично, если вы строите продакшн-автоматизацию.

Log API используется в автоматизации и автоправилах, и тут начинается самый интересный момент. В основном, делают так:

1. По расписанию вытаскивают события

2. Сливают их в хранилище

3. Смотрят на KPI в отчёте

4. Срабатывают правила

Какие могут быть примеры:

• отключение кампаний без конверсий

• проверка качества трафика по post-event

• сравнение источников на реальных событиях

• защита бюджета ночью и в выходные

• триггеры для скейла