В этой статье собраны все поля, которые коннектор TikTok Ads выгружает в хранилище ROMI center. О периодичности выгрузки и сборке UTM-меток — в статье TikTok Ads: как работает коннектор.
Как читать таблицу:
- Название — подпись поля в визарде подключения.
- Колонка в БД — имя колонки в таблице хранилища; у 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 | Целое число |
