Отправка событий TikTok Events API через Pixel Activator

Если браузерный Pixel и Events API передают одну конверсию, в обеих копиях должны совпадать идентификатор события event_id и название события.

Читайте также: настройка TikTok через серверный GTM, учётные данные Meta и дедупликация событий.

Что даёт отправка событий TikTok Events API?

Серверная отправка дополняет TikTok Pixel. Заранее определите, какое завершённое действие считать конверсией, и соблюдайте требования к согласию пользователя и обработке данных.

Где взять Pixel Code и токен доступа?

Следуйте инструкции по получению TikTok Pixel ID и токена доступа.

1. Откройте TikTok Ads Manager, затем Tools > Events Manager.
2. Выберите веб-пиксель кампании и скопируйте Pixel Code.
3. В настройках пикселя найдите раздел Events API.
4. Создайте токен и сразу сохраните его в защищённом хранилище секретов.

Этот порядок также разобран в руководстве по настройке TikTok через серверный GTM.

Какое событие TikTok выбрать?

В TikTok Events API v1.3 рекомендовано стандартное событие Purchase. Платформа также поддерживает CompletePayment как классическое веб-событие TikTok Pixel. Это не список вариантов Активатора: в текущем интерфейсе Pixel Activator виден Purchase с отметкой $1, а CompletePayment отсутствует. На странице указано, что для событий с суммой используется value = 1 USD. Эти сведения описывают интерфейс и не подтверждают содержимое серверного запроса, атрибуцию или регулярную доставку.

Запишите соответствие бизнес-действий событиям: например, оплаченный заказ для Events API v1.3 соответствует Purchase, а отправленная форма соответствует SubmitForm. Такая запись поможет сохранить смысл события при подключении других инструментов.

Как проверить серверное событие?

1. Введите Pixel Code и токен в Pixel Activator.
2. Скопируйте код тестового события: в Events Manager откройте пиксель, вкладку Test Events и в секции Test Server Events нажмите кнопку копирования кода.
3. Вставьте код в поле «Код тестового события» в Pixel Activator.
4. Выберите событие для конкретного тестового действия и отправьте его один раз.
5. Проверьте ответ платформы: приём подтверждает HTTP 200 и code: 0 в теле ответа. TikTok может вернуть 200 с ненулевым code; такой ответ приёмом не считается.
6. Откройте вкладку Test Events пикселя в Events Manager и найдите событие в секции Event Activity: сообщения о проблемах в теле запроса появятся там же.
7. Перед рабочей отправкой уберите код тестового события.

Если code отличается от нуля или события во вкладке Test Events нет, перепроверьте Pixel Code, токен и код тестового события, затем повторите отправку один раз.

Как работает дедупликация TikTok?

Создавайте отдельный ID для каждой конверсии. Если она отправляется и из браузера, и с сервера, передавайте этот ID без изменений в обеих копиях вместе с одинаковым названием события. Не используйте один постоянный ID для всех конверсий.

Что проверить до запуска?

• Pixel Code относится к нужному сайту и рекламному аккаунту.
• Токен хранится в защищённом месте.
• Название события соответствует завершённому действию.
• Браузерная и серверная копии одной конверсии используют одинаковые event ID и event name.
• В Events Manager отображается ожидаемое серверное событие.

Частые ошибки TikTok Events API

Что автоматизировать дальше?

Разовый тест в Pixel Activator не показывает, как регулярная интеграция фиксирует действия, сопоставляет поля и обрабатывает браузерную и серверную копии одной конверсии. Проверьте эту интеграцию отдельно, прежде чем использовать её для рабочих событий.

Источники