Log in

VK Mini Apps integration

Tracking mini apps is in beta testing and available only to active clients who also use MyTracker for website or mobile app analytics. To add VK mini app, contact our support team.

VK Mini Apps is an open platform for creating mini applications on the VK social network. The platform provides 45 million MAU, different monetization formats, support for mobile and web platforms, promotion bonuses, etc.

Connect MyTracker to your mini app on the VK Mini Apps platform to open new possibilities for analytics:

  • quick reports on the mini application: user activity, device information, geography, launches, retention, etc.
  • tracking user engagement channels, results of ad campaigns and partner integrations;
  • end-to-end stats for the mini-application and the project as a whole: data for iOS, Android, and Web platforms in one report.

How it works

VK Mini Apps and MyTracker integration is configured by default. To collect stats on a mini application, just add the app to MyTracker.

MyTracker automatically assigns each user a unique identifier vk_id + idApp, which is used to collect data on the mini-app.

The user ID in the mini app vk_id + idApp should not be confused with the user ID in the project customUserId.

If the mini app supports its own authorization mechanism, then you as an app owner can choose an additional method of user identification and configure the transfer of the user identifier customUserId to MyTracker. In this way, you can collect end-to-end statistics for the whole project: for mini-apps, standalone mobile apps, and websites.

For details, refer to the User tracking section

Features

VK Mini Apps supports special attribution and event handling mechanisms:

Attribution and reattribution support only post-click conversions. You can change the attribution settings only for the project to which the mini app is added.

Event tracking is supported with VK Bridge. The instructions for transferring events are given below.

Revenue tracking is not supported yet.

Add mini app

To start tracking, contact our support team. If your mini app meets certain criteria, we will connect it to MyTracker.

After you add the app, the app stats are sent to MyTracker. For comprehensive data, we also recommend you set up event sending.

Send events

Configure event sending in MyTracker, to track user behaviour in the mini app.

The instructions below are given for each event, individually for the mini-app and for the whole project (if the app is distributed not only as part of VK Mini Apps).

Registrations

For mini app

All mini app users are registered in the VK super app by default, so registrations are not tracked and are not relevant.

For project

If the app supports its own authorization mechanism and the product is distributed not only as part of VK Mini Apps, then the app developer can configure the transfer of the event with the user identifier customUserId and track registrations in the project (in mini-apps, websites, and standalone mobile apps).

To include the mini app data to be included in the project stats, configure the sending of the registration custom event with the custom_user_id parameter via VK Bridge:

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

For details about VK Bridge, refer to the VK documentation

Authorization

For mini app

All mini app users are authorized in the VK super app by default, so authorizations are not tracked and are not relevant.

For project

If the app supports its own authorization mechanism and the product is distributed not only as part of VK Mini Apps, then the app developer can configure the transfer of the event with the user identifier customUserId and track authorizations in the project (in mini-apps, websites, and standalone mobile apps).

To include the mini app data to be included in the project stats, configure the sending of the login custom event with the custom_user_id parameter via VK Bridge:

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

For details about VK Bridge, refer to the VK documentation

Launches

For mini app

MyTracker automatically tracks mini app launches. No additional settings are required.

For project

If the app supports its own authorization mechanism and the product is distributed not only as part of VK Mini Apps, then the app developer can configure the transfer of the event with the user identifier customUserId. Using this identifier, MyTracker will link the actions of the same user in the mini app and in other project applications and provide end-to-end stats for the whole project.

The event «Launches» is important when calculating several activity metrics: Active users, Activity days, DAU, MAU, Retention, etc.

To include the mini app launches to be included in the project stats, configure the sending of the mt_internal_launch custom event with the custom_user_id parameter via VK Bridge:

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

For details about VK Bridge, refer to the VK documentation

Custom events

For mini app

To collect data on custom events, configure data sending via VK Bridge:

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

Event parameters:

Parameter name Description Type Example
custom_user_id User identifier in the project. Leran more String. Maximum length 255
"custom_user_id":"user_id"
event_name* Custom event name String. Maximum length 255
"event_name":"eventName"
event_params Custom event parameters JSON
"event_params":{ "level":"5", "mode":"123" }

* — required parameters.

For details about VK Bridge, refer to the VK documentation

For project

If the app supports its own authorization mechanism and the product is distributed not only as part of VK Mini Apps, make sure that together with the custom event you pass the user ID in the custom_user_id parameter, as written above in the mini app instructions. As a result, all user actions in the mini app will be counted in the project stats.

Manage campaigns

To control the traffic quality and collect stats on campaign results, place tracking links from MyTracker to your ads.

To run an advertising campaign:

  1. Add a campaign with the VK Mini Apps type.
  2. Add one or more tracking links to the campaign.
  3. One link can be used in an unlimited number of advertisements. However, stats, in this case, will be collected by all ads.

    To get the most detailed statistics for each advertisement or channel, use unique links.

    When creating the link, pay attention to the Redirect to Mobile App option. By default the option is disabled and when users click on your ad, they will be redirected to the web version of the mini app. If users have already installed the VKontakte app, the device will prompt them to open the mobile version of the app.

    We recommend enable the Redirect to Mobile App option if you know that the target audience already installed a mobile app (for example, if the ads are displayed in the VKontakte mobile app). As a result, when users click on your ad, they will be immediately redirected to the mobile version of the mini app or to the web version if the mobile mini app is unavailable.

    As a result, MyTracker will generate Click URL and Direct Click URL to track traffic.

  4. Place Click URL or Direct Click URL in the ad. You can copy the URL from the tracking link view page and send it to your partner or paste it into the ad by yourself.

After the campaign is launched, MyTracker will gather data on the number of clicks, impressions, and users brought in.

Data analysis

MyTracker provides all the necessary tools to analyze and process data: Reports, Builder, Funnels, and others. For more information about all tools, see the Analytics section.

Let's take a look at several reports for initial traffic analysis.

Reports

Select the section from the Reports menu to view tables and charts on Audience, Events, Devices, Retention.

For instance, evaluate audience activity in the mini app:

Reports on Monetization are not yet available for VK Mini Apps

Builder

Select the Analytics → Builder menu to choose the metrics and dimensions you need.

VK Mini Apps has its own set of metrics — Platform users. The superscript letter p indicates these metrics.

To build a game report, use Dimensions, metrics Platform Users, and Filters. For instance, compare the number of new and active users on different platforms using the OS (operation system) dimension.

If the app is distributed not only as part of VK Mini Apps, compare the metrics for the whole project. To do this, choose metrics Users (u). For instance, compare the number of new and active users in each app of your project.

To include the mini application data to be included in the project stats (u metrics), you need to pass the user ID customUserId with each event. For details, see the Send events paragraph.

Was this article helpful?