Інтеграція · TikTok Events API

TikTok дізнається про депозиту момент постбеку.

Adset.Pro передає встановлення PWA, реєстрації та депозити в TikTok через Events API — із сервера, з ttclid і сумою депозиту. Алгоритм TikTok вчиться на реальних конверсіях, а витрати з TikTok підтягуються назад у трекер.

S2S
Events API замість браузерного пікселя
ttclid
прив'язка до рекламного кліку
OAuth
синк витрат TikTok у трекер
Маппінг за замовчуванням
PWA InstallSubscribe
РеєстраціяCompleteRegistration
ДепозитPurchase + сума
event_idttclidexternal_id SHA-256
Що це дає

Навіщо підключати TikTok Events API

Без втрат в in-app браузері

Браузерний піксель TikTok губить події через блокувальники та вбудований браузер застосунку. Events API надсилає конверсії із сервера Adset.Pro за постбеком партнерки.

Server-to-serverEvents API

Оптимізація на депозити

Депозит іде як Purchase або CompletePayment із сумою та валютою, решта подій — за маппінгом. Стандартні події TikTok обираються у формі пікселя.

Purchase + valueМаппінг подій

Атрибуція за ttclid

Трекер зберігає ttclid на кліку й передає його разом з IP, браузером і хешем click id — TikTok пов'язує конверсію з конкретним оголошенням.

ttclidSHA-256

Витрати й ROI в одному вікні

Підключіть рекламний акаунт TikTok через OAuth — витрати підтягнуться у статистику кампаній, і ROI буде видно до рівня оголошення.

OAuthROI
Під капотом

Що Adset.Pro передає в TikTok

ПолеЩо це
eventПодія за маппінгом: Subscribe, CompleteRegistration, Purchase або інша стандартна
event_idУнікальний ID події — для дедуплікації
event_timeЧас конверсії
ttclidID кліку TikTok, збережений трекером на кліку
ip · user_agentIP і браузер користувача з початкового кліку
external_idSHA-256 від click id
localeМова браузера користувача
value · currencyСума та валюта депозиту — для Purchase і CompletePayment
event_source · event_source_idweb і код вашого пікселя
Підключення

Підключення за 4 кроки

01

Візьміть код пікселя й токен

У TikTok Ads Manager: Assets → Events → ваш веб-піксель → Events API. Скопіюйте код пікселя та згенеруйте Access Token.

02

Створіть піксель в Adset.Pro

Трекер → Пікселі → + Піксель, тип TikTok. Вставте код і токен, перевірте маппінг подій.

03

Прив'яжіть до кампанії

Додайте піксель у стрім-сет кампанії. Джерело TikTok має передавати ttclid у трекінгове посилання.

04

Перевірте тестову подію

Надішліть тест із меню пікселя — подія прийде у вкладку Test Events у TikTok Events Manager. Статуси бойових надсилань — у логах пікселя.

FAQ

Часті запитання

Браузерний піксель спрацьовує на сторінці й залежить від блокувальників та in-app браузера. Events API надсилає подію із сервера, коли партнерка надіслала постбек, — так у TikTok доходять і депозити, що сталися через години після кліку.

Так: підключіть рекламний акаунт TikTok через OAuth і замапте в джерелі ID кампанії, групи чи оголошення. Витрати потраплять у статистику кампаній, ROI порахується автоматично.

Так, якщо клоака прокидає ttclid у трекінгове посилання. Для синку витрат через клоаку є окремий маркер кампанії adset_cid — його достатньо дописати до посилання клоаки.

Так, до одного стрім-сету можна прив'язати до 3 пікселів — наприклад, TikTok і HTTP-постбек в іншу систему.

Підключіть TikTok Events API
на безкоштовному Starter

Інтеграція входить у всі тарифи · Підтримка українською · Без картки