<b>TikTok Events API ломается не на отправке, а на валидации полей: вот где искать ошибку</b>

<b>TikTok Events API ломается не на отправке, а на валидации полей: вот где искать ошибку</b>

Когда серверный event уходит, но не матчится — проблема обычно в схеме. Для TikTok Events API критичны три слоя: идентификаторы пользователя, данные события и технические поля запроса.

Проверь базовый набор:
— <code>event</code>, <code>timestamp</code>, <code>event_id</code>
— <code>context.page.url</code>, <code>context.user_agent</code>, <code>context.ip</code>
— user data: email/phone в хеше, <code>ttclid</code>, <code>ttp</code> если они доступны
— currency и value для ecommerce-событий

Типовая ошибка — отправлять пустые строки вместо null или не нормализовать PII перед SHA-256. Email нужно привести к lowercase и trim, телефон — к E.164-логике, иначе валидатор пропустит запрос, но матчинг просядет.

Ещё один частый сбой — дубль <code>event_id</code>. Если Pixel и Events API живут параллельно, идентификатор должен быть одинаковым на обеих сторонах, иначе дедупликация не сработает.

Для отладки удобно проверять запрос в таком порядке:
1. обязательные поля
2. формат timestamp
3. хеширование user data
4. наличие value/currency
5. консистентность event_id между client и server

Если event проходит по HTTP, это ещё не значит, что он пригоден для атрибуции. Сначала валидируй схему, потом уже смотри EMQ и deduplication.