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 кампании TikToksub / 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.