Токен Snapchat Conversions API: генерация, скоуп и правда об обновлении

Токен Snapchat Conversions API - креденшел Snap для серверной доставки событий, и он ломает паттерн, к которому приучают большинство сетей: вместо OAuth-флоу с истекающими токенами и календарём ротации Snap выдаёт статический long-lived токен прямо из интерфейса Business Manager. Токен едет в каждом запросе заголовком Authorization Bearer, а его правило скоупа - то, о которое спотыкаются мультиаккаунтные команды.

Где живёт токен

Документированный путь: откройте Business Manager, найдите секцию OAuth Apps, внутри - подраздел Conversions API Tokens, экран виден только пользователям с ролью Organization Admin. Сгенерированный там токен - креденшел, который слой доставки отправляет как Authorization: Bearer <token>. Third-party OAuth-флоу - отдельный механизм для платформ, интегрирующихся от лица множества клиентов; одиночному рекламодателю со своей воронкой он не нужен. Окружающая настройка - match keys и первый тест - в настройке Snapchat Conversions API.

Статичность значит гигиену, а не ротацию

Раз токен не истекает, нет календаря ротации и запланированных поломок - весь режим отказа переезжает в утечки. Токен, вставленный в клиентский бандл или чат, остаётся рабочим до отзыва, поэтому дисциплина хранения идентична любому другому CAPI-креденшелу: только серверно, обращение как с паролем без срока годности.

Правило org-скоупа

Справочник Snap формулирует скоуп прямо: токен отправляет события только для пикселов и app ID, принадлежащих той же организации, что и токен. Токен одной организации, указывающий на пиксел другой, падает - именно за этой конфигурационной ошибкой стоит заметная доля репортов «токен валиден, а события отклоняются» в мультиаккаунтных настройках. Семейства отказов с фиксами - в ошибках Snapchat Conversions API, обзор кластера - в полном руководстве.

Sources