Copy page

iOS SDK

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

1. Настройка AppGroup

1. Откройте настройки проекта.
2. Выберите основной таргет.
3. Перейдите на вкладку Signing & Capabilities.
4. Нажмите на кнопку «добавить» и выберите AppGroups.
5. Добавьте новую группу с названием по шаблону group.cloud.Mindbox.{bundle id приложения}
   Например, bundle id приложения - Mindbox-Sample-App, тогда значение App Group должно быть group.cloud.Mindbox.Mindbox-Sample-App.

SDK валидирует, что группа названа по шаблону. Если нарушить шаблон, SDK выбросит исключение.

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

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

---

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

Swift
let mindboxSdkConfig = try MBConfiguration(
	endpoint: "<ендпоинт проекта>",
  domain: "<Domain API Mindbox>",
  subscribeCustomerIfCreated: true,
  shouldCreateCustomer: true)

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

Swift
let mindboxSdkConfig = try MBConfiguration(
  endpoint: "<ендпоинт проекта>",
  domain: "<Domain API Mindbox>",
  subscribeCustomerIfCreated: false,
  shouldCreateCustomer: true)

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

Swift
let mindboxSdkConfig = try MBConfiguration(
  endpoint: "<ендпоинт проекта>",
  domain: "<Domain API Mindbox>",
  shouldCreateCustomer: false)

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

3.1 Инициализация SDK без использования запроса на IDFA

Данный способ инициализации не учитывает запрос на разрешение использования IDFA, поэтому как идентификатор пользователя будет использоваться IDFV или сгенерированный случайно UUID.

В методе didFinishLaunchingWithOptions инициализируйте библиотеку и используйте вариант конфигурации, выбранный на этапе 2.

Swift
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    super.application(application, didFinishLaunchingWithOptions: launchOptions)

    // Добавьте сюда выбранную конфигурацию с предыдущего шага.
    Mindbox.shared.initialization(configuration: mindboxSdkConfig)

    // Другая логика

    return true
}

3.2 Инициализация SDK c использованием IDFA запроса

Если хотите использовать IDFA как идентификатор пользователя в Mindbox, то первую инициализацию нужно провести после запроса разрешения на отслеживание действий пользователя по IDFA при помощи App Tracking Transparency APIs.

В методе initializeMindbox используйте вариант конфигурации, выбранный на этапе 2.
Если используете жизненный цикл UISceneDelegate вместо UIApplicationDelegate, показанному в примере ниже, то используйте соответствующий выбранному жизненному циклу метод.

Swift
import UIKit
import Mindbox
import AppTrackingTransparency

// This is only one use case. It is necessary to adapt the approach to your specific use case.

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    
  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    // ...
        
    if ATTrackingManager.trackingAuthorizationStatus != .notDetermined {
      initializeMindbox()
    }
    
    // ...
    return true
    }
    
  // If you're using scenes (iOS 13.0+), UIKit will not call this method. Use `sceneDidBecomeActive(_:)` instead.
  func applicationDidBecomeActive(_ application: UIApplication) {
    if ATTrackingManager.trackingAuthorizationStatus == .notDetermined {
      DispatchQueue.main.async {
        ATTrackingManager.requestTrackingAuthorization { status in
          self.initializeMindbox()
        }
      }
    }
  }
    
  func initializeMindbox() {
    do {
      // ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 2 КОНФИГУРАЦИЮ SDK 
      Mindbox.shared.initialization(configuration: mindboxSdkConfig)
    } catch {
      print(error.localizedDescription)
    }
  }
  // ...
}

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

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