mSDK

Описание

Altcraft mSDK — это мобильный SDK, который обеспечивает надёжную работу с push-уведомлениями и взаимодействие с платформой Altcraft. Он разработан для Android и iOS, поддерживает Firebase, Huawei, RuStore и APNS, а также предоставляет расширенные возможности по управлению подписками, обработке событий и работе с несколькими пользователями на одном устройстве.

SDK может использовать JWT-токены или rToken, что позволяет гибко настраивать уровень безопасности и типы матчинга данных профилей. Автоматическая обработка уведомлений и событий доставки обеспечивает стабильность и высокую точность передачи данных, а встроенный WorkManager гарантирует доставку событий даже в случае сетевых сбоев.

Минимальные требования:

• iOS: Minimum Deployments IOS — 13
• Android: минимальный уровень API (minSdkVersion) — 25

Возможности

SDK совместим с Kotlin, Java (Android), Swift, Objective-C (iOS), JavaScript (React Native) и Dart (Flutter).

Android SDK собран из модулей, каждый отвечает за свою область функциональности. Подключайте зависимости только для нужных модулей.

Core (обязательный)

Ядро SDK: инициализация и соединение приложения с платформой Altcraft, доступность опциональных модулей.

• Инициализация и настройка SDK.
• Аутентификация по JWT-токенам или rToken.
• Поддержка анонимных и зарегистрированных пользователей, нескольких пользователей на одном устройстве (JWT).
• Автоматический повтор неудачных запросов через WorkManager.
• Поток событий SDK для наблюдения за его работой в приложении.
• Очистка данных SDK и остановка фоновых задач.

Push (опциональный)

Модуль отвечает за push-уведомления.

• Управление подпиской: подписка, приостановка, отписка.
• Автоматический показ push-уведомлений, настроенных в платформе, с возможностью переопределения формата и доступа ко всем data-полям сообщений.
• Автоматическое обновление push-токена при его изменении.
• Автоматическая передача событий доставки и открытия уведомлений.
• Поддержка push-провайдеров: Firebase, Huawei, RuStore (Android), APNS (iOS).
• Запрос разрешения на уведомления для устройств Android 13+.

Target (опциональный)

Модуль отвечает за цели: отправка событий о достижении целей на платформу.

• Отправка целей из приложения.
• Привязка к цели payload-данных, параметров матчинга, полей профиля и подписок на каналы.
• Привязка UTM-тегов к целям для атрибуции.

Profile (опциональный)

Модуль отвечает за поля профиля пользователя.

• Обновление полей профиля из приложения.

In-App (опциональный)

Модуль отвечает за in-app кампании.

• Автоматический показ in-app кампаний, настроенных в платформе.
• Управление подпиской на in-app кампании: подписка, отписка, статус.
• Запрос placements, матчинг по текущему экрану, пользовательские триггеры.
• JSON-эмиттер in-app кампаний для внешнего подписчика.

---

GitHub

Репозиторий Altcraft mSDK доступен на GitHub:

• iOS
• Android
• React Native
• Flutter

---

Менеджеры зависимостей

Cocoapods:

pod 'Altcraft', '1.0.0'

Swift Package Manager:

1.0.0

Maven Central (Android):

Обязательное ядро:

com.altcraft:android-sdk-core:X.Y.Z

Опциональные модули — подключайте по мере необходимости:

com.altcraft:android-sdk-push:X.Y.Z com.altcraft:android-sdk-target:X.Y.Z com.altcraft:android-sdk-profile:X.Y.Z com.altcraft:android-sdk-inapp:X.Y.Z

Репозитории: mavenCentral() и google().

npm:

@altcraft/react-native-sdk

---

Android

Установка и конфигурация Altcraft mSDK для платформы Android

iOS

Установка и конфигурация Altcraft mSDK для платформы iOS

React Native (Android/iOS)

Установка и конфигурация Altcraft mSDK на React Native

Flutter (Android/iOS)

Установка и конфигурация Altcraft mSDK на Flutter

Работа с ролевым и JWT-токеном

Подробное описание rToken и JWT-токена, отличия, принцип работы.