Яндекс Маркет открыл рекламодателям отчёты через API: расходы и результаты можно собирать автоматически
Июньское обновление API позволило получать отчёты рекламодателя по счёту маркетинга, охватным инструментам, полкам и бустам. Для этого используется sourceType=ADVERTISER.
Содержание статьи
Июньское обновление API позволило получать отчёты рекламодателя по счёту маркетинга, охватным инструментам, полкам и бустам. Для этого используется sourceType=ADVERTISER.
Какие данные стали доступны
4 июня официальный канал API Маркета сообщил об обновлении интеграции от 3 июня. Рекламодатели получили возможность автоматически формировать отчёты по счёту маркетинга, охватному продвижению, полкам, бусту показов и бусту продаж. В соответствующих методах нужно передавать sourceType со значением ADVERTISER.
Соседнее сообщение об изменении от 2 июня описало отдельный метод детализации счёта маркетинга и удаление MARKETING из прежнего параметра contractType общего отчёта. Оба изменения относятся к новой организации рекламной отчётности и рассматриваются здесь вместе.
Роль рекламодателя нужно указать явно
Одинаковое название отчёта не означает одинаковый контекст получения данных. Интеграция должна запрашивать сведения для правильного источника и учётной записи. Если параметр не передан либо выбран неверно, команда рискует сравнивать разные наборы операций или не получить ожидаемую детализацию.
Первую выгрузку полезно сверить с интерфейсом кабинета на одном завершённом периоде. Следует сравнить расходы, состав кампаний и даты, а также убедиться, что отчёт относится к нужному рекламодателю. Такой контроль важнее немедленного подключения всей истории к общей панели.
Как связать расходы с результатами
Счёт маркетинга и статистика показов решают разные задачи. Первый помогает сверять начисления, вторая — изучать рекламное поведение. Их соединение требует согласованного периода и идентификаторов; само наличие двух файлов не делает суммы автоматически сопоставимыми.
Особенно важно различать расходы, заказы и выручку, отнесённую к рекламе. При совместной работе нескольких инструментов простое сложение приписанных продаж может дать повторный учёт. Методика итогового отчёта должна объяснять, какие показатели складываются, а какие используются только для сравнения каналов.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы