Общие сведения об интеграции
API-интеграция - это хитрый механизм, с которым лиды из вашей сети попадают в целевую партнёрскую сеть или CRM, а обратно возвращаются их статусы обработки и комментарии. Все процессы скрыты от глаз простого пользователя и происходят автоматически.
Сети на базе AlterCPA
Перед интеграцией попросите вашего рекламодателя создать агентство на стороне своей сети и скинуть вам появившееся сообщение. Из него вы получите все необходимые сведения. В AlterCPA Moe агентство называется источником трафика. Некоторые рекламодатели вредничают и предлагают работать с ними в качестве вебмастера, здесь пригодится инструкция AlterCPA Pro Webmaster.
Партнёрские сети
Интеграция с партнёрскими сетями требует договорённости с вашим личным менеджером. Вам могут потребоваться идентификаторы офферов или товаров на стороне партнёрской сети. В некоторых сетях требуется создание потоков и указание их идентификаторов. Если утилита не показывает список постбеков в момент настройки, добавлять постбеки не требуется - выгрузка статусов происходит по API.
Классические CRM
Многие интеграции с классическими CRM являются шаблонами и требуют дальнейшей доработки. В зависимости от требований заказчика, вам могут потребоваться дополнительные поля при отправке лидов и дополнительные варианты при выгрузке статусов.
Финансовые сети
Все интеграции рассчитаны на автоматическую передачу ссылки на сайт для идентификации оффера. В качестве ссылки используется лендинг из хранилища сайтов. Некоторые интеграции также используют параметр group для символьного названия группы офферов. Некоторые интеграции требуют указания постбека на депозит. Для них указывается "хвост" и образец готового постбека.
Финансовые CRM
Перед интеграцией проверьте, нет ли вашей сети в списке партнёрских сетей с уникальной платформой. Если сеть не нашлась, попробуйте определить CRM с помощью нашей небольшой памятки.
Ручная настройка интеграции
Ручная настройка интеграции требует понимания принципов отправки запросов к API и базовых знаний языка PHP. При настройке интеграции вам потребуется описать подготовку запроса и обработчики ответа на PHP. Без знаний программирования ручная настройка интеграции невозможна. Пожалуйста, обращайтесь только к компетентным специалистам.
Подготовка запроса
Перед выполнением любого запроса, интеграция выполняет содержимое кода предобработки. Вы можете использовать его для тонкой настройки запроса: преобразовать в JSON, добавить заголовки, провести авторизацию, скорректировать некоторые поля, сделать цифровую подпись к запросу.
Параметры в интеграции
Параметры - это особые произвольные поля, которые можно добавлять к офферам, их целям и вложенным товарам. Они позволяют хранить переменные, которые изменяются от оффера к офферу. Например, идентификаторы оффера или потока на стороне целевой сети.
Отправка лидов
Отправка лидов может использоваться в четырёх ситуациях: отправка новых лидов в CRM, отправка апсейлов и изменений, отправка принятых лидов в CRM и синхронная отправка лидов на регистрацию.
Проверка статусов по API
Выгрузка статусов может работать в трёх вариациях: проверка статусов лидов в обработке, проверка статусов принятых лидов и проверка статусов по диапазону дат.
Получение статусов через постбек
Получение статусов лидов по API является оптимальным вариантом работы. Если работа по API невозможна, вы можете использовать постбеки из целевой сети для получения статусов.