Подключение и инициализация
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. Добавьте настройки для каждой нативной платформы
-
Настройте приложение для использования Firebase. Получите и добавьте в AppMetrica ключ сервера для использования Firebase Cloud Messaging.
-
Чтобы настроить 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.
- Добавьте SSL-сертификат в AppMetrica по инструкции.
- Чтобы получать push-уведомления, запросите у пользователя разрешение и зарегистрируйте приложение для получения уведомлений. Рекомендуется использовать Unity-пакет Mobile Notifications и следовать инструкции.
Примечание
AppMetrica Push Unity Plugin использует механизм swizzling
для своей работы: перехватывает выполнение некоторых методов класса UnityAppController
используя ObjectiveC runtime. Код механизма представлен в файле AMPUAppMetricaPushAppController.m.
См. также
- Настройка приложения на базе Android для отправки push-уведомлений
- Настройка приложения на базе iOS для отправки push-уведомлений
- Запуск push-кампании
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.