Займы (бета) в тематических разделах Директа: МКК и МФО, новые и повторные клиенты, API

Займы (бета) в тематических разделах доступны МКК и МФО с лицензией ЦБ РФ из государственного реестра. Для новых клиентов цена целевого действия — за каждый оформленный займ, для повторных — за клик «Оформить» в отдельной кампании быстрого оформления на сегментах Яндекс Аудиторий. Данные об оформленных займах передаются в Директ по API: рекомендуется до 3 дней, не позже 11.

Цифры

Условия

Параметр	Значение
Статус	бета-тестирование
Кто допускается	МКК и МФО с лицензией ЦБ РФ, включённые в государственный реестр
Где показывается	поиск по Финансам, раздел «Займы», все типы устройств
Ранжирование	ставка (цена целевого действия), кликабельность, коэффициент релевантности
Продукт в кампании	Займы (бета)
Бюджет	ограничение расхода в неделю
Валидация API	до 72 часов
Передача данных об оформленных займах	рекомендуется в течение 3 дней, не позже 11 дней после оформления договора
Столбец «Конверсии»	количество оформленных займов
Подключение к API	письмо на finance-search@yandex-team.ru с заголовком «Интеграция API в займах» и названием организации
Токен для методов на стороне Яндекса	выдаётся единоразово на этапе подключения

Две кампании

Параметр	Новые клиенты	Повторные клиенты
Тип кампании	обычная	кампания быстрого оформления
Цена целевого действия	за каждый оформленный займ	за клик по кнопке «Оформить»
Бюджет и цена	задаются отдельно в кампании	задаются отдельно в кампании
Таргетинг по аудитории	в справке не нашли	сегменты Яндекс Аудиторий, которые организация формирует и передаёт Яндексу
Конкуренция в списке предложений	не конкурирует с кампанией для повторных клиентов	не конкурирует с обычной кампанией
Статистика	учитывается раздельно	учитывается раздельно: показы, клики, оформленные займы

Методы API

Метод	Кто реализует	Запрос	Назначение
Первичная проверка по номеру телефона	партнёр	POST /check	вызывается сразу после авторизации пользователя в Яндекс ID
Передача ссылки на предложение	партнёр	GET /link	актуализация ссылок через время после получения предложений
Запрос предложений	партнёр	в справке не нашли	страница метода не получена
Передача предложений Яндексу	Яндекс	POST /send-offers	возврат предложений, доступных клиенту; вызывает партнёр по результату скоринга
Подтверждение обработки заявки GET	Яндекс	GET /link (как написано на странице)	подтверждение оформления договора для учёта конверсии
Подтверждение обработки заявки POST	Яндекс	POST /link	то же; для POST доступна массовая отправка
Отчёт о нахождении фродера	Яндекс	POST /fraud-report	сообщение о найденном фродере

Подробности

Как пользователь проходит путь

Вводит запрос или открывает раздел «Займы» в поиске по Финансам, указывает сумму, срок и другие условия и нажимает «Рассчитать условия».
Авторизуется в Яндекс ID или подтверждает профиль.
После подтверждения номера телефона может увидеть блок «Быстрое оформление» с предложениями организаций, услугами которых пользовался. Полную анкету заполнять не нужно: сведения уже есть у организации. Такие предложения показываются отдельно.
Получает список организаций с подходящими предложениями и отмечает интересные; выбранные организации получают заявку и могут рассчитать персональные условия.
Заполняет анкету, знакомится с общими правилами оформления займов, получает персональные предложения. Если подходящих нет, показываются объявления с похожими условиями. Список организаций можно изменить.
Переходит из объявления к оформлению займа на сайте компании.

Как настроить кампанию

Настроить API-интеграцию: она формирует предложения по данным пользователя, направляет на страницу оформления прямо из объявления и даёт подробную статистику.
Добавить → Кампанию → Режим эксперта → Продвижение в тематических разделах → Финансы и страхование → Займы (бета).
Задать бюджет в неделю и цену целевого действия не ниже минимального порога; иначе показы прекращаются.
Выбрать географию (список или карта) и при необходимости коэффициенты в блоке «Корректировки по географии».
В блоке «Интеграция» указать API, Client ID, Client Secret; валидация до 72 часов, затем статус «Активна».

Повторные клиенты

Повторным считается пользователь, которого МКК или МФО определила как действующего или бывшего клиента; статус организация определяет сама. Для таких пользователей создаётся отдельная кампания. Одна организация может вести одновременно две: обычную и кампанию быстрого оформления. Если продвигаются оба типа клиентов, цены можно задать разные.

Подключение к API

Написать на finance-search@yandex-team.ru с заголовком «Интеграция API в займах» и названием организации.
Дождаться связи менеджера по оставленным контактам.
Реализовать публичный API-эндпоинт на своей стороне, на запросы Яндекса отвечать офферами.
Пройти проверку работоспособности интеграции.
Токен доступа для методов на стороне Яндекса выдаётся единоразово при подключении.

Статистика

Результат виден в Мастере отчётов и на странице «Кампании» после того, как организация передаст данные об оформленном займе в Директ по API. Группировки: Тип кампании → Продвижение в тематических разделах или Вид размещения → Тематический раздел. Без переданных конверсий статистика недоступна.

Важно знать

Страница метода «Подтверждение обработки заявки GET» показывает запрос GET /link — тот же путь, что у метода «Передача ссылки на предложение» на стороне партнёра. Совпадение может быть опечаткой справки; параметры методов в тексте не приведены, проверять в справке.
Для методов API в скачанных страницах есть только путь и описание; таблицы параметров, тела запросов и ответов отсутствуют.
Метод «Запрос предложений» назван в списке методов партнёра, но отдельной страницы у него нет.
Для повторных клиентов цена задана как плата за клик «Оформить», но в статистике этой кампании перечислены в том числе оформленные займы. Что именно учитывается как конверсия в кампании быстрого оформления, справка не уточняет.
В справке не нашли: размер минимального порога цены, максимум недельного бюджета, сроки бета-тестирования.