Как отслеживать события кампаний в 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

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

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

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

Без логов автоправила слепые.
Есть логи – алгоритмы по настоящему работают на реальных данных, а не на усреднённых.

Связка Log API + автоправила

Logs → база данных → KPI → правила → действие через API

Это фундамент любой серьёзной автоматизации в Moloco.

Итог

Log API – это не просто «выгрузка CSV».

Это:

• основа для автоправил
• источник точных данных
• способ контролировать рекламу вне интерфейса
• ключ к масштабированию без ручного труда

Если вы хотите:

• строить умную оптимизацию
• реагировать быстрее конкурентов
• перестать кликать и начать управлять

– без Log API это сделать невозможно.\

 

Spendy – Прилы под Молоко ФБ Гугл 
PRIMAX – MOLOCO агенство 3-6%
White.expert – приватный генератор вайтов