Installation and initialization

1. Add the supported platforms to your project
2. Add the plugin to the project by using one of the following console commands:

   cordova plugin add yandex-appmetrica-plugin-cordova
   Copied to clipboard

   or

   cordova plugin add https://github.com/yandexmobile/metrica-plugin-cordova.git
   Copied to clipboard

   When you add another supported platform to the project, the plugin automatically downloads the corresponding SDK library.

An example of initializing the library:

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' });
}
Copied to clipboard

What is the API key?

The API key is a unique application identifier that is issued in the AppMetrica web interface during app registration.

Make sure you have entered it correctly.

Example of a project with the integrated AppMetrica SDK on GitHub.

Connecting the library Play Install Referrer is mandatory. It is used to track the installation source.

dependencies {
    ...
    implementation 'com.android.installreferrer:installreferrer:1.1.2'
}
Copied to clipboard

If there is no build-extras.gradle , create it using the instruction.