Сущности и поля TikTok Ads
Иерархия: advertiser → campaign → adgroup → ad. Уровни отчёта: AUCTION_ADVERTISER / AUCTION_CAMPAIGN / AUCTION_ADGROUP / AUCTION_AD.
Иерархия
Advertiser
└── Campaign
└── AdGroup (aliases: adset_*)
└── AdAdvertiser
| Ключ | Название | Тип | Фильтрация | Сортировка |
|---|---|---|---|---|
account_id | ID аккаунта | string | Да | Нет |
account_name | Название аккаунта | string | Да | Да |
account_status | Статус | string | Нет | Нет |
account_currency | Валюта | string | Нет | Нет |
date_start | Дата | date | Да | Да |
date_stop | Дата окончания | date | Нет | Нет |
date_start ← stat_time_day. При дневной агрегации date_stop = date_start.
Кампания (campaign)
| Ключ | Название | Тип | Фильтрация | Сортировка |
|---|---|---|---|---|
campaign_id | ID кампании | string | Да | Нет |
campaign_name | Название кампании | string | Да | Да |
Группа (adgroup)
Aliases: adset_id / adset_name ← adgroup_id / adgroup_name.
| Ключ | Название | Тип | API | Фильтрация | Сортировка |
|---|---|---|---|---|---|
adset_id | ID группы | string | adgroup_id | Да | Нет |
adset_name | Название группы | string | adgroup_name | Да | Да |
Объявление (ad)
| Ключ | Название | Тип | Фильтрация | Сортировка |
|---|---|---|---|---|
ad_id | ID объявления | string | Да | Нет |
ad_name | Название объявления | string | Да | Да |
Метрические поля в строке
Также в строке отчёта: spend, impressions, clicks, ctr, cpc, cpm, conversions/results, cost_per_result, reach, frequency.
Нормализация: normalizeTikTokReportRow + проверка code: 0 через normalizeTikTokApiPayload.