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

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

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

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

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

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

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

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