Интеграция
Получение ответов из Яндекс.Форм → Отправка лида в Traffic Light
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма ответов из Яндекс.Форм: укажите поля заявки, скопируйте URL вебхука и подключите интеграцию API в форме с POST и JSON.
- Настройка отправки лида в Traffic Light: ключ API, ID оффера, телефон, IP-адрес и дополнительные поля заявки из данных сценария.
Отдельные инструкции: источник «Получение ответов из Яндекс.Форм» · действие «Отправка лида в Traffic Light»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «Яндекс.Формы» и нажмите кнопку «Выбрать».
Источник «Яндекс.Формы»
Ответы из Яндекс.Форм начнут поступать на URL источника после настройки интеграции API в форме. Укажите поля ответа, скопируйте URL и настройте POST-запрос с JSON в Яндекс.Формах.
URL вебхука
- Откройте вкладку «Источник данных».
- Скопируйте «URL» - он понадобится в настройках Яндекс.Форм.
Интеграция в Яндекс.Формах
- Откройте нужную форму в Яндекс.Формах.
- Перейдите на вкладку «Интеграция».
- Нажмите «Добавить группу действий», выберите «API», затем «Запрос заданным методом».
- В поле «URL» вставьте скопированный адрес.
- Выберите метод «POST».
- В тело запроса добавьте переменную «Ответы на вопросы в виде JSON» и отметьте все вопросы.
- Нажмите «Сохранить».
Заполните и отправьте тестовую форму.
После этого перейдите обратно в обработку на закладку "Источник данных" и нажмите на значок карандаша возле надписи "Настройки".
В открывшемся окне нажмите «Получить поля из последнего запроса».
После того как поля загрузятся нажмите кнопку «Сохранить».
Действие «Отправка лида в Traffic Light»
Отправляйте заявки в CPA-сеть Traffic Light (cpa.tl) прямо из сценария. Укажите ключ API и ID оффера, подставьте телефон, IP и остальные поля лида - после выполнения действия получите код лида и данные о выплате.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Обязательные поля
- В поле «Ключ доступа к API» вставьте ключ из профиля кабинета Traffic Light.
- В поле «ID оффера» укажите идентификатор оффера в Traffic Light.
- В поле «Телефон покупателя» укажите телефон или подставьте переменную из источника. Формат номера может быть любым.
- В поле «IP-адрес» укажите IP лида. Если IP получить нельзя (лид-формы Facebook, TikTok и т.п.), укажите
0.0.0.0.
Рекомендуемые поля
- В «ФИО покупателя» укажите имя или ФИО клиента.
- В «ID потока» вставьте ID потока со страницы потоков.
- В «Строка User-Agent» при возможности передайте User-Agent клиента - это помогает контролировать трафик.
- В «ID лида» можно передать ID заявки из вашего источника (Facebook, TikTok, CRM).
- В «ID вебмастера» укажите свой идентификатор в вашей системе или
0.
Дополнительные поля
- При необходимости заполните «Комментарии к заказу», «Код страны покупателя», «Адрес покупателя», «Временная зона» и «Email покупателя».
- В «Код страны покупателя» укажите код Alpha-2, например
RUилиKZ. Список кодов есть в ISO 3166-1. - В «Временная зона» укажите число смещения, например
3для Europe/Moscow. - При необходимости заполните UTM-метки: «UTM Source», «UTM Medium», «UTM Campaign», «UTM Content», «UTM Term».
- При необходимости заполните «Доп. инфо 1» … «Доп. инфо 5» и «Доп. инфо 1024».
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».