Подключение и инициализация

AppMetrica Cordova — это плагин для платформы Cordova (PhoneGap), включающий поддержку AppMetrica SDK для платформ Android и iOS через Javascript-интерфейс.

Интеграция AppMetrica Cordova плагина

Шаг 1. Добавьте поддерживаемую платформу в свой проект.

Шаг 2. Добавьте плагин в проект с помощью одной из следующих консольных команд:
cordova plugin add yandex-appmetrica-plugin-cordova
или
cordova plugin add https://github.com/yandexmobile/metrica-plugin-cordova.git

При добавлении в проект еще одной поддерживаемой платформы, плагин автоматически добавит соответствующую библиотеку SDK.

Пример подключения

В приведенном ниже примере:

  • Создается JavaScript-объект с конфигурацией для плагина.
  • Активируется плагин с созданной конфигурацией.
  • Отправляется сообщение о событии.
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady () {
    var configuration = {
        // Mandatory
        apiKey: 'Your API key here',
        // Optional
        trackLocationEnabled: true,
        handleFirstActivationAsUpdateEnabled: true,
        sessionTimeout: 15
    }
    window.appMetrica.activate(configuration);
    window.appMetrica.reportEvent('Test event', { 'foo': 'bar' });
}
      
Что такое API key?

API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.