Adset.ProAdset.ProKnowledge base
RUEN
To app
Home/Інтеграції/Підтягування витрат (костів) з TikTok в Adset pro

Підтягування витрат (костів) з TikTok в Adset pro

Керівництво користувача: як підключити TikTok Ads, щоб рекламні витрати автоматично потрапляли в Adset.pro і зводилися з трафіком і конверсіями по ваших кампаніях.

Що це і навіщо

Adset.pro підтягує рекламні витрати (spend), покази і кліки з TikTok Ads і зводить їх з вашим трафіком і конверсіями. В результаті ви бачите ROI/профіт по кампаніях без ручного експорту з TikTok Ads Manager.

Де з'являються дані:

  • Розділ Meta (меню → Meta): таблиці Кабінети → Кампанії → Групи оголошень → Реклама — витрата, покази, кліки по кожній сутності TikTok.
  • Звіти по кампаніях трекера — витрата додається до вартості трафіку (cost), якщо налаштовано маппінг макросів (див. нижче). Так рахується загальний профіт «трафік + площадка».

Як підключається TikTok

На відміну від Facebook, для TikTok доступний один спосіб підключення — OAuth-авторизація: ви один раз авторизуєте доступ Adset.pro до своїх рекламних кабінетів, далі синхронізація повністю автоматична за розкладом (15/30/60 хвилин, в залежності від тарифу). Створювати свій додаток TikTok або отримувати токени вручну не потрібно.

Список рекламодавців (advertiser'ів) підтягується автоматично при авторизації — всі кабінети, до яких ви надали доступ, будуть синхронізуватися.

Загальне налаштування

Щоб витрата не тільки з'явилася в розділі Meta, але і прив'язалася до ваших кампаній в звітах трекера, виконайте підготовку.

1. Соц-профіль і джерело трафіку

  • Відкрийте Meta → Соціальні профілі і створіть профіль з типом TikTok.
  • У профілю має бути вказано джерело трафіку (Source) — той, по якому ллєте трафік з цього акаунта.

2. Маппінг макросів в джерелі (важливо!)

В налаштуваннях джерела трафіку замапте хоча б один TikTok-макрос на параметр (slot):

Макрос TikTok Що це Куди маппити
__CAMPAIGN_ID__ ID кампанії TikTok sub / utm (напр. utm_campaign)
__AID__ ID групи оголошень (Ad Group) sub / utm (напр. sub3)
__CID__ ID оголошення/креативу sub / utm (напр. utm_content)

Рекомендується замапити всі три. Ці ж макроси повинні стояти в кліковому посиланні вашої кампанії — тоді витрата зійдеться з трафіком по одній осі. Якщо ви додаєте джерело з шаблону TikTok, потрібні макроси вже проставлені.

Без маппінга витрата все одно потрапить в таблиці розділу Meta, але не з'явиться в звіті по кампанії — у системи не буде осі, щоб прив'язати витрату до трафіку.

3. Прив'язка оголошень до кампаній

Adset.pro визначає вашу кампанію по цільовому посиланню оголошення (landing page URL). Працюють три механізми, в порядку пріоритету:

  1. Пряме посилання трекера. В landing page URL оголошення стоїть посилання виду …/track/<id>/ads або …/<аліас> — оголошення прив'яжеться автоматично.
  2. Маркер adset_cid — для трафіку через клоаку. Якщо в TikTok вставлене посилання клоак-сервісу, допишіть до нього GET-параметр adset_cid=<ID кампанії>, наприклад: https://cloak.example/abc?adset_cid=68a1f3…. Готове значення копіюється в редакторі кампанії: крок «Посилання» → блок «Маркер кампанії для клоак-сервісів». Параметру достатньо бути присутнім у посиланні оголошення — прокидати його через клоаку на трекер не потрібно. Прив'язка спрацює тільки для кампанії вашої команди. Маркер працює і для Facebook-оголошень.
  3. Автоприв'язка по клікам. Якщо виконаний Крок 2 (макроси замаплені) і по оголошенню вже проходять кліки, система прив'яже його до кампанії автоматично по фактичному трафіку (враховуються кліки за останні 30 днів; якщо один креатив лив на різні кампанії — береться кампанія останнього кліка). Пряме посилання і маркер пріоритетніші за автоприв'язку.

Оголошення, не прив'язані жодним зі способів, видимі тільки в таблицях розділу Meta — без витрат в звітах трекера.

OAuth-авторизація акаунта

  1. В Adset.pro: Meta → Соціальні профілі → створити профіль, тип — TikTok, вкажіть джерело трафіку і збережіть.
  2. Відкрийте профіль на редагування — з'явиться блок «OAuth-авторизація».
  3. Натисніть «Авторизувати» — система згенерує посилання авторизації TikTok. Скопіюйте його кнопкою «Копіювати посилання».
  4. Відкрийте посилання в антидетект-браузері, в профілі якого залогінений потрібний акаунт TikTok Ads (TikTok For Business).
  5. Підтвердіть доступ на сторінці TikTok. Після підтвердження вкладка закриється автоматично.
  6. Поверніться в Adset.pro і оновіть діалог профілю: статус повинен змінитися на Authorized, нижче з'являться Advertiser IDs — рекламні кабінети, до яких видано доступ.

Токен продовжується автоматично — повторна авторизація в нормі не потрібна. Якщо акаунт довго неактивний (близько року) або доступ відкликано на стороні TikTok, статус зміниться на Expired/Revoked — просто пройдіть авторизацію заново тим же способом.

Інтервал синхронізації

В налаштуваннях профілю виберіть інтервал синхронізації витрат — 15 / 30 / 60 хвилин (доступні значення залежать від тарифу). Для оперативних витрат вибирайте 15 або 30 хвилин. Всі кабінети (advertiser'и) цього профілю синхронізуються автоматично.

Запустити синхронізацію вручну можна зі списку профілів: меню рядка → Sync (доступно для авторизованих профілів). Ручний запуск оновить і структуру (кабінети/кампанії/групи/оголошення), і витрати.

Вікно дат і періодичність

  • Синхронізується поточний день + ретро: при першому синку — останні ~7 днів, далі «перекриття» ~3 дні. Це потрібно, щоб підхоплювати правки даних TikTok заднім числом.
  • Сьогоднішні цифри в TikTok неостаточні і доуточнюються впродовж дня — Adset.pro дозаливає їх при кожному синку. При частому ресинку (15/30 хв) дані за сьогодні з'являються і оновлюються оперативно.
  • Структура (кабінети → кампанії → групи → оголошення) оновлюється автоматично раз на годину; витрати — по вибраному інтервалу.
  • Час витрат приводиться до UTC з урахуванням таймзони рекламного кабінету (включаючи переходи на літній/зимовий час).

Де дивитися витрату

  • Meta → Кабінети / Кампанії / Групи / Реклама — витрата, покази, кліки по сутностях TikTok.
  • Фільтр «Соціальний профіль» наверху таблиць — виберіть TikTok-профіль, щоб бачити тільки його дані.
  • Звіти по кампаніях трекера — витрата додається до вартості (якщо виконаний Крок 2 розділу «Загальне налаштування»).

Часті питання і рішення

Авторизував акаунт, але витрати ніде немає.

Перевірте по порядку: 1) статус профілю — Authorized, в блоці OAuth видно Advertiser IDs; 2) чи пройшов перший структурний синк — кабінети/кампанії з'являються в розділі Meta впродовж години (або натисніть Sync вручну); 3) вибраний інтервал — витрати приїжджають за розкладом 15/30/60 хвилин.

Витрата є в таблицях Meta, але в звіті по кампанії її немає.

Не налаштований маппінг TikTok-макросів в джерелі (Крок 2 розділу «Загальне налаштування»), або оголошення не прив'язане до вашої кампанії — в landing page URL оголошення немає посилання трекера або маркера adset_cid (Крок 3). Перевірте джерело і цільове посилання оголошення. Якщо ллєте через клоаку — див. наступне питання.

Ллю через клоаку — оголошення не прив'язуються до кампанії.

В landing page URL оголошення стоїть посилання клоак-сервісу, і трекерне посилання в ньому система не бачить. Два рішення:

  1. Допишіть до посилання клоаки GET-параметр adset_cid=<ID кампанії> — готове значення копіюється в редакторі кампанії (крок «Посилання», блок «Маркер кампанії для клоак-сервісів»). Прив'язка з'явиться після найближчого оновлення структури (до години або по кнопці Sync).
  2. Якщо TikTok-макроси замаплені в джерелі (Крок 2) і по оголошенню вже йдуть кліки — прив'язка відбудеться автоматично по фактичному трафіку при черговому синку витрат.

Зверніть увагу: витрата дозаливається заднім числом в межах ~3 днів — більш старі витрати після появи прив'язки автоматично не допишуться.

Статус профілю — Error, в підказці текст помилки.

Синхронізація впала і буде повторена автоматично. Якщо помилка не зникає і статус OAuth змінився на Expired/Revoked — токен недійсний (пароль/права змінилися на стороні TikTok): пройдіть авторизацію заново, статус і синк відновляться.

Після авторизації порожній список Advertiser IDs.

На кроці підтвердження в TikTok не були вибрані рекламні кабінети, або у акаунта немає прав на них. Пройдіть авторизацію заново і переконайтеся, що потрібні кабінети відмічені на сторінці підтвердження доступу.

Дані TikTok і Adset.pro не сходяться «копійка в копійку».

Це нормально: TikTok доуточнює сьогоднішні/недавні цифри заднім числом, а Adset.pro синхронізується із затримкою і перекриттям. Також зверніть увагу на таймзону: TikTok Ads Manager показує дані в таймзоні кабінету, а Adset.pro — в обраній вами таймзоні звіту. Остаточні суми сходяться по мірі «дозрівання» даних.

Безпека

  • Токени доступу TikTok зберігаються в зашифрованому вигляді і не відображаються в інтерфейсі.
  • Доступ видається тільки на читання звітів і структури рекламних кабінетів — Adset.pro не змінює ваші кампанії.
  • Відкликати доступ можна в будь-який момент на стороні TikTok (TikTok For Business → Налаштування → Авторизовані додатки) — синхронізація зупиниться, профіль перейде в статус Revoked.