Подписки VK и VK Видео через Callback API

Что считается конверсией

В Мобзио конверсия для VK и VK Видео — это вступление пользователя в ваше сообщество VK после перехода по диплинк-ссылке. Событие приходит через Callback API сообщества (group_join).

Подписка на канал VK Видео в экосистеме VK связана с сообществом: поэтому учёт идёт через то же сообщество, которое вы укажете в настройках. Просмотры видео и подписки только в приложении без вступления в сообщество не считаются конверсией.

Атрибуция: последний клик по вашей ссылке за 72 часа до вступления. Один пользователь VK учитывается один раз на сообщество.

Два типа ссылок — куда вести трафик

• ВКонтакте — ссылка должна вести на то же сообщество, ID которого указан в настройках. Пример: https://vk.com/club123456789 или https://vk.com/имя_сообщества.
• VK Видео — ссылка на канал VK Видео, привязанный к этому сообществу. Пример: https://vkvideo.ru/@ваш_канал.

Если целевая ссылка не совпадает с настройками интеграции, клики будут, а конверсии не привяжутся к нужной диплинк-ссылке.

Шаг 1. Подготовьте сообщество VK

1. Убедитесь, что у вас есть сообщество VK, к которому привязан нужный канал (для VK Видео) или куда вы ведёте трафик (для типа «ВКонтакте»).
2. Вы должны иметь права администратора сообщества, чтобы настроить Callback API.
3. Запомните числовой ID группы — он есть в адресе vk.com/club….

Шаг 2. Подключите интеграцию в Мобзио

Настройка делается отдельно в каждом диплинке.

1. Откройте нужный диплинк в личном кабинете.
2. Перейдите в Настройки → VK / VK Видео.
3. Укажите ID сообщества VK (обязательно).
4. При желании заполните короткое имя и название — только для удобства в кабинете.
5. Включите переключатель «Включить отслеживание подписок (VK / VK Видео)».

Шаг 3. Настройте Callback API в VK

В управлении сообществом откройте:

Управление → Дополнительно → Работа с API → Callback API → Добавить сервер

1. Адрес сервера: https://mobz.io/api/deeplink/vk_callback
2. Секретный ключ: нажмите «Сгенерировать» в настройках Мобзио, скопируйте ключ и вставьте тот же в поле секрета в VK.
3. VK покажет строку подтверждения — скопируйте её в поле «Строка подтверждения Callback API» в Мобзио.
4. В Мобзио нажмите Сохранить — только после этого в VK нажмите «Подтвердить» сервер.
5. Включите событие «Вступление в сообщество» (group_join). При необходимости можно включить и выход (group_leave) — для статистики конверсий важно именно вступление.

Секретный ключ в VK и в Мобзио должен полностью совпадать, иначе события не будут приниматься.

Шаг 4. Создайте ссылки VK или VK Видео

1. Создайте ссылку типа ВКонтакте или VK Видео в диплинке.
2. Укажите целевой URL — сообщество или канал из шага «Два типа ссылок».
3. После включения интеграции при переходе по диплинку в URL добавляется служебный параметр m_click_id — он нужен для атрибуции. Вручную ничего настраивать не нужно.

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

Шаг 5. Смотрите статистику

В статистике конкретной ссылки появятся:

• карточка «Конверсии» — число вступлений за период;
• таблица подписавшихся — дата, ссылка на профиль VK, тип события;
• конверсия также доступна через API конверсий (для интеграций с вашими отчётами).

Если интеграция ещё не подключена, вместо нуля в блоке конверсий показывается подсказка с кнопкой перехода в настройки.

Как проверить, что всё работает

1. Сохраните настройки в Мобзио и подтвердите сервер в VK.
2. Перейдите по тестовой диплинк-ссылке с аккаунта, который ещё не состоит в сообществе.
3. Вступите в сообщество VK (или подпишитесь на канал так, чтобы VK отправил group_join).
4. Откройте статистику ссылки — в течение нескольких минут должна появиться конверсия.

Частые вопросы

Есть клики, но нет конверсий?
Проверьте: включено ли отслеживание в Мобзио, подтверждён ли Callback API, совпадает ли секрет, включено ли событие group_join, ведёт ли ссылка на то же сообщество/канал, вступил ли тестовый пользователь в течение 72 часов после клика.

Подписался в VK Видео, а конверсии нет?
Подписка только в приложении без вступления в сообщество может не дать событие group_join. Нужно именно вступление в привязанное сообщество.

Нужен ли отдельный Callback на каждый диплинк?
Адрес сервера один — https://mobz.io/api/deeplink/vk_callback. В настройках каждого диплинка вы указываете своё сообщество; атрибуция идёт по m_click_id и данным интеграции.

Можно ли не подключать интеграцию?
Да. Ссылки VK и VK Видео продолжат считать переходы как раньше.

Рекомендации

• Сначала сохраните строку подтверждения в Мобзио, затем нажимайте «Подтвердить» в VK.
• Используйте кнопку «Сгенерировать» для секретного ключа и вставьте тот же ключ в VK.
• Не публикуйте секретный ключ Callback API и строку подтверждения в открытых материалах.
• Для теста используйте аккаунт, который ещё не в сообществе.