TikTok Events API, отправка с вашего сервера
ROASaurus отправляет события магазина в TikTok Events API 2.0 с сервера, с теми же ID событий, что и у пикселя TikTok. Он также подтягивает расходы TikTok для ROAS и отчётов по креативам.
| TikTok вкратце | |
|---|---|
| Подключение | Events API 2.0 (сервер) плюс пиксель TikTok (браузер) с общими ID событий |
| События | ViewContent, AddToCart, InitiateCheckout, CompletePayment (прежнее название Purchase) |
| Данные клиента | Email и телефон, хешированные SHA-256, external_id, IP, user agent |
| Click id | ttclid и cookie _ttp |
| Учётные данные | Код пикселя и токен доступа Events API |
| Синхронизация расходов | Да, с ID рекламодателя и токеном Marketing API |
Что ROASaurus отправляет в TikTok
В Events API уходят четыре события: ViewContent, AddToCart, InitiateCheckout и CompletePayment. TikTok переименовал CompletePayment в Purchase и по-прежнему принимает старое название как покупку. Просмотры страниц идут только через браузерный пиксель; сервер не отправляет PageView в TikTok.
Каждое событие несёт ID события, URL страницы, click id ttclid, cookie _ttp, IP-адрес и user agent. Если покупатель известен, добавляются его email и телефон, хешированные SHA-256, и хешированный ID клиента или посетителя как external_id. В свойствах передаются валюта, сумма, ID заказа и ID, название, количество и цена каждого товара.
TikTok может ответить HTTP 200 и всё равно отклонить событие, указав код ошибки в теле ответа. ROASaurus считывает этот код, поэтому отклонённое событие отображается в Event log как неудачное, а не проходит молча.
Как подключить
- В ROASaurus откройте Tracking & platforms и нажмите Add pixel на карточке TikTok.
- Введите код пикселя и токен доступа Events API.
- Оставьте включённой опцию Also load the browser pixel. Тогда браузерные и серверные события используют общие ID, и TikTok их дедуплицирует.
- Необязательно: вставьте код тестового события, чтобы сначала увидеть события в Test events.
- Для расходов добавьте ID рекламодателя и токен Marketing API.
Расходы и отчёты по креативам
После синхронизации расходов кампании TikTok показывают ROAS и CPA рядом с Meta в атрибуции. Аналитика креативов добавляет видеометрики TikTok: hook rate считает 2-секундные просмотры, а hold rate — 6-секундные. Называйте объявления с указанием хука, креатора и формата, чтобы сравнивать их.
Ограничения
- Если пиксель отправляет и приложение канала продаж TikTok, покупки считаются дважды. Отключите пиксель в этом приложении.
- ROASaurus считает только те заказы, которые удаётся связать с кликом, поэтому его итоги обычно отличаются от данных TikTok Ads Manager.
Читайте также
Ответы на вопросы
Почему покупка называется CompletePayment?
CompletePayment — прежнее название события покупки в TikTok; сейчас TikTok называет его Purchase, но по-прежнему принимает старое название. ROASaurus использует CompletePayment и в браузерном пикселе, и в Events API, поэтому TikTok может сопоставить две копии по event_id.
Нужно ли приложение TikTok в Shopify?
Нет. Если оно у вас осталось, отключите пиксель в приложении TikTok: его события приходят с другими id, и TikTok засчитает каждую покупку дважды.
Можно ли протестировать до запуска?
Да. Вставьте код тестового события из TikTok Events Manager в настройки пикселя, и события появятся во вкладке Test events. Закончив, удалите код.
Каждая продажа прослежена до рекламы, которая её принесла
Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.
Начать бесплатный пробный период →