Keitaro Reddit: постбеки трекера в Conversions API
Связка Keitaro и Reddit - это проводка, превращающая постбеки трекера в события Reddit Conversions API: Keitaro фиксирует конверсию у себя, а слой доставки собирает принимаемый Reddit пейлоад v3. Работа трекера - идентичность: он знает, какой рекламный клик породил какую конверсию, и эта идентичность живёт в rdt_cid, пойманном в момент клика и пронесённом через воронку. У Reddit другая забота - форма: эндпоинт v3, конкретные поля и правила дедупликации, наказывающие самодельные идентификаторы.
Зарегистрируйте Reddit как траффик-сорс и поймайте rdt_cid
Механизм траффик-сорсов Keitaro позволяет объявлять кастомные источники со своими URL-параметрами: объявленные параметры парсятся из URL лендинга и сохраняются против клика. Для Reddit важен параметр rdt_cid - Reddit дописывает его в момент клика по рекламе. Объявив параметр в кастомном источнике Reddit, вы обеспечиваете сохранение клик-идентификатора в базе Keitaro для каждого клика из Reddit-рекламы - привязанным к кампании, офферу и суб-параметрам, которые трекер уже ведёт.
Общий флоу регистрации источника - имя, параметры, URL постбека - задокументирован в гайде Keitaro по добавлению траффик-сорса. Reddit-специфика на этом этапе сводится к имени параметра; платформенный хэндшейк случается позже, в слое доставки.
S2S постбек: идентичность из трекера
Конверсии въезжают в Keitaro постбеком партнёрской сети и выезжают через S2S постбек Keitaro: URL-шаблон, стреляющий по каждой конверсии, с подстановкой макросов в момент отправки - sub_id клика, ID транзакции, payout, статус. Именно постбек выдаёт Reddit-конверсии её идентификационный пакет: сохранённый в клике rdt_cid уезжает наружу рядом с собственными идентификаторами трекера.
Два макроса делают основную работу ради Reddit. Клик-идентификатор должен доехать до слоя доставки ровно тем, каким его поймал Reddit, - поэтому в шаблон постбека входит сохранённое значение rdt_cid; конверсии нужен стабильный идентификатор для дедупликации, поэтому транзакционный или сабовый идентификатор трекера становится conversion_id, по которому Reddit будет сводить пары, - рекомендация Reddit: уникальное значение на отдельную конверсию, одинаковое у каждого канала, сообщающего о ней.
Доставка пейлоада v3
| Поле Reddit v3 | Источник из пайплайна Keitaro |
|---|---|
click_id | Сохранённый rdt_cid из записи клика - весь путь идентификатора разобран в трекинге rdt_cid |
metadata.conversion_id | Транзакционный идентификатор трекера (уникален на конверсию) |
metadata.value, metadata.currency | Payout постбека в валюте кампании |
type.tracking_type | Маппинг из статуса постбека: sale в PURCHASE, lead в LEAD |
event_at | Время отправки - Reddit принимает события до семи дней после конверсии |
| Авторизация эндпоинта | Pixel ID в пути URL, conversion access token в bearer-заголовке |
Эндпоинт - https://ads-api.reddit.com/api/v3/pixels/<pixel_id>/conversion_events; правила пейлоада - лимиты батчей, семидневное окно, приоритет дедупликации для более богатых событий - те же, что задокументированы в событиях Reddit Conversions API. Ответы с ошибками механичны: ошибки Reddit Conversions API сводят каждый код к фиксу, включая поведение 429 backoff, которое батчинговый постбек-пайплайн обязан уважать.
То же разделение труда - трекер хранит идентичность, слой доставки держит форму API - для воронок в Keitaro автоматизирует MOST по Reddit, Meta, TikTok, Pinterest и Snapchat; паттерн связки на стороне Meta разобран в интеграции Keitaro и Facebook CAPI. Для одиночных ручных тестов Pixel Activator отправляет валидные события Reddit без пайплайна, а креденшелы берутся в настройке Reddit Conversions API. Обзор кластера - в полном руководстве.