Дайджест обновлений: Kaspi API, API методы Мобзио, отчеты и инструкции

Всем привет! Сегодня мы хотим рассказать о новых обновлениях. Мы подготовили новые интеграции для отслеживания конверсий — это ВК и VK Видео (да-да, самое время, когда их удалили из сторов) — и добавили интеграцию с Kaspi. Обо всём по порядку:

1. Подключение интеграции с ВК и VK Видео
2. Обновили метод API в Мобзио
3. Добавили интеграцию с Kaspi
4. Обновили выгрузку отчётов
5. Обновили раздел инструкций
6. Прекращение поддержки V1 — скоро переход на V2

1. Подключение интеграции с ВК и VK Видео

Теперь в Мобзио можно считать не только клики по ссылкам ВКонтакте и VK Видео, но и конверсии — вступление пользователя в ваше сообщество VK после перехода по диплинку.

Как это работает:

• подключаете сообщество VK в настройках диплинка;
• настраиваете Callback API с событием group_join;
• создаёте ссылки типа «ВКонтакте» или «VK Видео» на нужное сообщество или канал;
• в статистике видите клики, уникальных пользователей и конверсии по каждой ссылке.

Атрибуция — по последнему клику за 72 часа до вступления. Для VK Видео учёт идёт через то же сообщество, которое вы указали в интеграции — это особенность экосистемы VK.

Актуально как раз сейчас: приложения VK убрали из App Store и Google Play, трафик всё чаще идёт через браузер и диплинки — важно понимать, сколько из этих переходов превращается в подписчиков сообщества.

Пошаговая инструкция: Подписки VK и VK Видео через Callback API
Подробнее: Аналитика подписчиков ВК и конверсий рекламы

2. Обновили API: конверсии и пагинация mylinks

Расширили публичный метод GET /api/public/conversions — теперь он отдаёт конверсии не только для Wildberries, MAX и Telegram, но и для новых интеграций:

• vk и vkvideo — клики, уникальные пользователи, конверсии вступления, список событий;
• kaspi — заказы после перехода по ссылке (при подключённом API Kaspi в диплинке).

Формат ответа зависит от типа ссылки в личном кабинете. Параметры link_id, dateFrom и dateTo — как у остальных методов public API.

Если вы строите дашборды или автоматические отчёты поверх Мобзио, данные по VK и Kaspi можно забирать тем же ключом API, без отдельных костылей.

Пагинация в GET /api/public/mylinks

У метода получения всех ссылок диплинка появилась пагинация — это важно, если у вас сотни или тысячи ссылок и вы забираете их вместе со статистикой (stats=1).

Как пользоваться:

• параметры page и limit — номер страницы и размер выборки;
• без page и limit по-прежнему возвращаются все ссылки (как раньше);
• с stats=1 на страницу — не больше 100 ссылок (даже если передать больший limit);
• без stats — до 1000 ссылок на страницу, по умолчанию 500.

Пример для большого диплинка со статистикой:

GET /api/public/mylinks?page=1&limit=100&stats=1
GET /api/public/mylinks?page=2&limit=100&stats=1
… пока в ответе есть info.next_page

В поле info приходят метаданные: total_links, total_pages, next_page — удобно обходить все страницы в цикле. Запрос ?stats=1 без пагинации на очень больших аккаунтах может упираться в таймаут 504 — для таких случаев пагинация обязательна.

Документация: Мобзио API → Конверсии по ссылке
Пагинация ссылок: Мобзио API → Получить все ссылки

3. Добавили интеграцию с Kaspi

Для продавцов на Kaspi.kz появилась связка с API маркетплейса — видно, сколько переходов по диплинку привели к заказам.

Что нужно сделать:

1. Получить токен API в кабинете продавца Kaspi (Настройки → Токен API).
2. В Мобзио открыть диплинк → «Связка с Kaspi API» → вставить токен и сохранить.
3. Добавить ссылки типа Kaspi на карточки товаров (/shop/p/...).
4. Смотреть конверсии в статистике ссылки — таблица «Конверсии после перехода».

Токен используется только для чтения заказов. Синхронизация выполняется автоматически — вручную ничего пересчитывать не нужно.

Инструкция: Связка с Kaspi API

4. Обновили выгрузку отчётов

В статистике диплинка кнопки Excel объединили в выпадающее меню «Отчёты» — меньше шума на странице, все выгрузки под рукой в одном месте.

Доступные форматы:

• Сводка — агрегированная статистика по ссылкам за период;
• Клики — детализация переходов;
• Конверсии — для ссылок с поддержкой интеграций (в том числе Wildberries и Kaspi).

Меню появляется рядом с выбором дат — выбрали период, открыли «Отчёты», скачали нужный файл.

5. Обновили раздел инструкций

Что изменилось для вас:

• инструкции идут в правильном порядке — без «вставок» в середину списка;
• появились категории: Начало работы, Статистика, Интеграции, Инструменты;
• работает поиск по названию и тексту;
• в админке можно пометить статью как неактуальную, если функционал отключён.

Новые материалы — про VK, Kaspi и остальные интеграции — уже в разделе «Интеграции».

6. Прекращение поддержки V1 — скоро переход на V2

Мы готовим Мобзио V2 — новую версию платформы на современном стеке: быстрее кабинет, надёжнее API, проще развивать интеграции.

Что важно знать уже сейчас:

• текущая версия сервиса (V1) продолжает работать в обычном режиме;
• поддержка V1 со временем будет прекращена — о переходе предупредим заранее;

Точные сроки и чеклист для вашего аккаунта сообщим отдельно — в блоге, в кабинете и по почте. Если у вас крупный проект на API или много диплинков — можно написать нам заранее, чтобы учесть ваш сценарий.

Заключение

Коротко: VK и VK Видео с конверсиями, Kaspi с заказами, API и Excel-отчёты под это всё, а инструкции — в удобном разделе на сайте. Пользуйтесь, тестируйте на своих кампаниях и пишите, чего не хватает.