Postbacks
Раньше при интеграции у партнёров часто возникало много вопросов — что настроить, где подключить, как всё правильно запустить. Чтобы упростить процесс и сэкономить вам время, мы решили добавить готовые интеграции: всё уже продумано за вас, достаточно просто подключиться.
ИНСТРУКЦИЯ ПО СОЗДАНИЮ КАСТОМНОЙ ИНТЕГРАЦИИ (если готовой ещё нет)
Если нужной вам интеграции в списке пока нет — не переживайте. Вы можете настроить всё вручную.
1) Откройте трекер. Когда окажетесь внутри, найдите в меню раздел «Интеграции» и перейдите туда.
2) На этапе настройки укажите параметр, в который в вашей партнёрке будет записываться наш clickid. Это важно: без этого параметра мы не сможем корректно отслеживать конверсии и передавать данные.
3) Создайте конфигурации постбеков (ваши ссылки).
Обычно делают три постбек-ссылки:
для регистрации (Registration)
(вам необходимо самостоятельно задать ивенты - для регистрации registration)
для первого депозита (First Deposit)
(для ФД первого депозита - sale)
и для повторных депозитов (Recurring Deposit)
(для РД - resale или sale + tid)
Чтобы увидеть сами ссылки, просто нажмите на значок > рядом с нужным полем — там и будет спрятана ваша готовая ссылка.
Registration - вы получили готовую ссылку, которую нужно вставить в партнерку.
Если ваша партнёрка передаёт дополнительную информацию о клиентах — например, ID пользователя или гео вы можете настроить, какие именно данные хотите забирать.
Для этого нужно прописать:
Ключ кастомного поля - кастомное поле, которое вы создали внутри Chatterfy.
Параметр — откуда именно в партнёрке брать значение
ПРИМЕР:
Пишите fields.userid — и указываете, что он подтягивается из {user_id} партнёрки.
First Deposit - вы получите ссылку, но сразу вставлять её в партнёрку нельзя.
Сначала ccылку нужно правильно самостоятельно преобразовать — настроить все параметры так, чтобы партнёрка понимала, что за событие вы передаёте.
Дальше — важно: вам нужно самостоятельно преобразовать ссылку под свою партнёрку.
Здесь:
{amount} — сумма депозита,
{currency} — валюта операции.
Эти параметры могут отличаться в зависимости от вашей партнёрки.
Recurring Deposit - вы получите ссылку, но сначала её нужно правильно преобразовать
Дальше — важно: вам нужно самостоятельно преобразовать ссылку под свою партнёрку
Пример готовой преобразованной ссылки: https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=resale&clickid={sub1}&tracker.tid={event_id}
3) Далее переходим в раздел создания ссылки
Link name - Registration (внутреннее название вашей ссылки)
Base URL - вставьте ссылку которую вам дала партнерка (ссылка которую вы даете лиду)
В разделе Final URL with Parameters вы получите готовую ссылку, в которой уже будут стоять все необходимые параметры.
В эту ссылку вы можете добавлять любые параметры, нужные вам, например: https://api.chatterfy.ai?sub4={{tracker.clickid}}
ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ГОТОВЫХ ИНТЕГРАЦИЙ
1) Нажимаем на интеграцию 1win
2) На этапе настройки укажите параметр, в который в вашей партнёрке будет записываться наш clickid (в данном примере - sub4)
2) Конфигурации постбеков в данном случае создавать не нужно - они уже заранее настроены. Открываем доступные ссылки и забираем готовые — просто вставляем их в партнёрку.
3) Далее нам нужно получить готовую ссылку, которую нужно передать лидам. Для этого переходите в раздел Ссылки регистрации (Registration links), вставьте свою ссылку (ее вам выдала партнерка) — готово, в поле Готовая ссылка с параметрами (Final URL with Parameters) в получаете готовую ссылку, которую будете выдавать клиентам внутри нашей CRM В эту ссылку вы можете добавлять любые параметры, нужные вам, например: https://api.chatterfy.ai?sub4={{tracker.clickid}}&fields.userid={user_id} - в данном случае мы из партнерки может автоматически забрать ID клиента и записать его в кастомное поле внутри СРМ
Постбеки в трекере (запись внешних данных)
Инструкция по созданию кастомных полей: Нажмите, чтобы перейти
Если вам необходимо записать кастомную информацию о клиенте, например сумма последнего депозита, ID клиента.
Вам нужно в постбеке трекера, который вы добавляете в партнерку добавить fields.key параметра=параметр из партнерки
Например, постбек для FD
Таким образом, пользователю запишется ивент sale, а в кастом филды пользователя запишется параметры last_deposit и user_id
FAQ - Часто задаваемые вопросы 📍
1) Для чего нужно настраивать постбеки?
Начнем с основы, вы лиду даете ссылку на регистрацию в партнерке, типа partner.com/signup?clickid={{tracker.clickid}}
Когда лид зарегистрируется, то партнерка отправит запрос туда, что вы указали в их постбеках
Например, https://api.chatterfy.ai/api/postbacks/5540a501-882f-4a94-8b5d-a2b888a9fd0f/tracker-postback?clickid={clickid}&tracker.event=registration В какой конкретно параметр передавать {{tracker.clickid}} зависит от партнерки.
Last updated