Reddit Conversions API: полное руководство

Серверный канал Reddit для данных о конверсиях - Reddit Conversions API: ваш сервер, трекер или CRM отправляет события напрямую в Reddit, не полагаясь на браузерный тег. Эта страница - парадная дверь нашего кластера Reddit CAPI: что делает API, что нужно рабочему событию, как сходятся дедупликация и валидация, и где у каждой конкретной проблемы - отклонённый payload, двойной счёт, разъехавшиеся отчёты - свой глубокий гайд.

Что такое Reddit Conversions API

Reddit Conversions API - документированный Reddit приём конверсионных событий, отправляемых напрямую из ваших систем. Reddit описывает его для источников web, app и офлайн - это делает канал тем, кто всё же доносит конверсии партнёрской воронки, закрывающейся на оффер-странице, которую вы не контролируете: трекер фиксирует продажу, и именно серверное событие везёт её в Reddit. После доставки серверные события питают тот же слой измерения и оптимизации, что и события Reddit Pixel.

Три ограничения Reddit задают форму любой интеграции. События нужно отправить в течение семи дней после конверсии - задержавшийся постбек поднять можно, но не бесконечно. Потолок rate limit - 1,000 запросов в секунду, 10,000 событий в секунду и 1,000 событий на запрос: для одной воронки это огромный запас, актуальный только при пачковой разгребке бэклога трекера. И когда Reddit Pixel и API сообщают об одних событиях - рекомендованная Reddit конфигурация, - дедупликация обязательна.

Пошаговый путь настройки, включая ошибки с токеном, - в отдельном гайде: настройка Reddit Conversions API.

Что нужно перед настройкой

Reddit требует ровно два значения. Pixel ID идентифицирует источник данных, принимающий конверсии, и вставляется в URL эндпоинта. Conversion access token авторизует каждый POST - best practices Reddit рекомендуют его вместо developer-токена: он бессрочный и простой в генерации, показывается только один раз при создании, копируйте сразу.

Оба значения живут в Events Manager Reddit под Configure data source, Conversions API, Set up manually - проход со скриншотами - в настройке Reddit Conversions API, а у токена и Pixel ID есть свой гайд по креденшелам. Храните их серверно: токен в клиентском бандле - утечка креденшела, а не сокращение пути.

Отправка событий: пейлоад v3

Цель - https://ads-api.reddit.com/api/v3/pixels/<pixel_id>/conversion_events, авторизация - токен в bearer-заголовке. Каждый элемент массива events несёт поля, нужные конверсии; референс-сэмпл Reddit показывает форму:

• event_at - таймстамп конверсии; именно к нему применяется окно семи дней;
• action_source - где случилась конверсия: WEBSITE, PHYSICAL_STORE или app-источник; события PHYSICAL_STORE не должны нести device-идентификаторы;
• type - объект с tracking_type (PURCHASE, LEAD, PAGE_VISIT или CUSTOM с custom_event_name до 64 регистрозависимых UTF-8 символов - на дашборде видны только 20 последних кастомных событий);
• metadata - выручка и идентичность конверсии: conversion_id, currency, value;
• user - match keys вроде ip_address и external_id;
• event_source_url - рекомендовано для WEBSITE-событий: Reddit извлекает домен для отчётности, а click ID в URL служит фолбэком идентификатора.

{
  "data": {
    "events": [
      {
        "click_id": "3184742045291813272",
        "event_at": 1790000000000,
        "action_source": "WEBSITE",
        "event_source_url": "https://www.example.com/checkout?rdt_cid=3184742045291813272",
        "type": { "tracking_type": "PURCHASE" },
        "metadata": { "conversion_id": "order-8842", "currency": "USD", "value": 49.9 },
        "user": { "ip_address": "192.0.2.1", "external_id": "7c73f2ae-a433-4d7b-9838-f467da98f48e" }
      }
    ]
  }
}

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

Match keys: на чём Reddit матчит

Match keys - идентификаторы, которыми Reddit связывает конверсию с рекламным взаимодействием, и рекомендация Reddit прямая: передавайте как можно больше, настойчиво рекомендуются IP-адрес и click ID, добавьте email, телефон и user agent. UUID рекомендован при интеграции CAPI с пикселом. Идентификаторы уходят сырыми или предхешированными; хешированные следуют строгой канонизации - email в lowercase без точек и плюсов, телефон только из цифр с кодом страны, 64 символа lowercase hex для каждого дайджеста.

Click ID требует собственной дисциплины: Reddit дописывает rdt_cid к URL вашего лендинга в момент клика, а слой доставки обязан передать его как click_id. Где сидит каждый идентификатор и как канонизация различается по сетям - в match keys; общая дисциплина - в хешировании и нормализации user data для CAPI; цепочка сохранности клик-ID - в трекинге ссылок и потере click ID.

Дедупликация: сначала conversion_id, потом сессии

Связка Reddit Pixel и Conversions API - рекомендованная конфигурация, и дедупликация в ней обязательна. Задача Reddit запускается ежечасно и помечает дубликатом событие меньшего качества: побеждает событие с большим числом метаданных и match keys, при равенстве отбрасывается более позднее. Рекомендованный метод передаёт уникальный conversion_id и из пикселя, и из серверного события; повторное использование одного ID на слишком многих событиях маркирует реальные конверсии как дубликаты. Без ID Reddit откатывается на сессионный дедуп - сессия это поток событий одного пользователя, где между соседними прошло не больше пяти минут, - которому нужны UUID или external ID на каждом событии и который обрабатывает только события, прибывшие за два дня; лог дедупа хранится семь дней.

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

Как провалидировать события до бюджета

Воркфлоу verify-events у Reddit явный:

1. Скопируйте test ID из Events Manager и передайте его в POST как test_id.
2. Отправьте тестовую конверсию и раскройте событие: сверьте полученные Pixel ID, conversion ID, match keys и метаданные.
3. Перед выкаткой на прод уберите поле test_id.

Помните тестовый лимит 10 событий в секунду - батчи в интерфейсе тестирования не отображаются.

Предупреждения - не отказы: битые, но узнаваемые значения принимаются, но каждое предупреждение - match key, работающий ниже своих возможностей; нерешённые проблемы всплывают в Diagnostics и чистятся до 24 часов. Привычка валидации та же, что в экосистеме Meta - тестовые события до масштабирования.

Обработка ошибок и лимиты

Reddit документирует пять семейств отказов, у каждого свой фикс:

Каждое семейство с точным сообщением и фиксом сведено в таблицу ошибок Reddit Conversions API.

Окна атрибуции и расхождения

Меняются в Events Manager под Attribution Settings. Когда Ads Manager и трекер расходятся, собственный troubleshooting Reddit называет типовые причины: Reddit атрибуцирует конверсию дню показа или клика, а сторонние тулы часто - дню свершения; окна атрибуции различаются между платформами; view-through конверсий в трекере может не быть; отчёты игнорируют UTC; редиректы срезают UTM; блокировщики рекламы глушат сторонний трекинг.

Полный чеклист по каждой причине - в расхождениях конверсий Reddit Ads.

Автоматизация доставки: Keitaro, Pixel Activator и Most

Если воронка живёт в Keitaro, трекер ловит rdt_cid в момент клика и шлёт конверсии в сторону эндпоинта Reddit с маппингом в одном месте; связка задокументирована в интеграции Keitaro и Reddit, а Meta-близнец - в связке Keitaro и Facebook CAPI. Для разовых ручных тестов Pixel Activator - быстрейшая точка входа без настройки. А когда доставка должна случаться всегда - ретраи, дедупликация, хеширование, круглосуточная маршрутизация из трекера или CRM, - это работа Most в фоне.

Для команд, доставляющих через серверный Google Tag Manager, правила пейлоада переносятся напрямую - см. Reddit Conversions API через server-side GTM.

Reddit Conversions API: частые вопросы

Sources