# Google Analytics 4: описание выгружаемых полей

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

Колонки таблицы — это `stats_day`, отмеченные на шаге «Выбор полей» поля, колонки целей и служебные. Имена колонок латинские, как в Google Analytics Data API. В «Просмотре данных» у полей и даты есть русские подписи, колонки целей показываются под техническими именами, а служебные `rc_*` там скрыты.

## Дата

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Дата | `stats_day` | Дата |

Это день статистики в часовом поясе ресурса GA4.

## Метрики

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Активные пользователи | `activeUsers` | Целое число |
| Клики | `advertiserAdClicks` | Целое число |
| Стоимость | `advertiserAdCost` | Дробное число |
| Сессии | `sessions` | Целое число |

Стоимость приходит в валюте ресурса GA4. Клики и стоимость заполнены не у всех ресурсов: если рекламные расходы в GA4 не импортируются, в этих колонках будут только нули и пустые значения. Если выбран «Тип устройства», клики и стоимость попадают только в строки с пустым типом устройства.

> **Важно**
> Активных пользователей нельзя складывать по строкам и дням: один человек, заходивший с двух устройств, из двух источников или в разные дни, посчитается несколько раз.

> **Важно**
> В таблицах подключений, где набор полей не сужали, есть ещё колонка `CPC` — она всегда пустая: из GA4 такой показатель не запрашивается и в хранилище не рассчитывается.

## Группировки

| Название | Колонка в БД | Тип поля | Что внутри |
| --- | --- | --- | --- |
| Тип устройства | `deviceCategory` | Строка | `desktop`, `mobile`, `tablet`, `smart tv` |
| Рекламная кампания (Utm\_Campaign) | `sessionCampaignName` | Строка | Кампания сессии, UTM-метка `campaign` |
| Тип трафика (Utm\_Medium) | `sessionMedium` | Строка | UTM-метка `medium` |
| Источник трафика (Utm\_Source) | `sessionSource` | Строка | UTM-метка `source` |
| Source / Medium | `sessionSourceMedium` | Строка | Источник и канал одной строкой, например `google / cpc` |

Где UTM-меток нет, GA4 пишет служебные значения в скобках: прямые заходы — `(direct)` и `(none)`, кампания поискового и ссылочного трафика — `(organic)` и `(referral)`, неизвестное значение — `(not set)`.

## Колонки целей

На каждую цель заводится четыре колонки, в имени — идентификатор события из GA4:

| Колонка в БД | Тип поля | Что внутри |
| --- | --- | --- |
| `conversions_<id цели>` | Целое число | Сколько раз достигнута цель |
| `purchaseRevenue_<id цели>` | Дробное число | Доход по покупкам: заполнен у события `purchase`, у остальных целей — ноль или пусто |
| `eventValue_<id цели>` | Дробное число | Ценность события, если она передана в GA4 |
| `ROMI_<id цели>` | Дробное число | Всегда пусто: колонка заводится вместе с целью, но значение в неё не пишется |

Целями считаются только события, отмеченные в GA4 как ключевые: обычные события в список на шаге «Дополнительные настройки» не попадают и в таблицу не выгружаются.

Какому событию соответствует идентификатор в имени колонки, видно в настройках подключения: на шаге «Дополнительные настройки» у каждого ключевого события ресурса рядом с названием указан ID — в том числе когда цели не выбраны и выгружаются все.