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

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

Перед началом с плагином AppMetrica Push Cordova необходимо подключить и инициализировать AppMetrica Cordova плагин не ниже версии 0.2.0.

  1. Интеграция плагина
  2. Примеры подключения
  3. Методы API

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

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

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

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

Шаг 3. (Для проектов на Android) Добавьте в элемент application файла AndroidManifest.xml:

<meta-data android:name="ymp_gcm_project_number" android:value="number:SENDER_ID"/>
Например:
  1. Подключите плагин cordova-custom-config:
    cordova plugin add cordova-custom-config
  2. Внести изменения в файл config.xml для android-проекта:
    <config-file parent="./application" target="AndroidManifest.xml">
      <meta-data android:name="ymp_gcm_project_number" android:value="number:SENDER_ID" />
    </config-file>
Что такое SENDER_ID?

SENDER_ID — уникальный идентификатор приложения в GCM (Google Cloud Messaging).

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

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

  • Создается JavaScript-объект с конфигурацией для плагина.
  • Активируется AppMetrica Cordova плагин с созданной конфигурацией.
  • Инициализируется AppMetrica Push Cordova плагин.
  • Выводится в лог push-токен устройства.
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady () {
  var configuration = {
    apiKey: 'Your API key here'
  }
  window.appMetrica.activate(configuration);
  
  window.appMetricaPush.init();
  window.appMetricaPush.getToken(function (token) {
    console.log("Token: " + token);
  });
}
Что такое API key?

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

Методы API

В коде для обращения к AppMetrica Push используйте window.appMetricaPush.

init()

init()

Инициализирует AppMetrica Push Cordova плагин.

getToken()

getToken(function (token) {
  //token has the String type
})

Получает push-токен устройства.