📥🔗🧩

Интеграция с трекером Keitaro

4 минуты

Так как Keitaro - это трекер, то интеграция между SalesRender и Keitaro сводится к настройке вебхука, который будет сообщать в Keitaro изменения о статусе лида.

Шаг 1: настраиваем передачу “лида” в CRM

В SalesRender есть понятие “заказ” и есть понятие “лид”. Они имеют разное назначение. Заказ это запись в CRM, о том какой клиент и что у вас заказал.

Однако в заказе также может быть информация о том, создан ли этот заказ вебмастером, по какому офферу и с какой ставкой и иной дополнительной информацией. Вся эта информация об оффере, вебмастере, ставке - это и есть информация о лиде внутри заказа.

Лид передают при работе по CPA-системе, если вы работаете с партнерами, кто предоставляет вам трафик, то внутри каждого заказа эти партнеры передают вам информацию о лиде.

В админке CRM системы есть такой столбец “Лид”. В нем либо есть информация, либо нет. Поэтому первое, чтобы работал вебхук Keitaro, нужно сделать поступление информации о лиде.

Для того, чтобы передать лид, вам не нужно менять API. Любое, на котором вы работаете (API CPA, API CRM, совместимое API) подойдет. API CPA и совместимое API автоматически создает лид, а в API CRM данные о лиде можно просто добавить в запрос на формирование лида: webmasterId и offerId

Тогда все заказы будут содержать информацию о лиде.

О том, какие значения передавать в webmasterId и offerId - в следующем шаге инструции

Шаг 2: Настраиваем параметры webmasterId и offerId

Вебхук Keitaro будет срабатывать только на те лиды, которые приходят из Keitaro. Поэтому все лиды из Keitaro нужно как-то отделить от других.

Для этого сначала нужно зарегистрировать “вебмастера”, от которого будут приходить все лиды из Keitaro

Задайте email и пароль, сохраните эти данные, они еще пригодятся в следующих шагах.

После того, как вебмастер зарегистрирован, то вы можете увидеть его ID, это и есть webmasterId который нужно передавать в запросе на создание заказа

Теперь создаем оффер в том же модуле CPA - Офферы.

Здесь важно:

  • установите размер и валюту ставки (скорее всего за апрув)
  • установите время холда (обычно ставят 0, чтобы все работало быстро)
  • далее выберите статус, куда приходят заказы (например, Обработка)
  • выберите проект (нужен только для категоризации заказов)
  • доступность - всегда
  • товары и акции - просто для вашего удобства, чтобы вы знали что продается в этом оффере

В соответствии полей нужно проставить, какие данные из Keitaro в какие поля попадут. Обязательно заполните этот блок.

Важно: Чтобы вебхук срабатывал, у вас обязательно должен быть какой-то уникальный идентификатор заказа, например ID клика, sub ID и так далее. Настройте передачу этого параметра при создании заказа в любое поле с типом String. А в соответствии полей проставьте это поле в “строки”, чтобы оно сохранялось в заказе.

Далее пролистните форму ниже и увидите “Видимость полей для вебмастера”. Убедитесь, что это поле, куда передается уникальный идентификатор из Keitaro полностью открыто настройками.

Сохраните оффер и именно этот offerId передавайте при создании заказа.

Шаг 3: Устанавливаем ссылку вебхука

Те данные, которые вы указывали при регистрации вебмастера, сейчас вам понадобятся.

Нужно войти по ссылке https://cpa.salesrender.com/XXX/auth

Где XXX это ID вашей компании (можете найти его в названии вашей группы в Telegram)

Далее вводим тот email и пароль, что вы только что указывали в Шаге 2

Затем откройте пункт Вебхук и впишите туда ссылку, которую вам предоставили в Keitaro

В Content type укажите JSON, в Request method GET

Обратите внимание, что в ссылке обязательно должен быть параметр, куда Keitaro передает уникальный идентификатор. На скриншоте он передается в Дополнительное поле 1, чему соответствует переменная {{data.string_1}}

Если у вас возникли сложности на этом этапе, обязательно напишите в нашу поддержку, мы поможем с формированием правильной ссылки.

Шаг 4: Тестируем вебхук

На данном этапе все просто: вы делаете тестовый заказ, перемещаете его в любой статус, в котором произойдет апрув или отмена. Вебхук об этом получит Keitaro, спросите у них - все ли правильно и посмотрите, засчиталась ли у вас конверсия в кабинете.

А если будут вопросы, пишите нам!


Еще больше возможностей можно увидеть на нашем веб-сайте salesrender.com

Подписывайтесь на наш канал в Telegram

Контакт СЕО Анна в Telegram

Спасибо за уделенное время 💚