# Telegram Ads: описание выгружаемых полей

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

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

*   **Название** — подпись поля в визарде подключения.
*   **Колонка в БД** — имя колонки в таблице хранилища.
*   **Тип поля** — смысловой тип.

Каталог у Telegram Ads самый маленький в серии — 22 поля: 8 общих и 14 по выбору.

## Общие поля

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Дата | `stats_day` | Дата |
| UTM Source | `utm_source` | Строка |
| UTM Medium | `utm_medium` | Строка |
| UTM Id | `utm_id` | Строка |
| UTM Campaign | `utm_campaign` | Строка |
| UTM Term | `utm_term` | Строка |
| UTM Content | `utm_content` | Строка |
| Расход | `cost` | Дробное число |

> **Примечание**
> `cost` — потраченный бюджет объявления за день в евро, умноженный на ставку НДС из настроек. Пересчёта в рубли нет — для другой валюты нужна настройка конвертации.

## Расходы и метрики

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Показы | `views` | Целое число |
| Клики | `clicks` | Целое число |
| Подписки | `joined` | Целое число |

## Информация об объявлении

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Название объявления | `title` | Строка |
| Текст объявления | `ad_text` | Строка |
| Целевой URL | `promote_url` | Строка |
| Название сайта | `website_name` | Строка |
| Есть изображение | `has_picture` | Логическое значение |

## Бюджет и стоимость

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| CPM (EUR) | `cpm_in_euro` | Дробное число |
| Лимит показов на пользователя в день | `daily_view_user_limit` | Целое число |
| Текущий лимит бюджета | `current_budget_limit` | Дробное число |

## Таргетинг

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Каналы, на которые таргетируемся | `target_specific_channels` | Строка |
| Каналы-исключения | `exclude_specific_channels` | Строка |

## Прочее

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Дополнительная информация | `other_information` | Строка |

> **Примечание**
> Поля разделов «Информация об объявлении», «Бюджет и стоимость», «Таргетинг» и «Прочее» — не статистика, а настройки объявления на момент выгрузки: они берутся из карточки в кабинете и повторяются одинаковыми во всех строках объявления за день. Если рекламодатель изменит текст, лимит или список каналов, в старых днях останутся значения, актуальные на момент последней перезаписи этого дня.
