Get in touch
Back to archive
13.05Server-side и API-интеграции

TikTok Events API: S2S-сигналы для TikTok Ads

intermediate4 min readtiktok-ads · events-api · s2s

TL;DR

  • TikTok Events API - это серверный канал передачи маркетинговых событий в TikTok.
  • Лучший базовый вариант для web conversions - использовать Pixel и Events API вместе с дедупликацией.
  • Events API полезен, когда часть событий теряется из-за браузера, in-app среды, consent, плохой сети или backend-логики.
  • Для качества matching нужны match keys: email, phone, external_id, IP, user agent, click identifiers, если они доступны и разрешены.
  • Events API особенно важен для e-commerce, app-first продуктов, leadgen и офферов, где TikTok приносит верх воронки, а продажа случается позже.

1. Что такое TikTok Events API

TikTok Pixel живет в браузере. Он фиксирует события на сайте: page view, view content, add to cart, complete payment, submit form.

Events API отправляет события с сервера, CRM, приложения или sGTM. Это делает поток данных устойчивее. TikTok сам рекомендует для web conversions использовать Pixel и Events API вместе, чтобы повысить надежность и сохранить переход в новую privacy-реальность.

Важный момент: Events API не магическая кнопка роста. Он помогает TikTok видеть больше правильных событий. Но креатив, оффер, landing page и продукт все равно решают большую часть результата.

2. Почему TikTok особенно чувствителен к качеству событий

TikTok часто работает как канал быстрого спроса. Пользователь увидел ролик, кликнул, отвлекся, вернулся позже, открыл сайт в другом браузере, оформил заказ через mobile web или приложение.

В такой цепочке легко теряются:

  • click ID;
  • browser cookies;
  • user identifiers;
  • purchase event;
  • CRM-статус;
  • value;
  • повторные визиты.

Если TikTok видит только клики и часть лидов, алгоритм оптимизируется грубо. Если получает purchase, value и quality events, он быстрее понимает, какие просмотры и клики дают деньги.

3. Pixel + Events API

Хорошая схема не обязательно убирает Pixel.

КаналЧто делает
PixelБыстро фиксирует browser events
Events APIДосылает серверные, CRM и offline события
DeduplicationСклеивает пары событий в один customer action
Match keysПомогают TikTok сопоставить событие с пользователем

Если нет общего event ID, риск дублей становится реальным. Если нет match keys, событие может доехать, но хуже помочь оптимизации.

4. Какие события отправлять

Для e-commerce:

  • ViewContent;
  • AddToCart;
  • InitiateCheckout;
  • CompletePayment;
  • value;
  • currency;
  • content_id;
  • order_id.

Для leadgen:

  • SubmitForm;
  • Contact;
  • QualifiedLead;
  • ApprovedApplication;
  • Purchase или ContractSigned, если цикл сделки длинный.

Для приложений:

  • Register;
  • Subscribe;
  • TrialStart;
  • Purchase;
  • ключевые in-app события.

Не отправляйте в TikTok все микро-клики. Алгоритму нужны события, которые отражают бизнес-ценность, а не движение мыши по странице.

5. Локальный контекст СНГ/РК

Для локального рынка TikTok часто дает дешевый охват, но качество лидов может прыгать. Поэтому Events API особенно полезен не на уровне "форма отправлена", а на уровне качества.

Пример: онлайн-школа получает 1000 заявок из TikTok. Если оптимизироваться на форму, можно получить много школьников, случайных кликов и людей без платежного намерения. Если возвращать в TikTok события QualifiedLead и Paid, алгоритм начинает видеть, какие пользователи реально покупают курс.

Для e-commerce в Казахстане полезно передавать оплату после фактического success-статуса, особенно если есть Kaspi, рассрочка, оплата при получении или отмены заказов.

6. Ошибки

ОшибкаЧто происходит
Считают Events API заменой креативаТрекинг лучше, но продажи не растут
Нет дедупликацииКонверсии дублируются
Передают только верх воронкиАлгоритм ищет дешевые лиды
Не передают valueTikTok не отличает мелкий заказ от крупного
Не сверяют CRM и кабинетОптимизация живет отдельно от продаж
Не проверяют match keysСобытия плохо сопоставляются

7. План внедрения

  1. Определите, какие события уже отправляет Pixel.
  2. Выберите 1-3 серверных события для Events API.
  3. Настройте общий event ID.
  4. Добавьте match keys с учетом privacy.
  5. Проверьте события в TikTok Events Manager.
  6. Сверьте счетчики с backend/CRM.
  7. Запускайте оптимизацию на более качественное событие только после стабильного потока.

8. Чеклист

  • Pixel и Events API не конфликтуют.
  • Есть event ID для дедупликации.
  • Match keys нормализуются.
  • Value и currency передаются для покупок.
  • CRM quality events отделены от обычных лидов.
  • Есть лог ошибок API.
  • Есть сверка TikTok vs backend.
  • Команда понимает, какое событие используется для bidding.

9. Видео

How to Set Up TikTok Events API - Step-by-Step Guide

10. Главный совет

TikTok Events API нужен не для красивой галочки в Events Manager. Он нужен, чтобы TikTok учился на событиях, которые ближе к деньгам: оплате, одобрению, качественному лиду или повторной покупке.

Sources / Notes