# Как интегрировать партнерские сети в Keitaro

Алгоритм взаимодействия Keitaro и партнерских сетей:

  1. Страницы партнерской сети размещаются в кампаниях трекера, куда трекер и отправляет трафик;

  2. В случае получения конверсии партнерская сеть отправляет postback в трекер для сбора статистики конверсий и вывода отчетов.

В трекере каждая партнерская сеть выделена в отдельный шаблон с необходимыми для настройки Postback данными. Чтобы получать статистику из партнерской сети в трекер, необходимо правильно настроить Postback.

# Добавление партнерской сети

Партнерская сеть в Keitaro создается из шаблона, раздел Партнерские сети — Создать. Все шаблоны добавлены по документации или прямому запросу представителей соответствующих партнерских сетей.

Шаблон подключается к офферу типа Редирект для автоматической передачи subid клика трекера в партнерскую сеть. Партнерская сеть принимает subid в ее параметр клика и передает в postback обратно в трекер при получении конверсии. Это является обязательным критерием правильной настройки Postback.

# Настройки

  • Шаблон. Выберите шаблон из списка.
  • Название. Имя партнерской сети в разделе Партнерские сети.
  • Параметры оффера. Список параметров, которые автоматически добавляются к ссылкам офферов для передачи значений параметров в партнерскую сеть. Пример &sub1={subid}&sub2={ip}, где слева указан параметр партнерской сети, в который возможно принять значение, а справа — параметр трекера.

В партнерскую сеть с кликом или заявкой передается реальное значение ID клика трекера subid и в данном примере IP-адрес клика. Обязательно передавайте subid. Остальные параметры опционально, по запросу партнерки. При необходимости аналогично передаются и другие параметры.

  • Postback URL. Используется партнерской сетью для отправки конверсии в трекер. Добавьте ссылку в личном кабинете партнерской сети в поле Глобальный Postback. Все postbacks партнерской сети отправляются в трекер по указанному адресу.

TIP

Postback URL в шаблоне — заметка для удобства пользователей. Используется для быстрой команды копировать-вставить, как правильное готовое решение. Не влияет на настройки внутри трекера. Не рекомендуется менять данные без прямого указания представителей или документации партнерских сетей, поддержки Keitaro.

# Интеграциии с партнерскими сетями

# Настройка партнерской сети без шаблона

Видео

При создании новой партнерской сети в Keitaro, первую половину ссылки Postback URL получаем автоматически. Первая половина состоит из домена и индивидуального Postback key

Остается добавить знак вопроса «?» после слова «postback» и прописать необходимые параметры, с которыми работает партнерская сеть. Список параметров доступен либо на вкладке настройки postback в СРА сети, либо необходимо запросить у менеджера.

Например, в партнерской сети М1 список всех доступных макросов представлен на вкладке Глобальный Postback:

Разберем подробнее.

Все параметры делятся на обязательные и дополнительные.

Обязательным параметром в каждой ссылке Postback является идентификатор клика, параметр, отвечающий за subid, без передачи которого postback не работает. В М1 данный параметр называется меткой. Метка, к которой привязывается значение передачи subid. Параметр необходимо добавлять к каждому офферу в настройках Postback URL.

М1 предлагает на выбор 3 метки: S,W,T. Достаточно взять одну на выбор.

Возьмем S и прикрепим ее к параметру subid. Пропишем в поле Параметры для офферов и первым компонентом в Postback URL

Под метку subid передаем динамический параметр {s}, которому присвоили макрос {subid}.

Далее, прописываем дополнительные параметры postback, каждому из которых необходимо присвоить соответствующую метку.

Например, в М1 доступен параметр {status}, который передает информацию о статусе лида.

Общепринято использовать метку status. Поэтому далее прописываем status={status}. Не забывайте, что параметры в ссылке разделяются символом «&» и выглядят следующим образом:

И далее, по желанию, прописываем все остальные параметры:

Главное, чтобы макросы из партнерки совпадали со списком доступных макросов Keitaro.

Не забывайте активировать передачу всех статусов лида в кабинете M1:

Если в партнерской сети предусмотрен тест Postback, то при правильной настройке, сделав запрос, получите ответ «200» и статус Success:

Если функция отсутствует, то возможно проверить правильность входящего postback внутри Keitaro, открыв вкладку Обслуживание → Логи → Postbacks. Обращаем внимание, что тестовые postbacks не видны в отчетах Keitaro:

Хотите добавить в шаблоны Keitaro?

Пришлите письмо на support@keitaro.io:

  • Название партнерской сети;
  • Ссылку на официальную инструкцию по настройке Postback;
  • Валюту выплат;
  • Доступные параметры для ссылки оффера.

# Как создать postback ссылки на регистрацию и депозит

Рекламодатель или партнерская сеть iGaming направления запрашивает ссылки postback на регу и деп, по которым отправит конверсии в трекер. Покажем, как правильно собрать ссылки для передачи менеджеру, на примере готового шаблона и при отсутствии такового в трекере.

  1. Если доступен шаблон партнерской сети (на примере 1win)

Замените в ссылке postback status=[REPLACE] на статичные значения статусов трекера:

status=lead — для Регистрации.

status=sale — для Депозита.

В итоге должны получиться ссылки:

На регистрации: https://demo-en.keitaro.io/f1ec56f/postback?subid={sub1}&payout={amount}&status=lead&currency=usd&from=1win.run

На депозиты: https://demo-en.keitaro.io/f1ec56f/postback?subid={sub1}&payout={amount}&status=sale&currency=usd&from=1win.run

  1. Если шаблона партнерской сети нет

Обязательным параметром в каждой ссылке Postback является параметр, отвечающий за идентификатор клика. В Keitaro — это subid. Необходимо запросить информацию о том, какой параметр отвечает за идентификатор клика в вашей партнерской сети (рекламодателе). После соберем шаблон партнерской сети в трекере по аналогии с инструкцией и создадим две ссылки Postback со статусами, как и в примере выше:

Создадим две ссылки Postback со статусами, как и в примере выше:

На регистрацию: https://demo-en.keitaro.io/f1ec56f/postback?subid={sub1}&status=lead&from=NAME_YOUR_NETWORK

На депозиты: https://demo-en.keitaro.io/f1ec56f/postback?subid={sub1}&payout=REPLACE&status=sale&from=NAME_YOUR_NETWORK

Где sub1- имя параметра, который в партнерской сети отвечает за идентификатор клика или в который партнерской сети возможно передать subid.

payout=REPLACE — замените REPLACE на нужную выплату, например: payout=30 (для статичной передачи выплаты) или payout={amount}, если партнерская сеть передает выплату динамически в метке {amount}.