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

AppMetrica Push Unity — это плагин для игровой платформы Unity3d, включающий поддержку AppMetrica Push SDK для платформ Android и iOS.

Ниже описаны этапы подключения и инициализации AppMetrica Unity Plugin:

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

Подключить плагин AppMetrica Unity согласно инструкции.

Примечание

Требуется плагин AppMetrica Unity не ниже версии 6.1.0.

Шаг 2. Подключите плагин AppMetrica Push Unity

Для подключения плагина используется Unity Package Manager.

Добавьте зависимости в Packages/manifest.json:

{
  "dependencies": {
    "io.appmetrica.analytics.push": "https://github.com/appmetrica/push-unity-plugin.git#v2.0.0"
  }
}

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

Рекомендуется активировать AppMetrica Push используя RuntimeInitializeOnLoadMethodAttribute.

Создайте static метод с атрибутом [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] и произведите активацию AppMetricaPush с помощью метода AppMetricaPush.Activate().

Пример:

using Io.AppMetrica;
using Io.AppMetrica.Push;
using UnityEngine;

public static class AppMetricaActivator {
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
    private static void Activate() {
        AppMetrica.Activate(new AppMetricaConfig("APIKey"));
        AppMetricaPush.Activate();
    }
}

Примечание

AppMetricaPush.Activate() должен вызываться после AppMetrica.Activate().

Шаг 4. Добавьте настройки для каждой нативной платформы

  1. Настройте приложение для использования Firebase. Получите и добавьте в AppMetrica ключ сервера для использования Firebase Cloud Messaging.

  2. Чтобы настроить AndroidManifest.xml, внесите изменения в элемент application файла AndroidManifest.xml:

    <meta-data android:name="ymp_firebase_default_app_id" android:value="APP_ID"/>
    <meta-data android:name="ymp_gcm_default_sender_id" android:value="number:SENDER_ID"/>
    <meta-data android:name="ymp_firebase_default_api_key" android:value="API_KEY"/>
    <meta-data android:name="ymp_firebase_default_project_id" android:value="PROJECT_ID"/>
    

    APP_ID — идентификатор приложения в Firebase. Его можно узнать в консоли Firebase: перейдите в Настройки проекта. В разделе Ваши приложения скопируйте значение поля Идентификатор приложения.

    SENDER_ID— уникальный идентификатор отправителя в Firebase. Его можно узнать в консоли Firebase: перейдите во вкладку Настройки проекта → Cloud Messaging и скопируйте значение поля Идентификатор отправителя.

    API_KEY — ключ приложения в Firebase. Его можно найти в поле current_key файла google-services.json. Файл можно скачать из консоли Firebase.

    PROJECT_ID — id приложения в Firebase. Его можно найти в поле project_id файла google-services.json. Файл можно скачать из консоли Firebase.

  1. Добавьте SSL-сертификат в AppMetrica по инструкции.
  2. Чтобы получать push-уведомления, запросите у пользователя разрешение и зарегистрируйте приложение для получения уведомлений. Рекомендуется использовать Unity-пакет Mobile Notifications и следовать инструкции.

Примечание

AppMetrica Push Unity Plugin использует механизм swizzling для своей работы: перехватывает выполнение некоторых методов класса UnityAppController используя ObjectiveC runtime. Код механизма представлен в файле AMPUAppMetricaPushAppController.m.

См. также

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки