VKWebAppTrackEvent

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

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

Пример

JavaScript

bridge.send('VKWebAppTrackEvent', {
    event_name: 'game_event',
    custom_user_id: '743784479',
    event_params: {
      level: 5,
      mode: 123
    }
  })
  .then((data) => {
    if (data.result) {
      // Данные отправлены 
    }
  })
  .catch((error) => {
    // Ошибка
    console.log(error);
  });

Платформы

Android, iOS, Mobile Web, Web

Параметры

Поле	Тип	Описание
`event_name` обязательное	`string`	Название события. Событие — это заранее определённое в коде действие, например покупка через приложение или авторизация пользователя в игре. • События в VK Рекламе • События в MyTracker
`custom_user_id` необязательное	`string`	Идентификатор пользователя мини-приложения или игры, например ID профиля ВКонтакте.
`event_params` необязательное	`object`	Параметры события `event_name`.

Результат

Проверить результат можно:

•

Используя объект Promise, который возвращается вызовом bridge.send(...).
•

С помощью событий VKWebAppTrackEventResult и VKWebAppTrackEventFailed.

Подробнее о проверке результатов при вызовах VK Bridge — в разделе Обработка результата.

Объект `Promise`

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующим полем:

Поле	Тип	Описание
`result`	`boolean`	`true`, если данные были отправлены в MyTracker.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

`VKWebAppTrackEventResult`

Сигнализирует, что данные отправлены в MyTracker. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript

{
  detail: {
    type: "VKWebAppTrackEventResult",
    data: {
      result: true
    }
  }
}

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

`VKWebAppTrackEventFailed`

Информирует об ошибке, которая произошла при взаимодействии с платформой.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Подробнее — в разделе Обработка результата.