В этой статье собраны все поля, которые коннектор Яндекс Директа выгружает в хранилище ROMI center. О том, с какой периодичностью идёт выгрузка и как устроена сама таблица, — в статье Яндекс Директ: как работает коннектор.
Как читать таблицу:
- Название — подпись поля в визарде подключения.
- Колонка в БД — имя колонки в таблице хранилища.
- Поле API — имя поля в отчёте Яндекс Директа.
—— поле собирается на стороне ROMI center, в API его нет. - Тип поля — смысловой тип, его показывает интерфейс.
Важно
Числами хранятся только «Стоимость кликов», «Количество кликов», «Количество показов» и дата статистики. Все остальные поля хранятся строками, поэтому считать по ним что-либо нужно с явным приведением типа в отчёте или трансформации.
Всего в схеме 57 полей.
Время
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Дата статистики | stats_day | Date | Дата |
UTM-метки
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Campaign ID в Google Analytics 4 (utm_id) | utm_id | — | Строка |
| Метка utm_source | utm_source | — | Строка |
| Метка utm_medium | utm_medium | — | Строка |
| Метка utm_campaign | utm_campaign | — | Строка |
| Метка utm_term | utm_term | — | Строка |
| Метка utm_content | utm_content | — | Строка |
Кампания
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Идентификатор кампании | campaign_id | CampaignId | Строка |
| Название кампании | campaign_name | CampaignName | Строка |
| Тип кампании | campaign_type | CampaignType | Строка |
| URL кампании | campaign_url_path | CampaignUrlPath | Строка |
| Логин главного представителя клиента | client_login | ClientLogin | Строка |
Группа объявлений
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Идентификатор группы объявлений | ad_group_id | AdGroupId | Строка |
| Название группы объявлений | ad_group_name | AdGroupName | Строка |
Объявление
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Идентификатор объявления | ad_id | AdId | Строка |
| Формат показа объявления | ad_format | AdFormat | Строка |
| Тип площадки | ad_network_type | AdNetworkType | Строка |
Условие показа
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Условие показа | criterion | Criterion | Строка |
| Идентификатор условия показа | criterion_id | CriterionId | Строка |
| Тип условия показа | criterion_type | CriterionType | Строка |
| Тип соответствия ключевой фразе | match_type | MatchType | Строка |
| Название площадки показов | placement | Placement | Строка |
| Блок показа объявления | slot | Slot | Строка |
Таргетинг
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Категория таргетинга | targeting_category | TargetingCategory | Строка |
| Идентификатор региона таргетинга | targeting_location_id | TargetingLocationId | Строка |
| Название региона таргетинга | targeting_location_name | TargetingLocationName | Строка |
| Идентификатор условия ретаргетинга и подбора аудитории | rl_adjustment_id | RlAdjustmentId | Строка |
Аудитория
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Возрастная группа пользователя | age | Age | Строка |
| Пол пользователя | gender | Gender | Строка |
| Уровень платежеспособности пользователя | income_grade | IncomeGrade | Строка |
| Идентификатор региона местонахождения | location_of_presence_id | LocationOfPresenceId | Строка |
| Название региона местонахождения | location_of_presence_name | LocationOfPresenceName | Строка |
Устройство и площадка
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Тип устройства | device | Device | Строка |
| Тип операционной системы | mobile_platform | MobilePlatform | Строка |
| Тип связи | carrier_type | CarrierType | Строка |
| Наименование внешней сети (SSP) | external_network_name | ExternalNetworkName | Строка |
Метрики — показы и клики
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Количество кликов | clicks | Clicks | Целое число |
| Количество показов | impressions | Impressions | Целое число |
| CTR (кликабельность) | ctr | Ctr | Целое число |
| Взвешенный CTR | weighted_ctr | WeightedCtr | Целое число |
| Взвешенные показы | weighted_impressions | WeightedImpressions | Целое число |
| Средняя позиция клика | avg_click_position | AvgClickPosition | Целое число |
| Средняя позиция показа | avg_impression_position | AvgImpressionPosition | Целое число |
Метрики — расходы
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Стоимость кликов | cost | Cost | Дробное число |
| Средняя стоимость клика | avg_cpc | AvgCpc | Дробное число |
| Средняя ставка за клик | avg_effective_bid | AvgEffectiveBid | Дробное число |
| Средняя стоимость целевого визита | cost_per_conversion | CostPerConversion | Дробное число |
Метрики — поведение
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Количество визитов | sessions | Sessions | Целое число |
| Количество отказов | bounces | Bounces | Целое число |
| Доля отказов | bounce_rate | BounceRate | Целое число |
| Средняя глубина просмотра | avg_pageviews | AvgPageviews | Целое число |
| Средний объём трафика | avg_traffic_volume | AvgTrafficVolume | Целое число |
Метрики — конверсии
| Название | Колонка в БД | Поле API | Тип поля |
|---|---|---|---|
| Количество конверсий | conversions | Conversions | Целое число |
| Доля конверсий | conversion_rate | ConversionRate | Целое число |
| Доход по целям | revenue | Revenue | Дробное число |
| Прибыль | profit | Profit | Дробное число |
| ROI, рентабельность инвестиций в рекламу | goals_roi | GoalsRoi | Целое число |
Примечание
Цели и модель атрибуции в запросе к Яндекс Директу не задаются — конверсионные метрики приходят такими, какими их отдаёт Яндекс Директ по умолчанию.
Служебные и вычисляемые колонки
| Название | Колонка в БД | Примечание |
|---|---|---|
| Расход в дополнительной валюте | cost_converted_<валюта> | по одной колонке на каждую выбранную валюту |
| Идентификатор прогона выгрузки | rc_import_id | |
| Время записи в хранилище | rc_created_at |
Поля, которых нет в отчёте статистики
CampaignName, CampaignType, CampaignUrlPath в основном отчёте не запрашиваются — их значения подставляются из справочника кампаний.
