Как работает постбэк Rafinad
Постбэк Rafinad передаёт в вашу систему сведения о конверсии и её состоянии. После получения данных от рекламодателя сеть обращается к заданному URL. Вместо макросов в запрос подставляются ID заказа, статус, комиссия вебмастера, валюта и переданные ранее метки.
Для связи с аналитикой нужны два этапа: на вашем сайте собирается посещение и его идентификаторы, затем эти идентификаторы проходят через партнёрскую ссылку и возвращаются вместе с заявкой. Серверный постбэк может прийти позднее, когда посетитель уже закрыл страницу.
Сначала определите версию кабинета
В новом кабинете new.rafinad.io используются {order_id}, {publisher_commission} и {status} со значениями 1–4. Старый шаблон Rafinad в ВебНиндзя использует lead_id, top_cost, lead_status и текстовые статусы. Автоматически считать эти схемы одинаковыми нельзя.
Основная инструкция ниже относится к новому кабинету, проверенному 8 ноября 2026 года. Совместимость со старым шаблоном разобрана отдельно.
Настройка постбэка в новом кабинете Rafinad
- Откройте «Инструменты → Постбеки» и нажмите «Создать».
- Укажите понятное название и базовую ссылку принимающего сервиса.
- Выберите метод отправки. Форма поддерживает GET и POST. Для URL-интеграции ВебНиндзя используйте GET.
- В блоке «Фильтрация» задайте область действия: глобальный постбэк либо нужные офферы и источники. Проверьте переключатель «Всегда отправлять глобальный постбек» при наличии отдельных правил.
- Выберите состояния конверсий, по которым нужно получать уведомления.
- В блоке «Маппинг статусов отправки» при необходимости задайте названия, которые понимает ваш сервис.
- В блоке «Параметры» добавьте пары «имя поля вашего сервиса → параметр Rafinad». Постоянные значения задаются в блоке «Константы».
- Сверьте пример сгенерированного GET-запроса и сохраните настройку.
В новом интерфейсе параметры выбираются из списка. Поэтому старый URL с макросами не следует переносить механически: проверьте базовый адрес, динамические поля и константы в итоговом примере. Ключ проекта и токен принимающего сервиса являются константами, а статус и сумма являются динамическими значениями.
Полный справочник параметров нового кабинета
В блоке «Доступные параметры» показаны 20 пунктов. Пункт {sub_id} объединяет десять SubID; в списке выбора они представлены отдельными полями, например sub_id1 и sub_id6.
| Макрос справочника | Содержимое | Как использовать |
|---|---|---|
{order_id} | ID конверсии в системе рекламодателя | Сопоставление заявки. Область уникальности проверяется с учётом оффера и цели |
{p_click_id} | p_click_id из ссылки | Возврат переданного вебмастером идентификатора клика |
{sub_id} | SubID 1–10 из ссылки | Метки источника и идентификаторы аналитики; в форме выбирается конкретный sub_idN |
{context_id} | Переданный gclid или yclid | Идентификатор рекламного перехода, если был передан |
{click_date} | Дата создания клика по конверсии | Проверка последовательности перехода и заявки |
{conversion_date} | Дата создания конверсии | Время целевого действия. Часовой пояс и фактический формат проверяйте в запросе |
{goal_id} | Числовой идентификатор цели | Цель оффера в Rafinad, отдельная от цели Метрики |
{goal_key} | Строковый идентификатор цели | Дополнительное различение целевых действий |
{goal_name} | Название цели оффера | Подпись целевого действия в отчёте |
{offer_id} | ID оффера | Сопоставление по устойчивому идентификатору |
{offer_name} | Название оффера | Человекочитаемая подпись |
{basket} | Состав корзины: позиции, цены и количество | Товарная детализация, когда её передал рекламодатель |
{order_total} | Сумма заказа по конверсии | Объём заказа покупателя; это отдельная величина от комиссии вебмастера |
{publisher_commission} | Сумма комиссии | Вознаграждение вебмастера в учёте партнёрской сети |
{status} | Числовой статус 1–4 до пользовательского маппинга | Состояние конверсии, см. следующую таблицу |
{currency} | Трёхбуквенный код валюты | Валюта конверсии |
{source_id} | ID источника | Группировка по подключённым источникам |
{flow_id} | ID потока | Группировка по потокам |
{promocode} | Трекинговый промокод конверсии | Содержимое custom_params при наличии; иначе пустое значение |
{revshare_id} | ID ревшарной конверсии от рекламодателя | Различение соответствующих начислений; формат определяется рекламодателем |
Имя исходящего поля задаёт принимающий сервис. Например, поле payout можно сопоставить с publisher_commission, если ваш сервис читает выплату из payout. Названия слева и справа не обязаны совпадать.
Сумма заказа и комиссия
Если нужно учитывать заработок вебмастера, ориентируйтесь на publisher_commission. Передача order_total вместо комиссии завысит доход на сумму заказа. Сумму сохраняйте вместе с валютой и статусом: комиссия заявки в ожидании ещё не подтверждает получение денег.
Дата и состав корзины
В справке даты описаны шаблоном «год, месяц, день, время». Перед загрузкой в аналитику проверьте конкретное значение и часовой пояс. Корзина представляет собой структурированные данные. Её нельзя без проверки помещать в числовое поле суммы или выплаты.
Статусы Rafinad: ожидание, холд, отмена и одобрение
| Значение status | Описание справочника | Что учитывать |
|---|---|---|
1 | В ожидании | Конверсия ожидает дальнейшей обработки |
2 | В холде | Отдельное состояние сети. Не приравнивайте его автоматически к одобрению |
3 | Отменено | В фильтре формы состояние подписано «Отклонено» |
4 | Одобрено | Подтверждённая конверсия. Фактическая выплата средств вебмастеру проверяется отдельно |
Блок «Маппинг статусов отправки» позволяет задать свои названия для отправки. После такой настройки принимающий сервис должен читать фактическое исходящее значение. Не пытайтесь одновременно трактовать одно и то же поле как число и как старый текстовый статус.
Если ваш учёт имеет только три состояния, заранее решите, куда относить холд. Для схемы «на проверке / одобрено / отклонено» безопаснее сохранять ожидание и холд как незавершённые состояния, пока не получен окончательный результат сети. При этом исходный статус полезно сохранять для сверки.
Статусы конверсии, статус подключения потока и доступность денег для вывода относятся к разным процессам. Их нельзя заменять друг другом при подсчёте одобрений.
SubID, ClientID и рекламные идентификаторы
SubID возвращает значение, переданное при переходе по партнёрской ссылке. В новом конструкторе выберите конкретный элемент sub_id1…sub_id10. Общая запись {sub_id} в справке обозначает группу, поэтому не используйте её вслепую вместо номера поля.
В старом шаблоне ВебНиндзя принята следующая схема исходящих полей. При подключении нового кабинета это назначение нужно явно согласовать с конструктором и маппингом:
| Поле, которое читает шаблон ВебНиндзя | Назначение |
|---|---|
sub1…sub4 | Собственные метки сайта, размещения и кампании |
sub5 | Номер счётчика Метрики |
sub6 | ClientID Метрики |
sub7 | Measurement ID потока GA4 |
sub8 | Client ID GA4 |
sub9 | Идентификатор VK при использовании интеграции |
Это соглашение ВебНиндзя, а не обязательная разметка Rafinad. Для новой настройки проверяйте обе стороны: как поле называется в самой партнёрской ссылке и под каким именем конструктор возвращает его в запросе.
p_click_id, context_id, ClientID Метрики и Client ID GA4 имеют разное назначение. Один идентификатор не следует подставлять вместо другого. ClientID Метрики получают через getClientID на том сайте и счётчике, где произошло посещение.
Подключение Rafinad к ВебНиндзя
Если используется старая схема
Существующий шаблон Rafinad в ВебНиндзя читает lead_id как ID заявки, top_cost как сумму, currency как валюту и lead_status как статус. Текстовые значения WAIT, ACCEPTED и REJECTED сопоставляются с проверкой, одобрением и отказом. Аналитика использует поля sub5–9.
Эта таблица описывает существующий шаблон ВебНиндзя. Она не является списком макросов нового кабинета Rafinad.
Если подключается новый кабинет
Задайте маппинг по фактическому исходящему запросу. Потребуются ID конверсии, комиссия, валюта, статус, сведения об оффере и идентификаторы аналитики. Поля order_id и publisher_commission присутствуют в новом справочнике; старых макросов lead_id и top_cost в проверенной форме нет.
Числовые статусы 1–4 старый шаблон ВебНиндзя не различает как четыре состояния: для них нужна согласованная настройка. Один из вариантов через штатный блок маппинга Rafinad: ожидание и холд отправлять как WAIT, отклонение как REJECTED, одобрение как ACCEPTED. Имя поля статуса при этом должно совпадать с маппингом ВебНиндзя.
Перед рабочим запуском проверьте устойчивость и уникальность ID конверсии. Справка описывает order_id как ID рекламодателя. Нельзя без проверки предполагать, что он уникален сразу для всех офферов, целей и повторных начислений. Приложите offer_id и goal_id к диагностике и убедитесь, что разные действия не сливаются в одну заявку.
Стандартные bridge-скрипты ВебНиндзя для Leadgid дописывают aff_sub5–8. Это не означает, что новый Rafinad автоматически прочитает их как sub_id5–8. Перед публикацией ссылок проверьте их реальные параметры и возвращаемые значения. Простое копирование кода другой сети не подтверждает готовность интеграции.
Общий порядок подключения аналитики описан в пошаговом гайде. Рабочий URL и токен копируйте из своего кабинета; обезличенный пример ниже нужен только для объяснения полей:
https://receiver.example/postback?order_id=DEMO_ORDER&offer_id=DEMO_OFFER&goal_id=DEMO_GOAL&status=4&publisher_commission=1500.00¤cy=RUBЭто условный запрос на демонстрационный адрес. Он не создаёт конверсию и не является готовым URL ВебНиндзя.
Как проверить передачу конверсии
- Сверьте итоговую партнёрскую ссылку: источник, поток и нужные SubID должны сохраниться.
- Убедитесь, что посещение записалось на нужном счётчике. ClientID в ссылке сам по себе этого не доказывает.
- Для реальной заявки сравните ID заказа, оффер, цель, состояние, время и комиссию в Rafinad.
- Проверьте фактический запрос получателю. Динамические параметры должны содержать значения, константы должны соответствовать вашему подключению.
- В ВебНиндзя сравните исходные поля и результат их чтения: статус, сумма, валюта, счётчик и ClientID.
- Проверьте доставку каждой аналитики и затем результат в её отчёте. При несовпадении отделяйте ошибку получения постбэка от ошибки привязки посещения.
Для Метрики проверяются результаты обработки офлайн-загрузки и сопоставления с посещением. Для GA4 успешный ответ Measurement Protocol подтверждает приём HTTP-запроса, но не гарантирует появление корректного события в отчётах. Период, часовой пояс и фильтры отчёта должны соответствовать проверяемой конверсии.
Частые причины ошибок
| Симптом | Что проверить |
|---|---|
| В сети одобрено, в сервисе на проверке | Вместо ACCEPTED пришло число 4, старое имя lead_status заменено на status либо не получено обновление |
| Сумма пустая | Получатель ждёт top_cost, а новый кабинет отправляет publisher_commission под другим именем |
| Доход завышен | Комиссию подменили суммой заказа order_total либо сложили несколько состояний одной заявки |
| Пустые поля аналитики | Перепутаны subN, sub_idN и aff_subN, идентификаторы не были переданы при переходе |
| HTTP 200, но события нет | Ответ получателя, исходящую отправку в аналитику и обработку отчётом проверяют по отдельности |
| Две заявки стали одной | Совпадение order_id у разных офферов или целей, ошибочный ключ сопоставления |
| Часть состояний отсутствует | Фильтрацию по статусам, офферам и источникам, действие глобальных и отдельных правил |
Включать дополнительные скрипты и исключения для конкретного домена стоит только после установления причины. Сначала проверьте поля, статусы и прохождение одного реального события по всей цепочке.
Частые вопросы
Почему в других инструкциях указаны WAIT, ACCEPTED и REJECTED?
Они относятся к другой схеме интеграции. Новый проверенный кабинет показывает четыре числовых состояния и позволяет переименовать их в блоке маппинга. Используйте документацию именно той формы, в которой настраиваете постбэк.
Можно ли просто заменить top_cost на publisher_commission?
Для комиссии новое поле подходит по описанию справочника, но одна замена не решает остальные различия. Нужно также проверить ID заявки, статусы, даты и SubID.
Нужно ли учитывать холд как одобрение?
В новом справочнике это разные состояния: 2 и 4. Правило учёта задавайте явно. Состояние «В холде» само по себе не является значением «Одобрено».
Можно ли получить ClientID из order_id или p_click_id?
Эти поля не создают ClientID Метрики или GA4. Нужный идентификатор получают на сайте через соответствующую аналитику и передают в сеть до возникновения заявки.
Источники и дата проверки
Справочник макросов, список SubID, методы отправки и четыре статуса проверены 8 ноября 2026 года в официальном новом кабинете Rafinad, раздел «Постбеки». Нужен вход в аккаунт. Старая схема описана по существующему шаблону ВебНиндзя и явно отделена от новой.
- Официальный FAQ Rafinad: разделы кабинета, потоки и назначение SubID.
- Яндекс.Метрика: получение ClientID.
- Яндекс.Метрика: передача офлайн-конверсий.
- Google: Measurement Protocol для GA4.
Подключите постбэк к ВебНиндзя
Подключите аналитику и настройте параметры по инструкции для своей сети. В кабинете получите свой URL приёма конверсий и историю отправок.