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

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

Фиксированного набора колонок нет: таблица собирается под поля, отмеченные в настройках. Ниже — весь список полей обеих таблиц, а также колонки целей и валют, которые добавляются по настройкам. Колонка `Date` есть в обеих таблицах всегда — даже если поле «Дата» не отмечено.

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

*   **Название** — подпись поля на шаге «Выбор полей».
*   **Колонка в БД** — имя колонки в таблице хранилища; то же имя визард показывает в столбце «Тех. название».
*   **Поле API** — имя поля в документации API отчётов Метрики. В полях со словом `attribution` оно при запросе заменяется моделью атрибуции: `ym:s:attributionUTMSource` уходит в Метрику как `ym:s:lastsignUTMSource`, `ym:s:firstUTMSource` или `ym:s:automaticUTMSource`.
*   **Тип поля** — смысловой тип. Все метрики — дробные числа, даже счётчики визитов.

## Визиты — таблица `…_visits_…`

Полей: 29.

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Визиты | `visits` | `ym:s:visits` | Дробное число |
| Просмотры | `pageviews` | `ym:s:pageviews` | Дробное число |
| Посетители | `ym_s_users` | `ym:s:users` | Дробное число |
| Глубина просмотра | `ym_s_pageDepth` | `ym:s:pageDepth` | Дробное число |
| Отказы | `ym_s_bounceRate` | `ym:s:bounceRate` | Дробное число |
| Время на сайте | `ym_s_avgVisitDurationSeconds` | `ym:s:avgVisitDurationSeconds` | Дробное число |
| Визиты роботов | `ym_s_robotVisits` | `ym:s:robotVisits` | Дробное число |
| Дата | `Date` | `ym:s:date` | Дата |
| Источник трафика | `TrafficSource` | `ym:s:attributionTrafficSource` | Строка |
| Источник трафика (имя) | `ym_s_attributionTrafficSourceName` | `ym:s:attributionTrafficSourceName` | Строка |
| Источник трафика (детально) | `SourceEngine` | `ym:s:attributionSourceEngine` | Строка |
| Источник трафика (детально, имя) | `ym_s_attributionSourceEngineName` | `ym:s:attributionSourceEngineName` | Строка |
| UTMSource | `UTMSource` | `ym:s:attributionUTMSource` | Строка |
| UTMMedium | `UTMMedium` | `ym:s:attributionUTMMedium` | Строка |
| UTMCampaign | `UTMCampaign` | `ym:s:attributionUTMCampaign` | Строка |
| UTMContent | `UTMContent` | `ym:s:attributionUTMContent` | Строка |
| UTMTerm | `UTMTerm` | `ym:s:attributionUTMTerm` | Строка |
| Поисковая система | `ym_s_attributionSearchEngineRoot` | `ym:s:attributionSearchEngineRoot` | Строка |
| Поисковая система (детально) | `ym_s_attributionSearchEngine` | `ym:s:attributionSearchEngine` | Строка |
| Поисковая фраза | `ym_s_attributionSearchPhrase` | `ym:s:attributionSearchPhrase` | Строка |
| Континент | `ym_s_regionContinent` | `ym:s:regionContinent` | Строка |
| Страна | `ym_s_regionCountry` | `ym:s:regionCountry` | Строка |
| Округ | `ym_s_regionDistrict` | `ym:s:regionDistrict` | Строка |
| Область | `ym_s_regionArea` | `ym:s:regionArea` | Строка |
| Город | `ym_s_regionCity` | `ym:s:regionCity` | Строка |
| Тип устройства | `ym_s_deviceCategory` | `ym:s:deviceCategory` | Строка |
| Пол | `ym_s_gender` | `ym:s:gender` | Строка |
| ClientID | `ym_s_clientID` | `ym:s:clientID` | Строка |
| Роботность | `ym_s_isRobot` | `ym:s:isRobot` | Строка |

## Расходы — таблица `…_cost_…`

Полей: 16.

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Расходы | `cost` | `ym:ev:expensesRUB` | Дробное число |
| Клики | `clicks` | `ym:ev:expenseClicks` | Дробное число |
| Визиты | `visits` | `ym:ev:visits` | Дробное число |
| Просмотры | `pageviews` | `ym:ev:pageviews` | Дробное число |
| Посетители | `ym_ev_users` | `ym:ev:users` | Дробное число |
| Отказы | `ym_ev_bounceRate` | `ym:ev:bounceRate` | Дробное число |
| Глубина просмотра | `ym_ev_pageDepth` | `ym:ev:pageDepth` | Дробное число |
| Визиты роботов | `ym_ev_robotVisits` | `ym:ev:robotVisits` | Дробное число |
| Дата | `Date` | `ym:ev:date` | Дата |
| TrafficSource | `TrafficSource` | `ym:ev:attributionTrafficSource` | Строка |
| SourceEngine | `SourceEngine` | `ym:ev:attributionSourceEngine` | Строка |
| UTMSource | `UTMSource` | `ym:ev:attributionUTMSource` | Строка |
| UTMMedium | `UTMMedium` | `ym:ev:attributionUTMMedium` | Строка |
| UTMCampaign | `UTMCampaign` | `ym:ev:attributionUTMCampaign` | Строка |
| UTMContent | `UTMContent` | `ym:ev:attributionUTMContent` | Строка |
| UTMTerm | `UTMTerm` | `ym:ev:attributionUTMTerm` | Строка |

## Колонки целей — таблица визитов

На каждую цель — четыре колонки. Имя колонки собирается из транслитерации названия цели и метрики: цель «Оставить заявку» даёт `Tsel_Ostavit_zayavku_Dostizheniya_tseli` и три соседние.

| Метрика | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Целевые посетители | `Tsel_<цель>_Tselevye_posetiteli` | `ym:s:goal<id цели>users` | Дробное число |
| Целевые визиты | `Tsel_<цель>_Tselevye_vizity` | `ym:s:goal<id цели>visits` | Дробное число |
| Достижения цели | `Tsel_<цель>_Dostizheniya_tseli` | `ym:s:goal<id цели>reaches` | Дробное число |
| Доход по цели | `Tsel_<цель>_Dohod_po_tseli` | `ym:s:goal<id цели>convertedRUBRevenue` | Дробное число |

> **Примечание**
> С конвертацией валют вместо колонки дохода появляется по колонке на валюту — `Tsel_<цель>_Dohod_po_tseli_<валюта>`. Название цели входит в имя колонки: у выбранных целей оно фиксируется при сохранении подключения, а переименование в Метрике подхватится только при следующем сохранении — новой колонкой.

## Колонки валют — таблица расходов

| Колонка в БД | Поле API | Тип поля |
| --- | --- | --- |
| `cost_<валюта>` | `ym:ev:expenses<валюта>` | Дробное число |

Появляются вместо колонки `cost`, когда включена конвертация валют: по колонке на каждую выбранную валюту, например `cost_USD`.
