Заявки и решения
Платформа и ваша система обмениваются заявками, решениями и конверсиями. Что именно передаётся, определяют ваш процесс и способ подключения.
API и интеграции · Affelora
API для партнёров
и связь программы с CRM.
Платформа обменивается данными с вашей системой по API и постбэкам. Заявки, решения и отмены попадают к нужному партнёру и в его начисления без ручных таблиц.
Зачем нужна интеграция
Что даёт API партнёрской программы
Под «API для партнёров» обычно понимают одно из двух: обмен данными между партнёрской программой и CRM компании или доступ самих партнёров к офферам и статистике. Первое платформа делает по API и постбэкам, второе партнёр получает в кабинете: ссылки, статистику, статусы и начисления.
Статусы из CRM
Клиента проверяют там, где работает ваша команда. Статус приходит в платформу по API или постбэку, и партнёр видит решение в своём кабинете.
Click ID и метки sub1–sub5
По Click ID платформа находит, с какого перехода по партнёрской ссылке пришла заявка. В метках партнёр отмечает кампанию, площадку и размещение. Разница — в руководстве Click ID и SubID.
Начисления по статусу
Вознаграждение считается по условиям оффера и статусу заявки. Как учитываются отмена и исправление решения, проверяем при подключении.
Заявка из кабинета
В отдельных сценариях агент или партнёр передаёт клиента заявкой из кабинета. Поля, проверку и передачу в вашу систему согласуем при внедрении.
Данные для проверки качества
Статусы и отмены из CRM показывают, чем закончился переход, — так проще заметить повторы и заявки, которые не доходят до решения.
Если интеграции пока нет
Статус заявки может ставить сотрудник в кабинете рекламодателя. Партнёр всё равно видит решение по своей заявке, а обмен с CRM подключается, когда готов сценарий.
Как это работает
Интеграция с CRM: четыре шага
01Сценарий
Описываем путь заявки: где она появляется, кто принимает решение и когда возникает вознаграждение.
02Сопоставление
Сверяем поля, идентификаторы и статусы вашей CRM с процессом программы.
03Подключение
Настраиваем обмен по API и постбэкам по документации вашей системы.
04Сквозной тест
Тестовая ссылка, заявка, решение, постбэк и начисление партнёру.
Тест пройден, когда тестовая заявка дошла до нужного партнёра и оффера, получила статус из CRM и дала верное начисление.
Обмен данными
Что передаём, в каком направлении и зачем
Типовой состав обмена партнёрской программы. Точный набор полей и направлений зависит от вашей системы и сценария, его фиксируем при подключении.
| Что передаём | Направление | Зачем |
|---|---|---|
| Click ID | С переходом по партнёрской ссылке на ваш сайт, затем обратно вместе с результатом | Связать заявку с конкретным переходом, партнёром и оффером |
| Метки sub1–sub5 | От партнёра в платформу, в параметрах ссылки | Различать кампании, площадки и размещения в статистике |
| Заявка | Из вашей системы в платформу или из кабинета агента в вашу систему — отдельный сценарий, поля и передачу согласуем при внедрении | Учесть результат партнёра или передать клиента в работу |
| Статус заявки | Из вашей CRM в платформу по API или постбэку | Показать партнёру решение и начислить вознаграждение по условиям оффера |
| Отмена или исправление решения | Из вашей CRM в платформу | Отразить в учёте изменение исходного результата |
| Итог по заявке | Из платформы в кабинет партнёра | Партнёр видит статус, начисление, баланс и акты без запроса менеджеру |
Какие поля обязательны, как они называются и как система проверяет запросы, смотрим в документации вашей CRM. Телефон и email клиента в метки не кладём: адрес ссылки остаётся в журналах серверов и может попасть к сторонним сервисам. Как устроены ссылки, метки и проверки подключения, подробно описано на странице трекинг и постбэки.
Совместимость
Как проверяем, подойдёт ли ваша CRM
Готовой интеграции с любой CRM мы не обещаем. Подключение зависит от того, что умеет API конкретной системы и какой сценарий вам нужен, поэтому начинаем с её документации.
Что смотрим в вашей системе
- Есть ли в CRM поле для Click ID из ссылки.
- Каким запросом CRM сообщает о смене статуса.
- Какие статусы означают решение, а какие — промежуточный этап.
- Кто меняет настройки обмена в CRM.
Что решает ваша команда
- В какой системе принимают окончательное решение по клиенту.
- В какой момент возникает вознаграждение.
- Как поступать с дублями, отменами и корректировками.
- Кто отвечает за техническую проверку с вашей стороны.
Состав обмена разбираем на показе продукта на примере вашего процесса. Кроме CRM, платформу можно связать с CPA-сетями, у которых есть доступный обмен. Если нужной системы нет среди готовых подключений, новый коннектор оцениваем отдельно.
Стоимость
Сколько стоит интеграция партнёрской программы с CRM
Настройка готовых подключений и постбэков входит в часы тарифа. Старт — 24 900 ₽/мес и 2 часа специалиста, Бизнес — 44 900 ₽/мес и 5 часов, Развитие — 69 900 ₽/мес и 10 часов.
| Работа | Как оплачивается |
|---|---|
| Готовое подключение, постбэк и статусы | В часах тарифа по фактическому времени |
| Разбор расхождений между CRM и платформой | В часах тарифа |
| Плановая проверка согласованных интеграций | В «Бизнесе» — раз в месяц, в «Развитии» — раз в неделю, вне пакета часов |
| Новый коннектор, нестандартный обмен с CRM, перенос истории | Отдельный проект: 3 500 ₽/ч с пределом бюджета |
Плановая проверка — тестовая заявка, статусы, ошибки передачи и краткий отчёт. Это не круглосуточный мониторинг. Ошибки Affelora исправляем без расхода часов, изменения в сторонних системах — отдельная задача. Подробнее — в разделе часы специалиста и дополнительные работы.
Частые вопросы
Вопросы об API и интеграции с CRM
Как узнать, какие данные передаются по API?
Типовой состав — в таблице выше: Click ID, метки sub1–sub5, заявка, статус, отмена или исправление решения. Точный набор полей фиксируем при подключении по документации вашей системы.
Есть ли готовая интеграция с моей CRM?
Готовая интеграция есть не с каждой CRM. Совместимость с вашей CRM проверяем по её API и документации. Если среди готовых подключений её нет, новый коннектор оцениваем отдельно, до начала работ.
Можно ли запустить программу без интеграции?
Да. Пока обмен не настроен, статус заявки ставит сотрудник в кабинете рекламодателя. Партнёр видит решение и начисление в своём кабинете.
Что будет, если в CRM статус изменился после подтверждения?
Передачу отмен и исправлений проверяем при подключении, чтобы новое решение из CRM попало в учёт. Как корректируются начисления, задают правила вашей программы.
Нужен ли партнёрам отдельный API?
Партнёру достаточно кабинета: ссылки с метками, статистика, статусы заявок, начисления и акты. Нужен ли обмен с системами отдельных партнёров, обсудим на демонстрации.
Какие данные клиента передаются в платформу?
Состав данных определяет ваша компания и фиксирует при подключении. Для связи заявки с партнёром достаточно технических идентификаторов, а телефоны и email в ссылках и метках не нужны.
Полезное дальше
Другие материалы по теме
Антифрод Affelora
Статусы из CRM помогают проверять трафик.
Антифрод сопоставляет клик, целевое действие и поток источника. Статусы и события из вашей системы помогают связать переход с результатом и заметить повторы до подтверждения вознаграждения. Спорную заявку проверяет сотрудник, а состав проверок зависит от подключённых данных.
