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

Внимание.

Развитие и поддержка плагина прекращены. Корректная работа SDK не гарантируется.

  1. Шаг 1. Подключите плагин AppMetrica Cordova
  2. Шаг 2. Инициализируйте библиотеку
  3. Шаг 3. (Android) Подключите библиотеку Play Install Referrer

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

Шаг 1. Подключите плагин AppMetrica Cordova

  1. Добавьте поддерживаемую платформу в свой проект.
  2. Добавьте плагин в проект с помощью одной из следующих консольных команд:
    cordova plugin add yandex-appmetrica-plugin-cordova
    Скопировано

    или

    cordova plugin add https://github.com/yandexmobile/metrica-plugin-cordova.git
    Скопировано

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

Шаг 2. Инициализируйте библиотеку

Простой пример инициализации библиотеки:

document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady () {
    // Creating an extended library configuration.
    var configuration = {
        // Mandatory.
        apiKey: 'Your API key',
        // Optional.
        locationTracking: true,
        handleFirstActivationAsUpdate: true,
        sessionTimeout: 15
    }
    // Initializing the AppMetrica SDK.
    window.appMetrica.activate(configuration);
    // Sending a custom event.
    window.appMetrica.reportEvent('Test event', { 'foo': 'bar' });
}
Скопировано
Что такое API key?

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

Убедитесь, что он указан верно.

Пример проекта с интегрированной AppMetrica SDK на GitHub.

Шаг 3. (Android) Подключите библиотеку Play Install Referrer

Подключение библиотеки Play Install Referrer обязательно. Она используется для отслеживания источника установок.

Добавьте следующую зависимость в файле build-extras.gradle:
dependencies {
    ...
    implementation 'com.android.installreferrer:installreferrer:1.1.2'
}
Скопировано

Если файла build-extras.gradle нет, создайте его по инструкции.