TikTok Events API

Это руководство объясняет, как настроить события Events API, которые AdTarget отправляет в TikTok, когда пользователи присоединяются к вашему Telegram-каналу.

Когда отправляются события?

AdTarget отправляет событие в TikTok только для атрибутированных вступлений — то есть вступлений, при которых AdTarget может связать вступление в Telegram с конкретным кликом по рекламе на вашем лендинге. Для этого требуется наличие invite_link в вебхуке Telegram.

События отправляются, когда пользователь нажимает на вашу отслеживаемую ссылку-приглашение и Telegram сообщает об этом в вебхуке (надёжно для приватных каналов).

События НЕ отправляются для органических вступлений — пользователей, которые находят ваш канал через поиск, прямые ссылки или пересланные сообщения. Эти вступления всё равно отображаются в вашем дашборде AdTarget, но помечаются как «органические».

Доступные типы событий

AdTarget сопоставляет свои типы событий со стандартными событиями TikTok:

Выбор правильного события

Запускаете рекламу для генерации лидов? Используйте Lead (сопоставляется с SubmitForm TikTok) — Это говорит TikTok: «этот человек отправил форму / стал лидом».

Продаёте продукт или услугу? Используйте Purchase — Лучший вариант, когда вы хотите, чтобы TikTok оптимизировал для покупателей. Сочетайте с value и currency в конфигурации конверсий вашего канала для оптимизации на основе ценности.

Запускаете кампании на регистрацию? Используйте CompleteRegistration — Сигнализирует о завершённой регистрации.

Продвигаете подписку на канал? Используйте Subscribe — Соответствует действию пользователя (вступление = подписка).

Нужно нестандартное событие? Используйте Custom — Позволяет задать собственное название события для специализированных сценариев отслеживания.

Совет: Сопоставляйте тип события с целью вашей кампании в TikTok Ads Manager для лучших результатов.

Настройка событий

Типы событий настраиваются для каждого канала. Каждый канал по умолчанию использует CompleteRegistration при первом обнаружении.

Чтобы изменить тип события канала:

1. Перейдите в Settings вашего сайта → вкладка Channels
2. Нажмите Setup (или Edit) в строке канала
3. Выберите тип события в диалоге
4. Нажмите Save

Параметры событий

Каждое событие, которое AdTarget отправляет в TikTok, включает эти параметры:

Обязательные параметры

Параметры атрибуции

Данные пользователя

external_id (ID пользователя Telegram) хешируется SHA-256 перед отправкой, как требует TikTok. IP-адрес и user agent отправляются как есть в соответствии со спецификациями Events API TikTok.

Свойства события

Дедупликация событий

AdTarget включает уникальный event_id с каждым событием для предотвращения дублей:

event_id: "adtarget_{conversion_id}"

Это гарантирует, что одна и та же конверсия не будет учтена дважды, даже при повторной отправке.

Тестирование событий

Тест в продакшене

Самый надёжный способ тестирования от начала до конца:

1. Нажмите на свою рекламу TikTok (или используйте тестовую рекламу)
2. Посетите ваш лендинг
3. Вступите в ваш Telegram-канал по отслеживаемой ссылке-приглашению
4. Проверьте TikTok Events Manager в течение 5-10 минут

Проверка в TikTok Ads Manager

1. Перейдите в Assets → Events → Web Events → Manage
2. Проверьте вкладку Events
3. Найдите ваш тип события с недавними временными метками
4. Убедитесь, что событие показывает статус «Received»

Сопоставление событий

TikTok сопоставляет ваши события с пользователями для атрибуции. Более высокое качество сопоставления означает лучшую оптимизацию.

Факторы качества сопоставления

Улучшение качества сопоставления

1. Захватывайте ttclid: Убедитесь, что URL вашего лендинга сохраняет параметр ttclid
2. Отправляйте события быстро: Меньшее время между кликом и конверсией улучшает сопоставление
3. Последовательный путь пользователя: Удерживайте пользователей на вашем домене перед перенаправлением в Telegram

Типичные конфигурации событий

Генерация лидов

AdTarget Event: Lead → TikTok Event: SubmitForm
When: User joins channel
Use Case: "Get subscribers" campaigns

Отслеживание покупок

AdTarget Event: Purchase → TikTok Event: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Подписка на контент

AdTarget Event: Subscribe → TikTok Event: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Устранение неполадок

События не сопоставляются?

• Проверьте, что ttclid есть в URL лендинга
• Убедитесь, что TikTok Pixel также установлен на лендинге
• Убедитесь, что cookies не заблокированы

Низкий показатель сопоставления событий?

• Сократите время между кликом и конверсией
• Убедитесь, что ttclid захватывается из URL
• Убедитесь, что IP и user agent доступны

Дублирующиеся события?

• AdTarget обрабатывает дедупликацию автоматически через event_id
• Если видите дубли, свяжитесь с поддержкой

Лучшие практики

1. Сопоставляйте тип события с целью кампании для лучшей оптимизации
2. Используйте один тип события последовательно в рамках кампании
3. Мониторьте доставку событий в TikTok Events Manager регулярно
4. Тестируйте перед масштабированием рекламного бюджета

Следующие шаги

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

Нужна помощь с оптимизацией? Свяжитесь с нашей командой поддержки.