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

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

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

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

Каталог содержит 84 поля: 8 общих и 76 полей отчёта.

## Общие поля

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Дата статистики | `stats_day` | Дата |
| Метка utm\_source | `utm_source` | Строка |
| Метка utm\_medium | `utm_medium` | Строка |
| Campaign ID в Google Analytics 4 | `utm_id` | Строка |
| Метка utm\_campaign | `utm_campaign` | Строка |
| Метка utm\_term | `utm_term` | Строка |
| Метка utm\_content | `utm_content` | Строка |
| Расходы (с учётом настроек) | `cost` | Дробное число |

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

## Расходы

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Расходы (нативное значение TikTok) | `spend` | Дробное число |
| Чистая стоимость | `billed_cost` | Дробное число |
| Стоимость, списанная деньгами | `cash_spend` | Дробное число |
| Стоимость, списанная ваучером | `voucher_spend` | Дробное число |

## Базовые метрики

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Количество показов | `impressions` | Целое число |
| Общие показы (включая недействительные) | `gross_impressions` | Целое число |
| Количество кликов | `clicks` | Целое число |
| Охват (уникальные пользователи) | `reach` | Целое число |

## Идентификация — рекламодатель

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Идентификатор рекламодателя | `advertiser_id` | Строка |
| Имя рекламодателя | `advertiser_name` | Строка |

## Идентификация — кампания

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Идентификатор кампании | `campaign_id` | Строка |
| Наименование кампании | `campaign_name` | Строка |
| Рекламная цель | `objective_type` | Строка |
| Статус сплит-теста | `split_test` | Строка |
| Бюджет кампании | `campaign_budget` | Дробное число |
| Тип кампании | `campaign_dedicate_type` | Строка |
| Тип продвижения приложения | `app_promotion_type` | Строка |

## Идентификация — группа объявлений

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Идентификатор группы объявлений | `adgroup_id` | Строка |
| Наименование группы объявлений | `adgroup_name` | Строка |
| Тип размещения | `placement_type` | Строка |
| Тип продвижения | `promotion_type` | Строка |
| Статус автооптимизации | `opt_status` | Целое число |
| URL группы объявлений | `adgroup_download_url` | Строка |
| Изображение профиля | `profile_image` | Строка |
| Тип целевой аудитории для DPA | `dpa_target_audience_type` | Строка |
| Бюджет группы объявлений | `budget` | Дробное число |
| Цель оптимизации | `smart_target` | Строка |
| Биллинговое событие | `billing_event` | Строка |
| Стратегия ставок | `bid_strategy` | Строка |
| Ставка | `bid` | Строка |
| Ставка на второстепенную цель | `bid_secondary_goal` | Строка |
| Тип оптимизации событий приложения | `aeo_type` | Строка |

## Идентификация — объявление

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Идентификатор объявления | `ad_id` | Строка |
| Наименование объявления | `ad_name` | Строка |
| Заголовок объявления | `ad_text` | Строка |
| Тип объявления | `ad_type` | Строка |
| Призыв к действию (CTA) | `call_to_action` | Строка |
| Изображение профиля (уровень объявления) | `ad_profile_image` | Строка |
| URL объявления | `ad_url` | Строка |
| Идентификатор приложения TikTok | `tt_app_id` | Строка |
| Наименование приложения TikTok | `tt_app_name` | Строка |
| Идентификатор мобильного приложения | `mobile_app_id` | Строка |
| Формат изображения | `image_mode` | Строка |
| Валюта | `currency` | Строка |
| Автоматизированное или умное объявление | `is_aco` | Логическое значение |
| Умное объявление | `is_smart_creative` | Логическое значение |

## Конверсии

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Количество конверсий | `conversion` | Целое число |
| Количество конверсий (real-time) | `real_time_conversion` | Целое число |
| Результаты | `result` | Целое число |
| Результаты (real-time) | `real_time_result` | Целое число |
| Результат глубокой воронки | `secondary_goal_result` | Целое число |

## Конверсионные события на целевой странице

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Завершённые платежи | `complete_payment` | Целое число |
| Общая стоимость завершённых платежей | `total_complete_payment_rate` | Дробное число |
| Просмотры целевой страницы | `total_landing_page_view` | Целое число |
| Просмотры страницы (всего) | `total_pageview` | Целое число |
| Общая ценность просмотров страницы | `total_value_per_pageview` | Дробное число |
| Нажатия кнопки на странице | `button_click` | Целое число |
| Общая ценность нажатий кнопки | `total_button_click_value` | Дробное число |

## Социальная активность

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Клики (все взаимодействия) | `engagements` | Целое число |
| Платные подписки | `follows` | Целое число |
| Платные лайки | `likes` | Целое число |
| Платные комментарии | `comments` | Целое число |
| Платные пересылки | `shares` | Целое число |
| Платные посещения профиля | `profile_visits` | Целое число |

## Клики, специфичные для TikTok

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Клики на звук | `clicks_on_music_disc` | Целое число |
| Клики на «Дуэт» | `duet_clicks` | Целое число |
| Клики на Stitch | `stitch_clicks` | Целое число |
| Клики на «Использовать звук» | `sound_usage_clicks` | Целое число |
| Клики по якорям рекламы | `anchor_clicks` | Целое число |
| Клики по хэштег-челленджу | `clicks_on_hashtag_challenge` | Целое число |
| Посещения страницы плейлиста | `tt_playlist_visit` | Целое число |

## Видео Instant Experience

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Воспроизведения видео | `ix_video_views` | Целое число |
| Просмотры до 25% | `ix_video_views_p25` | Целое число |
| Просмотры до 50% | `ix_video_views_p50` | Целое число |
| Просмотры до 75% | `ix_video_views_p75` | Целое число |
| Просмотры 100% | `ix_video_views_p100` | Целое число |