Match key
Match key — идентификатор внутри payload события: click ID, хешированный email или номер телефона, IP-адрес с user agent или мобильный рекламный ID, — по которому рекламная платформа связывает событие с реальным профилем пользователя. События, богатые match keys, матчятся, атрибуцируются и участвуют в оптимизации; события без них доставляются, но остаются для платформы анонимными.
Какие ключи хочет каждая платформа
| Платформа | Ключи | Требование |
|---|---|---|
| Snapchat | hashed_email, hashed_phone_number, hashed_ip_address + user_agent, hashed_mobile_ad_id | Минимум один обязателен — событие без них отклоняется ошибкой; передача всех улучшает качество |
| IP-адрес, click_id, email, телефон, user agent, external ID, мобильные ID | Передавайте как можно больше; IP и click ID strongly recommended | |
| Meta | user_data: em, ph, client_ip_address, client_user_agent, fbc, fbp, external_id | Минимум один параметр user_data на запрос; с Graph API v13.0 обязательны определённые комбинации |
| TikTok | хешированные email и телефон в user-объекте, click ID ttclid | Рекомендуются для матчинга событий Events API |
Click ID стоит особого отношения: это единственный match key, который приезжает уже привязанным к рекламному клику, — поэтому Reddit и Snap ставят его на первое место. Он же чаще всех теряется между лендингом и серверным событием.
Сначала нормализация, потом хеширование
Хешированные ключи — это SHA-256-дайджесты нормализованных значений: email в нижнем регистре без точек в локальной части и без всего после плюса; телефон только из цифр с кодом страны; мобильные ID в платформенно-зависимом регистре. Каждый дайджест — 64 символа в lowercase hex. Значение, захешированное без нормализации или дважды, не вызывает ошибки — оно просто не матчится ни с кем, и потеря невидима, пока не просядет match rate.
Канонизация у платформ различается настолько, что переиспользование одного сборщика payload между сетями молча деградирует матчинг; правила по платформам собраны в хешировании и нормализации user data для CAPI. Метрика, показывающая, как работают ваши ключи, — match rate.