Mindbox
Android SDK

2. Инициализация SDK

Результат шага «Инициализация SDK»:

  • Приложение запустилось без ошибок;
  • В консоли разработчика в Android Studio выведен deviceUUID SDK mindbox;
  • Дополнительно, только если вы делаете интеграцию с созданием и подпиской анонимного пользователя в системе Mindbox — создастся клиент Mindbox.

1. Выбор варианта конфигурации SDK

Выберите вариант конфигурации SDK на основе требований от маркетинга.

Системное имя чувствительно к регистру

Скопируйте системное имя из настроек точки интеграции для iOS или Android или получите его у менеджера проекта. Если регистр букв не совпадает, In-App в приложении не будут показываться, даже если операции при этом выполняются без ошибок. Ошибку можно исправить только новым релизом приложения.

Domain API Mindbox

Это домен, по которому будет происходить обращение в API Mindbox.

Чтобы получить нужный домен для вашего проекта, сделайте следующее:


1. Перейдите на сайт проекта
2. Перейдите в список операций через "Кампании" → "Список кампаний" → "Операции"
3. Откройте любую операцию
4. Нажмите «Посмотреть описание»
5. Скопируйте домен из URL в спецификации

Не передавайте в этом поле адрес административного раздела

Хочу передавать в Mindbox анонимных пользователей и отправлять им push-уведомления

KotlinKotlin
val configuration = MindboxConfiguration.Builder( applicationContext, "<Domain API Mindbox>", "<системное имя точки интеграции>" ) .shouldCreateCustomer(true) .subscribeCustomerIfCreated(true) .build()

Хочу передавать в Mindbox анонимных пользователей без возможности отправлять им push-уведомления

KotlinKotlin
val configuration = MindboxConfiguration.Builder( applicationContext, "<Domain API Mindbox>", "<системное имя точки интеграции>" ) .shouldCreateCustomer(true) .subscribeCustomerIfCreated(false) .build()

Не хочу передавать в Mindbox анонимных пользователей

KotlinKotlin
val configuration = MindboxConfiguration.Builder( applicationContext, "<Domain API Mindbox>", "<системное имя точки интеграции>" ) .shouldCreateCustomer(false) .build()

2. Инициализация SDK

Для корректной работы SDK не должна быть глобально отключена автоматическая инициализация компонентов. Обратите внимание, нет ли у вас в манифесте следующей записи:
Disable automatic initialization for all components Если у вас она отключена для всех компонентов, включите ее и отключите автоматическую инициализацию только для отдельных компонентов

Асинхронная инициализация SDK может привести к некорректной работе.

Инициализировать SDK нужно синхронно в методе Application.onCreate, используйте вариант конфигурации, выбранный на этапе «Выбор варианта конфигурации SDK».

Для инициализации передайте в метод Mindbox.init application вашего приложения.

KotlinKotlin
import android.app.Application import cloud.mindbox.mobile_sdk.* class MyApp: Application() { override fun onCreate() { super.onCreate() // ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK Mindbox.init(application, configuration, listOf()) } }

Если у вас single activity application и вы не можете инициализировать SDK в Application

Тогда можно инициализировать Mindbox SDK в вашей Activity, передав в Mindbox.init вашу Activity.

KotlinKotlin
class MainActivity() : Activity() { override fun onCreate() { super.onCreate() // ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK Mindbox.init(this@MainActivity, configuration, listOf()) } }

Если вы ранее уже инициализировали SDK

Вам нужно заменить устаревшую реализацию метода инициализации Mindbox.init(context, configuration, list), требующую передачу контекста, на одну из новых: требующую application, при инициализации внутри класса Application и требующую activity, при инициализации внутри класса Activity.

Чтобы проверить корректность инициализации, добавьте вывод deviceUUID в консоль в любом удобном месте.

Далее запустите приложение через Android Studio на реальном устройстве или эмулятор

KotlinKotlin
package cloud.mindbox.checkguidandroid import android.app.Application import android.util.Log import cloud.mindbox.mobile_sdk.* class MyApp: Application() { override fun onCreate() { super.onCreate() ... Mindbox.init( application = this, configuration = configuration, pushServices = listOf(MindboxFirebase, MindboxHuawei, MindboxRuStore) ) Mindbox.subscribeDeviceUuid { uuid -> Log.i("MindboxDeviceUUID", uuid) } } }

Если вам нужно изменить endpoint

Если ваше приложение используется в нескольких странах, а точное местоположение клиента становится известно только после запуска приложения, может потребоваться смена endpoint для корректной передачи информации о стране. Для этого нужно повторно вызвать Mindbox.init и указать в конфигурации новый endpoint.

Использование SDK при собственной инициализации WorkManager

Документация
Внутри Mindbox SDK для отправки ивентов используется WorkManager. Если в вашем проекте отключена автоматическая инициализация WorkManager и инициализируете его вручную, то добавьте:

KotlinKotlin
Configuration.Builder().setWorkerFactory( DelegatingWorkerFactory().apply { // ваши фабрики addFactory(Mindbox.mindboxWorkerFactory) } )
Last modified on