Обязательно ли ставить TikTok Pixel вместе с Events API?

Нет, можно слать события только с сервера — это даже надёжнее на мобильном трафике. Но если Pixel уже стоит, событиям нужен одинаковый event_id для дедупликации.

Что делать, если ttclid не долетает?

Проверьте, что переход идёт именно из рекламы TikTok, а не из органики или другого источника, и что параметр считывается на первом заходе, до перехода в режим установленного PWA.

Как часто отправлять постбек по конверсии?

Сразу после самого действия пользователя — задержка в часы и тем более дни снижает точность оптимизации и качество матчинга.

Нужно ли хэшировать email и телефон перед отправкой?

Да, TikTok принимает эти поля только в хэшированном виде (SHA-256) — это не обязательно, но заметно повышает EMQ и точность.

Как проверить, что постбек настроен правильно?

Через Test Events в Events Manager: там видно каждое пришедшее событие и то, какие поля в нём заполнены.

Постбек в TikTok Events API

Постбек в TikTok Events API — это серверная передача конверсий напрямую в рекламный кабинет TikTok, в обход браузерных ограничений и блокировщиков. Без него алгоритм TikTok обучается на неполных данных и хуже находит платящую аудиторию в СНГ и Tier-1 гео. В этой статье — как поймать ttclid, настроить события и не словить задвоение конверсий.

Что такое TikTok Events API и зачем он арбитражнику

TikTok Events API (бывший TikTok CAPI) — серверный канал передачи конверсий, который работает в паре с TikTok Pixel или вместо него. Он не зависит от cookies и настроек приватности в браузере пользователя, поэтому данные доходят стабильнее, особенно с мобильного трафика и PWA. Для медиабайера это прямой путь к точной оптимизации: чем больше реальных конверсий видит TikTok, тем быстрее алгоритм находит похожую платящую аудиторию. Без Events API кампании часто упираются в потолок по CPA, потому что оптимизируются на неполных сигналах.

Что нужно подготовить до настройки

Понадобится доступ к TikTok Ads Manager или Business Center с правами на нужный рекламный аккаунт, созданный Pixel (Event Source) и токен доступа Events API — его генерируют в настройках источника событий. Токен и Pixel ID нужно сохранить в трекере или напрямую в постбек-модуле APEX. Проверьте, что домен, с которого идёт трафик, привязан к тому же Business Center — иначе события не свяжутся с кампанией.

Как поймать и сохранить ttclid

TikTok добавляет параметр ttclid к ссылке при клике по объявлению — именно он связывает конверсию с конкретным показом рекламы. На PWA-лендинге ttclid нужно считать из URL при первом заходе и сохранить вместе с идентификатором клика (subid), потому что после установки PWA на экран параметры из адресной строки уже не читаются. Если ttclid не поймать на этом шаге, постбек всё равно долетит, но без привязки к объявлению — TikTok просто не сможет его учесть.

Структура постбека: какие события отправлять

Стандартный набор для арбитражной воронки — ViewContent на показ оффера, CompleteRegistration на лид и CompletePayment или Purchase на депозит или оплату. Каждое событие отправляется POST-запросом на endpoint Events API с event_id, названием события, временной меткой, значением ttclid в контексте и, по возможности, хэшированными данными пользователя (email, телефон, IP, User-Agent) для лучшего матчинга. Чем ближе по времени конверсия отправлена к реальному действию пользователя, тем точнее TikTok её учитывает.

Дедупликация: чтобы конверсия не считалась дважды

Если параллельно с сервером событие шлёт ещё и браузерный Pixel, оба события должны иметь одинаковый event_id — так TikTok понимает, что это одно и то же действие, и не задваивает его в статистике. Задвоенные конверсии искажают CPA и путают алгоритм оптимизации, поэтому дедупликация — не опция, а обязательный шаг при связке Pixel и Events API. Если Pixel на странице не стоит и события шлются только с сервера, дедупликация не нужна, но событие всё равно должно быть уникальным по event_id на каждое действие.

Проверка через Test Events и Event Match Quality

Перед запуском кампании отправьте несколько тестовых событий через инструмент Test Events в TikTok Events Manager — он покажет, доходят ли события и совпадают ли поля. Отдельно стоит следить за Event Match Quality (EMQ) — чем выше показатель, тем точнее TikTok сопоставляет событие с конкретным пользователем и объявлением. Низкий EMQ обычно означает, что не хватает параметров матчинга — стоит добавить хэшированный email или телефон, если они собираются в воронке.

Частые ошибки при настройке постбека

Самые частые проблемы — просроченный или отозванный токен доступа, отсутствие ttclid из-за перехода не из TikTok (например, из органики), и рассинхрон времени между кликом и конверсией на сервере. Ещё одна частая ошибка — тестовые события с test_event_code, которые забыли отключить перед запуском кампании: TikTok их не учитывает в оптимизации, хотя события формально доставляются. APEX хранит ttclid вместе с кликом и передаёт его в постбек автоматически, что снимает большинство ручных ошибок при связке.

Частые вопросы

Обязательно ли ставить TikTok Pixel вместе с Events API?: Нет, можно слать события только с сервера — это даже надёжнее на мобильном трафике. Но если Pixel уже стоит, событиям нужен одинаковый event_id для дедупликации.
Что делать, если ttclid не долетает?: Проверьте, что переход идёт именно из рекламы TikTok, а не из органики или другого источника, и что параметр считывается на первом заходе, до перехода в режим установленного PWA.
Как часто отправлять постбек по конверсии?: Сразу после самого действия пользователя — задержка в часы и тем более дни снижает точность оптимизации и качество матчинга.
Нужно ли хэшировать email и телефон перед отправкой?: Да, TikTok принимает эти поля только в хэшированном виде (SHA-256) — это не обязательно, но заметно повышает EMQ и точность.
Как проверить, что постбек настроен правильно?: Через Test Events в Events Manager: там видно каждое пришедшее событие и то, какие поля в нём заполнены.

Собери своё PWA в APEX за пару минут

Клоака, антибот, пуши, сплит-тесты и свои домены — в одном сервисе.

Начать бесплатно