Считайте расход и конверсии кампаний Яндекс Директа

Агент работает с API Директа пятой версии на https://api.direct.yandex.com/json/v5: кампании, группы, объявления, ключевые фразы и автотаргетинги со ставками, минус-фразы, портфельные стратегии, корректировки, справочники регионов и отчёты. Из этого он собирает расход, показы, клики, CTR и конверсии за период, спускается с уровня кампании до отдельной фразы и до реального поискового запроса и находит то, что тратит бюджет и не приносит ни одной конверсии.

Включённая кампания в Директе не значит работающую: состояние и статус здесь разные вещи, и кампания может стоять из-за отклонённой модерации, исчерпанного дневного бюджета или пустого счёта, оставаясь при этом «включённой». Агент смотрит оба поля вместе со статусом оплаты и называет настоящую причину остановки. Статистика за текущий день ещё дописывается, поэтому сравнения он строит по закрытым дням и всегда называет период, за который взял цифры.

Единая перфоманс-кампания живёт на отдельном адресе API, а прежние динамические кампании и смарт-баннеры в неё переведены и заново не создаются. Агент читает такие кампании там, где они действительно лежат, и не выдаёт «ничего не нашлось» за отсутствие рекламы. Автотаргетинг он показывает наравне с фразами: в ЕПК он включён по умолчанию, и расход без единой ключевой фразы обычно именно он.

Менять ставки и останавливать кампании агент может, если у логина есть право на редактирование: права переносятся из веб-интерфейса один в один, и при доступе только на чтение остаётся аналитика. Но ставка — это деньги в реальном времени, поэтому агент сначала показывает текущее значение, предлагаемое и число затронутых фраз, ждёт подтверждения и перечитывает результат после применения, а не считает успехом сам факт принятого запроса: Директ отвечает «успешно» и на пачку, где часть строк отклонена.

Подключение идёт подтверждением кода на странице Яндекса — токены копировать не нужно, дальше доступ продлевается сам. Директ считает баллы Units с суточной квотой: каждый запрос стоит баллов, а неудачный — двадцати, поэтому агент просит только нужные поля и не долбит API одним и тем же битым телом. Параллельных запросов не больше пяти, так что выборки он дробит постранично, тяжёлые отчёты заказывает в офлайн-режиме и дожидается готовности, а о нехватке данных или прав говорит прямо.