Трансформируем ваши данные в прибыль
Коннектор загружает статистику рекламных кампаний через API Яндекс Промо Страниц (создание отчёта, ожидание готовности, выгрузка JSON). За один запуск задачи выгружается ровно один тип отчёта (поле report_types); тип дублируется в колонке `promo_report_endpoint` в том же виде, что и в API — с дефисами (например, campaigns-publications-daily-stats).
Поля, которые доступны в рамках выбранного отчета.
Дневная статистика по выбранному типу отчёта (кампании, превью или публикации). Идентификаторы previewId / publicationId могут быть null в зависимости от типа.
| Поле | Название | Тип | Описание |
|---|---|---|---|
promo_report_endpoint | Тип отчёта API | String | Тип отчёта: campaigns-daily-stats, campaigns-previews-daily-stats или campaigns-publications-daily-stats |
smd_task_id | Идентификатор задачи SMD | String | Номер задачи импорта в StreamMyData |
smd_source_date | Дата источника SMD | String | Значение smd_source_date из настроек источника (как правило дата запуска/среза) |
campaignId | Идентификатор кампании | String | ID кампании в Промо Страницах |
publicationId | Идентификатор публикации | String | Заполняется для отчёта по публикациям; в других отчётах может быть null |
previewId | Идентификатор превью | String | Заполняется для отчёта по превью; в других отчётах может быть null |
mskDate | Дата (MSK) | Date | Календарная дата в часовом поясе Москвы, формат YYYY-MM-DD |
impressions | Показы | Int64 | Количество показов |
reach | Охват | Int64 | Охват аудитории |
budget | Бюджет | Float64 | Бюджет в денежных единицах (число с плавающей точкой в JSON API) |
cpm | CPM | Float64 | Стоимость тысячи показов |
clickouts | Клики по внешним ссылкам | Int64 | Количество переходов (clickouts) по ссылкам из промо-материала |
clickoutCost | Стоимость клика по ссылке | Float64 | Стоимость в денежных единицах |
clickoutPercent | Доля кликов по ссылке | Int64 | Процентное выражение (целое в ответе API) |
fullReads | Полные прочтения | Int64 | Количество полных прочтений материала |
fullReadPercent | Доля полных прочтений | Int64 | Процент полных прочтений |
ctr | CTR | Float64 | Кликабельность (отношение кликов к показам) |
videoExpands | Раскрытия видео | Int64 | Количество раскрытий видеоблока |
videoFullViews | Полные просмотры видео | Int64 | Количество досмотров видео до конца |
videoExpandPercent | Доля раскрытий видео | Int64 | Процент раскрытий |
videoFullViewPercent | Доля полных просмотров видео | Int64 | Процент полных просмотров |
metricaVisits | Визиты (Метрика) | Int64 | Визиты по данным Яндекс Метрики, связанным с размещением |
metricaVisitPercent | Доля визитов (Метрика) | Int64 | Процент визитов по Метрике |
metricaVisitCost | Стоимость визита (Метрика) | Float64 | Стоимость визита в денежных единицах |
Метод коннектора `get_campaigns_dataframe` возвращает полные объекты кампаний из GET /api/promo/v1/campaigns с пагинацией. В стандартном Celery-таске источника эта выгрузка в S3 не используется — только для кастомных сценариев.
| Поле | Название | Тип | Описание |
|---|---|---|---|
id | Идентификатор кампании | String | ID кампании |
publisherId | Идентификатор издателя | String | Добавляется коннектором при attach_publisher_id=True |
title | Название кампании | String | Человекочитаемое название |
type | Тип кампании | String | Тип размещения в API |
start | Дата начала | String | Дата/время начала кампании (строка из API) |
end | Дата окончания | String | Дата/время окончания кампании (строка из API) |
isArchived | Архивная кампания | UInt8 | Признак архивации |
strategy_name | Стратегия: название | String | Плоское поле после json_normalize(sep='_') из объекта strategy |
strategy_maxDailyMoney | Стратегия: дневной лимит бюджета | Float64 | Верхний предел дневных расходов |
strategy_maxMoney | Стратегия: общий лимит бюджета | Float64 | Общий лимит расходов по кампании |
strategy_fullReadCost | Стратегия: стоимость полного прочтения | Float64 | Цена полного прочтения |
strategy_fullViewCost | Стратегия: стоимость полного просмотра | Float64 | Цена полного просмотра |
strategy_impressionCost | Стратегия: стоимость показа | Float64 | Цена показа |
strategy_cpm | Стратегия: CPM | Float64 | Целевой или расчётный CPM в стратегии |
strategy_reachFrequency | Стратегия: частота охвата | Float64 | Параметр частоты охвата |
targeting_geo | Таргетинг: география | String | Сериализованное представление списка регионов после нормализации |
targeting_os | Таргетинг: ОС | String | Список ОС (после нормализации может быть строкой/JSON) |
targeting_gender | Таргетинг: пол | String | Сегменты по полу |
targeting_age | Таргетинг: возраст | String | Возрастные сегменты |
publications | Публикации | String | Вложенный массив публикаций; в таблице может храниться как JSON-строка |
