TikTok Events API ломается не на подписи, а на типовых полях и их валидации

TikTok Events API ломается не на подписи, а на типовых полях и их валидации

У TikTok Events API чаще всего падает не транспорт, а качество payload: event_name есть, а match data пустая или собрана в другом формате. В итоге запрос проходит, но атрибуция и дедупликация работают хуже, чем могли бы.

Базовый набор, который стоит проверить первым:
— event_name: строго из ожидаемого списка, без локальных переименований
— event_time: Unix time в секундах, не в миллисекундах
— event_id: один и тот же для Pixel и server event
— user: email, phone, external_id, ip, user_agent, ttclid
— properties: value, currency, contents, content_type, order_id

Самые частые ошибки валидации:
— email и phone уходят без нормализации до SHA-256: нужны lowercase, trim, E.164 для телефона
— event_time отправляют с часовым поясом или в ms
— contents передают строкой вместо массива объектов
— currency приходит в нижнем регистре или без ISO-кода
— event_id генерируется заново на клиенте и сервере, поэтому dedup не сходится

Если строите server-side маршрут, валидируйте payload до отправки: пустой user object лучше отбрасывать, чем слать «почти валидные» события. Иначе API примет запрос, а match_keys останутся бесполезными для оптимизации.

Правило простое: сначала привести типы и формат полей к одной схеме, потом уже смотреть на EMQ, дедуп и ROAS.