В этой статье собраны все поля, которые коннектор Telegram Ads выгружает в хранилище ROMI center. О периодичности выгрузки и сборке UTM-меток — в статье Telegram Ads: как работает коннектор.
Как читать таблицу:
- Название — подпись поля в визарде подключения.
- Колонка в БД — имя колонки в таблице хранилища.
- Тип поля — смысловой тип.
Каталог у 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 | Строка |
Примечание
Поля разделов «Информация об объявлении», «Бюджет и стоимость», «Таргетинг» и «Прочее» — не статистика, а настройки объявления на момент выгрузки: они берутся из карточки в кабинете и повторяются одинаковыми во всех строках объявления за день. Если рекламодатель изменит текст, лимит или список каналов, в старых днях останутся значения, актуальные на момент последней перезаписи этого дня.
