# Яндекс Директ: описание выгружаемых полей

В этой статье собраны все поля, которые коннектор Яндекс Директа выгружает в хранилище ROMI center. О том, с какой периодичностью идёт выгрузка и как устроена сама таблица, — в статье [Яндекс Директ: как работает коннектор](https://help-ru.romi.center/yandex-direct-kak-rabotaet-konnektor).

Как читать таблицу:

*   **Название** — подпись поля в визарде подключения.
*   **Колонка в БД** — имя колонки в таблице хранилища.
*   **Поле 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` в основном отчёте не запрашиваются — их значения подставляются из справочника кампаний.