Интеграция с VK Mini Apps

Трекинг мини-приложений находится в стадии бета-тестирования и доступен не всем. Чтобы подключить мини-приложение, пожалуйста, обратитесь в нашу службу поддержки.

VK Mini Apps — это открытая платформа для создания мини-приложений внутри ВКонтакте. Платформа предлагает 45 миллионное MAU, разные форматы монетизации, поддержку мобильных и веб-платформ, бонусы при продвижении и пр.

Подключите MyTracker к вашему мини-приложению на платформе VK Mini Apps, чтобы открыть новые возможности для аналитики:

оперативные отчёты по мини-приложению: активность пользователей, информация по устройствам, география, запуски, Retention и др.
отслеживание каналов привлечения пользователей, результатов рекламных кампаний и интеграций с партнёрами;
сквозная статистика по мини-приложению и проекту в целом: данные по iOS, Android и веб-платформам в одном отчёте.

Как работает

Интеграция VK Mini Apps и MyTracker настроена по умолчанию. Чтобы собирать статистику по мини-приложению, достаточно добавить приложение в MyTracker.

MyTracker автоматически присваивает каждому пользователю уникальный идентификатор vk_id + idApp, с помощью которого может собирать данные по мини-приложению.

Не следует путать идентификатор пользователя в мини-приложении vk_id + idApp с идентификатором пользователя в проекте customUserId.

Если в мини-приложении предусмотрен собственный механизм авторизации, то владелец приложения может самостоятельно выбрать дополнительный способ идентификации пользователей и настроить передачу идентификаторов customUserId в MyTracker. Таким образом можно собрать сквозную статистику по всему проекту: по мини-приложениям, отдельным мобильным приложениям и сайтам.

Подробнее см. раздел Трекинг пользователей

Особенности

Для VK Mini Apps предусмотрены свои механизмы атрибуции и сбора данных:

Атрибуция и реатрибуция работают только для конверсий по клику (post-click). Настройки атрибуции можно изменить только на уровне проекта, в который добавлено мини-приложение.

Трекинг событий поддержан с помощью VK Bridge. Ниже приведены инструкции по передаче событий в MyTracker.

Трекинг дохода пока не поддержан.

Добавление мини-приложения

Чтобы начать трекинг, пожалуйста, обратитесь в нашу службу поддержки. Если ваше мини-приложение подходит под определённые критерии, мы подключим его к MyTracker.

После того как приложение будет добавлено, статистика по нему поступит в MyTracker. Для полноты данных рекомендуем также настроить передачу событий.

Передача событий

Настройте передачу событий в MyTracker, чтобы получать статистику по действиям пользователей в мини-приложении.

Ниже даны инструкции для каждого события, отдельно для мини-приложения и для проекта в целом (если приложение распространяется также вне VK Mini Apps).

Регистрации

Для мини-приложений

Все пользователи мини-приложения по умолчанию уже зарегистрированы в супераппе ВКонтакте, поэтому события регистрации для мини-приложений не отслеживаются и не актуальны.

Для проекта

Если в мини-приложении поддержан собственный механизм авторизации и продукт распространяется также вне VK Mini Apps, то разработчик приложения может самостоятельно настроить передачу события вместе с идентификатором customUserId и отслеживать регистрации в проекте (в мини-приложении, на сайте или в отдельных мобильных приложениях).

Чтобы регистрации в мини-приложении попали в общую статистику по проекту, настройте передачу кастомного события registration с параметром custom_user_id через VK Bridge:

bridge.send('VKWebAppTrackEvent', {
  custom_user_id: 'user_id',
  event_name: 'registration'
});

Подробнее о VK Bridge см. документацию VK

Авторизации

Для мини-приложений

Все пользователи мини-приложения по умолчанию уже авторизованы в супераппе ВКонтакте, поэтому события авторизации для мини-приложений не отслеживаются и не актуальны.

Для проекта

Если в мини-приложении поддержан собственный механизм авторизации и продукт распространяется также вне VK Mini Apps, то разработчик приложения может самостоятельно настроить передачу события вместе с идентификатором customUserId и отслеживать авторизации в проекте (в мини-приложении, на сайте или в отдельных мобильных приложениях).

Чтобы авторизации в мини-приложении попали в общую статистику по проекту, настройте передачу кастомного события login с параметром custom_user_id через VK Bridge:

bridge.send('VKWebAppTrackEvent', {
  custom_user_id: 'user_id',
  event_name: 'login'
});

Подробнее о VK Bridge см. документацию VK

Запуски

Для мини-приложений

Запуски мини-приложения MyTracker отслеживает автоматически. Дополнительные настройки не требуются.

Для проекта

Если в мини-приложении поддержан собственный механизм авторизации и продукт распространяется также вне VK Mini Apps, то разработчик приложения может самостоятельно настроить передачу события вместе с идентификатором customUserId. С помощью этого идентификатора MyTracker сможет связать действия одного и того же пользователя в мини-приложении и в других приложениях проекта и предоставить сквозную статистику по всему проекту.

Событие «Запуски» важно при расчёте многих метрик активности: Активные пользователи, Дни активности, DAU, MAU, Retention и др.

Чтобы запуски мини-приложения попали в общую статистику по проекту, настройте передачу кастомного события mt_internal_launch с параметром custom_user_id через VK Bridge:

bridge.send('VKWebAppTrackEvent', {
  custom_user_id: 'user_id',
  event_name: 'mt_internal_launch'
});

Подробнее о VK Bridge см. документацию VK

Кастомные события

Для мини-приложений

Для сбора данных по кастомным событиям, нужно настроить передачу данных через VK Bridge:

bridge.send('VKWebAppTrackEvent', {
  custom_user_id: 'user_id',
  event_name: 'eventName',
  event_params: {
    level: 5,
    mode: 123
  }
});

Параметры события:

Название параметра	Описание	Тип	Пример
custom_user_id	Идентификатор пользователя в проекте. Подробнее	Строка. Максимальная длина 255	"custom_user_id":"user_id"
event_name*	Название кастомного события	Строка. Максимальная длина 255	"event_name":"eventName"
event_params	Параметры кастомного события	JSON	"event_params":{ "level":"5", "mode":"123" }

* — обязательный параметр.

Подробнее о VK Bridge см. документацию VK

Для проекта

Если в мини-приложении поддержан собственный механизм авторизации и продукт распространяется также вне VK Mini Apps, то убедитесь, что вместе с кастомным событием вы передаёте идентификатор пользователя в параметре custom_user_id, как написано выше в инструкции для мини-приложений. В результате все действия пользователя в мини-приложении будут учтены и в статистике по проекту.

Управление кампаниями

Чтобы контролировать качество трафика и собирать статистику по результатам кампаний, разместите в рекламных объявлениях трекинг-ссылки от MyTracker.

Чтобы запустить рекламную кампанию:

Добавьте кампанию с типом VK Mini Apps.

Добавьте в кампанию одну или несколько трекинг-ссылок.

Одну ссылку можно использовать в неограниченном числе рекламных объявлений. Однако статистика в таком случае будет собираться общая по всем объявлениям.

Чтобы получить максимально подробную статистику по каждому рекламному объявлению или каналу, используйте уникальные трекинг-ссылки.

При создании ссылки обратите внимание на опцию Редирект в мобильное приложение. По умолчанию (опцию выключена) при переходе по рекламе пользователь будет перенаправлен на веб-версию мини-приложения. При наличии установленного приложения ВКонтакте, устройство само предложит пользователю открыть мобильную версию приложения.

Рекомендуем включить опцию Редирект в мобильное приложение, если заранее известно, что у целевой аудитории установлено мобильное приложение (например, если реклама будет запущена в мобильном приложении ВКонтакте). В результате при переходе по рекламе пользователь будет сразу перенаправлен в мобильную версию мини-приложения, а при её отсутствии — в веб-версию.

В результате для каждой трекинг-ссылки будут сформированы Ссылка для подсчёта кликов и Прямая ссылка для подсчёта кликов, по которым MyTracker сможет отслеживать трафик.

Если партнёром в кампании является Реклама ВКонтакте, то трекинг-ссылка будет включать только Прямую ссылку для подсчёта кликов

Разместите ссылку для подсчёта кликов в рекламном объявлении. Вы можете сделать это самостоятельно или передать ссылку партнёру. Скопировать ссылку можно со страницы просмотра трекинг-ссылки.

После запуска рекламной кампании, в MyTracker начнут поступать данные по количеству кликов, показов и объёму привлечённой аудитории.

Анализ данных

MyTracker предоставляет все необходимые инструменты для анализа и обработки данных: Отчёты, Конструктор, Воронки и др. Подробнее обо всех инструментах см. раздел Аналитика.

Рассмотрим несколько отчётов для первоначального анализа трафика.

Отчёты

Выберите раздел в меню Отчёты, чтобы посмотреть таблицы и графики по Аудитории, Событиям, Устройствам, Retention.

Например, оцените активность аудитории мини-приложения:

Отчёты в разделе Финансы пока недоступны для мини-приложений VK Mini Apps

Конструктор

Выберите меню Аналитика → Конструктор, если хотите самостоятельно подобрать для отчёта нужные метрики и разрезы.

Метрики для VK Mini Apps собраны в разделе Пользователи платформы и обозначены надстрочной буквой p.

Чтобы построить отчёт по мини-приложению, используйте Разрезы, метрики Пользователи платформы и Фильтры. Например, сравните число новых и активных пользователей на разных платформах с помощью разреза ОС (операционная система).

Если приложение распространяется также вне VK Mini Apps сравните показатели по проекту в целом. Для этого используйте метрики Пользователи (u). Например, сравните количество новых и активных пользователей в каждом приложении проекта.

Чтобы данные по мини-приложению попали в статистику по проекту (u-метрики), нужно с каждым событием передавать идентификатор пользователя customUserId. Подробнее см. Передача событий

Была ли эта статья полезна?