Mindbox
Expo SDK

Базовая установка Expo SDK

Результат шага:

  • Из Mindbox отправляются мобильные push-уведомление на обе платформы и они отображается на устройстве.
  • На обеих платформах отображаются In-App
  • Проверить, что push-уведомления отправляются, можно с помощью этой инструкции.
  • Проверить, что In-App отображаются, можно с помощью этой инструкции.

Требования

Установка плагина

Добавьте зависимости в package.json:

package.json
"mindbox-sdk": "^2.14.6", "mindbox-expo-plugin": "^1.0.4"

Затем выполните установку: npm install

Плагин mindbox-expo-plugin должен быть первым в списке плагинов.

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

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

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

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

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

Domain API Mindbox

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

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


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


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

TypeScriptCode
const configuration = { domain: '<Domain API Mindbox>', endpointId: Platform.OS === 'ios' ? '<системное имя точки интеграции iOS>' : '<системное имя точки интеграции Android>', subscribeCustomerIfCreated: true, shouldCreateCustomer: true, };

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

TypeScriptCode
const configuration = { domain: '<Domain API Mindbox>', endpointId: Platform.OS === 'ios' ? '<системное имя точки интеграции iOS>' : '<системное имя точки интеграции Android>', subscribeCustomerIfCreated: false, shouldCreateCustomer: true, };

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

KotlinCode
const configuration = { domain: '<Domain API Mindbox>', endpointId: Platform.OS === 'ios' ? '<системное имя точки интеграции iOS>' : '<системное имя точки интеграции Android>', subscribeCustomerIfCreated: false, shouldCreateCustomer: false, };

2. Настройка React Native-части проекта

Инициализировать SDK нужно синхронно в основном файле приложения App.tsx / App.js, используйте вариант конфигурации, выбранный в пункте выше

JavascriptCode
import MindboxSdk from 'mindbox-sdk'; import React, {useCallback, useEffect, useState} from 'react'; const App = () => { const appInitializationCallback = useCallback(async () => { try { ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK await MindboxSdk.initialize(configuration); } catch (error) { console.log(error); } }, []); .... return () }

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

Конфигурация плагина

Android

  1. Получите ключи провайдеров для отправки push-уведомлений.
Firebase

Получение ключей Firebase.

Huawei

Получение ключей Huawei.

RuStore

Получение ключей RuStore.

  1. Подключите и настройте плагин mindbox-expo в app.json.

Пример конфигурации:

JavascriptCode
"plugins": [ [ "mindbox-expo-plugin", { "androidPushProviders": [ "firebase", "huawei", "rustore" ], "googleServicesFilePath": "./credentials/google-services.json", "huaweiServicesFilePath": "./credentials/agconnect-services.json", "rustoreProjectId": "hWZJga09nar5gsh0lbKlkZDuCgDJswgN", "androidChannelId": "expo_channel_id", "androidChannelName": "expo_name", "androidChannelDescription": "expo_description", "smallIcon": "./assets/icon_mb.png", "smallIconAccentColor": "#80F00A0A", } ] ]

iOS

  1. Настройте Sandbox-окружение.
  2. Получите ключи и настройте подключение к APNs по инструкции.
  3. Убедитесь, что в app.json в разделе ios указаны параметры bundleIdentifier и appleTeamId.
  4. Если appleTeamId не указан и нет возможности его указать, то в mindbox-expo-plugin необходимо добавить iosDevTeam и в значении передать идентификатор команды
  5. В mindbox-expo-plugin укажите iosMode.

Возможны 2 значения:

  • "development" (по умолчанию)
  • "production"

Если вы используете Expo Notification для отправки и отображения push-уведомлений, выполните дополнительные настройки.

Запросите разрешения на уведомления и передайте сведения о статусе в Mindbox

Это можно сделать как на стороне Android/iOS, так и в ReactNative

Пример запроса разрешения на уведомления c использованием Expo Notification

TypeScriptCode
import * as Notifications from 'expo-notifications'; ..... const { status: existingStatus } = await Notifications.getPermissionsAsync(); const finalStatus = existingStatus === 'granted' ? existingStatus : (await Notifications.requestPermissionsAsync()).status; finalStatus === 'granted' && MindboxSdk.refreshNotificationPermissionStatus();
Last modified on