Postback для партнеров

Postback для партнера — webhook (вебхук), который передает данные о регистрации/заказе/оплате реферала во внешний сервис (трекер).

Каждый партнер в своем личном кабинете партнера может самостоятельно настроить Postback.

Передаются только те данные, к которым имеет отношение партнер.

Содержание статьи:

• Настройка Postback в личном кабинете партнера
• Когда срабатывает Postback и для кого?

Дополнительные статьи:

• Настройка партнерской программы
• Комиссии для партнеров

Для настройки необходимо:

1) Перейти в раздел «Партнерская программа», открыть вкладку «Постбеки»

2) Указать URL с GET-параметрами и переменными для событий:

— Регистрация пользователя.
— Создание заказа.
— Изменение статуса заказа (любой статус).
— Успешное завершение заказа (изменение статуса).
— Отмена заказа (изменение статуса).

Переменные необходимо указать в фигурных скобках, например, {deal_id}

Пример URL:

https://domain.ru/exec?p1={deal_id}&p2={deal_status}&p3={deal_cost}&p4={utm_source}&p5={utm_medium}


3) Нажать на кнопку «Сохранить» внизу страницу.

Список доступных переменных для событий:

— Регистрация пользователя:
{user_id} — ID пользователя.
{user_created_at} — Дата регистрации пользователя.
{utm_source} — Utm-source.
{utm_medium} — Utm-medium.
{utm_campaign} — Utm-campaign.
{utm_term} — Utm-term.
{partner_code} — Партнерский код.

— Остальные события по заказам («создание заказа», «изменение статуса заказа (любой статус)», «успешное завершение заказа (изменение статуса)», «отмена заказа (изменение статуса)»):

{user_id} — ID пользователя.
{deal_id} — ID заказа.
{deal_created_at} — Дата создания заказа.
{deal_status} — Статус заказа.
{deal_status_at} — Дата изменения статуса заказа.
{deal_cost} — Стоимость заказа.
{deal_currency} — Валюта.
{deal_title} — Названия позиций в заказе.
{partner_by_user} — 1 — если партнер закреплен за пользователем.
{partner_by_deal} — 1 — если партнер закреплен за заказом.
{utm_source} — Utm-source.
{utm_medium} — Utm-medium.
{utm_campaign} — Utm-campaign.
{utm_term} — Utm-term.
{partner_code} — Партнерский код.

UTM-переменные и partner_code — это данные из сессии, которая связана с пользователем/заказом.

Просмотр логов отправленных вызовов

В нижней части настройки Postback нажмите ссылку «Лог отправленных постбеков». Она открывает страницу с кратким логом вызовов для текущего партнера.

Выводятся информация о 100 последних вызовах со следующими данными:

— «Создан» — дата и время запроса.

— «Название» — название события.
— «Запрос» — фактический URL (с замененными переменными).
— «Ответ» — ответ на запрос.

— «HTTP-код» — код результата запроса.

Опция «Не отправлять постбэки по бесплатным заказам» позволяет отключить отправку постбеков по заказам с нулевой стоимостью.

Когда срабатывает постбек по событиям:

1) «Регистрация пользователя»

Пользователь регистрируется самостоятельно по партнерской ссылке.

2) «Создание заказа»

Реферал партнера оформил заказ самостоятельно или заказ был оформлен по партнерской ссылке

3) «Изменение статуса заказа (любой статус)», «успешное завершение заказа (изменение статуса)», «отмена заказа (изменение статуса)»

Изменяется статус заказа (автоматически или вручную) и этот заказ закреплен за партнером или пользователь, создавший заказ, закреплен за партнером.

Для кого срабатывает постбек

Запуск постбека для партнера определяется глобальными настройками партнерской программы. Если в настройке «Если реферал оформляет заказ по ссылке другого партнера» выбрано:

— «Одноразово начислять комиссию по последнему партнерскому коду»

Постбек будет отправлен партнеру, по партнерской ссылке которого пользователь оформил заказ.

— «Начислять комиссию основному партнеру»

Постбек будет отправлен партнеру, за которым закреплен пользователь.