Contents

mtswebservices/mts-analytics-ios-sdk

[Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs) — это инструмент для автоматизации распространения кода на Swift, встроенный непосредственно в компилятор.

Инсталляция SDK

Swift Package Manager

Swift Package Manager — это инструмент для автоматизации распространения кода на Swift, встроенный непосредственно в компилятор.

После того как ваш Swift Package настроен, подключить MTAnalytics в качестве зависимости можно очень просто: достаточно добавить его в список dependencies в файле Package.swift или в раздел пакетов прямо в Xcode.

Через Xcode:
  1. Откройте меню File > Add Package Dependency.
  2. Укажите GitHub ссылку на SDK: https://github.com/MTSWebServices/mts-analytics-ios-sdk
Через Package.swift:
  1. Добавьте зависимость в Package.swift
.dependencies: [
    .package(url: "https://github.com/MTSWebServices/mts-analytics-ios-sdk", from: "6.4.0")
],
  1. В секции targets подключите модуль SDK:
.target(
    name: "YourLibrary",
    dependencies: [
        .product(name: "MTAnalytics", package: "mts-analytics-ios-sdk"),
    ]
),

Cocoapods

  1. Чтобы добавить библиотеку MTAnalytics в проект, через CocoaPods добавьте в Podfile:
pod 'MTAnalytics',  '~> 6.4.0'

Теперь при установке MTAnalytics через Cocoapods, начиная с 5.3.0, необходимо указывать pod GRDB таким образом:

pod 'GRDB.swift', git: 'https://github.com/groue/GRDB.swift.git', tag: 'v6.29.3'
pod 'MTAnalytics', '~> 6.4.0'
  1. Далее устанавливаем ссылку на библиотеку MTAnalytics в Podfile:
source 'https://github.com/MTSWebServices/mts-analytics-ios-sdk'
  1. Сохраните Podfile и введите pod install в Терминале для установки библиотеки.
  2. Откройте проект в Xcode через .xcworkspace файл.

Использование SDK

  1. Сделайте импорт библиотеки:
import MTAnalytics
  1. Инициализируйте библиотеку в методе application(_:didFinishLaunchingWithOptions:) вашего UIApplicationDelegate.
Для UIKit
import MTAnalytics

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
    let configuration = MTAnalyticsConfiguration(flowId: "your-flow-id")
    MTAnalyticsApp.configure(configuration)
    return true
}
Для SwiftUI

Создайте новый Swift файл для AppDelegate и добавьте этот код:

import UIKit
import MTAnalytics

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
        let configuration = MTAnalyticsConfiguration(flowId: "your-flow-id")
        MTAnalyticsApp.configure(configuration)
        return true
    }
}

Затем в App подключите AppDelegate:

import SwiftUI

@main
struct YourAppNameApp: App {
    // Подключаем AppDelegate через property wrapper
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Функциональность SDK

Конфигурация SDK: На этом этапе вы настраиваете параметры работы SDK - длительность сессий, лимиты хранения событий, режим отправки данных в роуминге. Конфигурация задаётся через MTAnalyticsConfiguration. Подробная инструкция: <u>Конфигурация</u>

Отправка событий: Чтобы собирать аналитику пользовательских действий в приложении, настройте отправку событий SDK. События могут описывать клики, просмотры экранов, открытия функций. Подробности см.: <u>Events</u>

Подключение Crashlytics: MTAnalytics SDK поддерживает интеграцию с Crashlytics, чтобы отслеживать сбои и падения приложения. Это помогает выявлять критические ошибки и улучшать стабильность. Руководство по настройке: <u>Crashlytics</u>

Электронная коммерция: Для отслеживания покупок, просмотров товаров и корзины используйте событие E-commerce. Поддерживается логирование товарных событий (просмотр, добавление в корзину, оформление заказа). Это позволит строить воронки продаж и анализировать поведение пользователей на всех этапах. Подробности см.: <u>Ecommerce</u>

А/Б-тесты и Remote Config: Для экспериментов и персонализации интерфейса можно подключить А/Б-тесты и Remote Config. Это позволяет динамически изменять логику или внешний вид приложения без публикации в App Store. Подробности: <u>A/B тесты</u>

Отслеживание Deeplink: Если приложение открывается по ссылкам (deeplink или universal link), важно передавать эти данные в SDK. Это позволяет корректно учитывать источник установки и перехода. Подробная инструкция: <u>Отслеживание Deeplink</u>

Работа с Link Manager: Link Manager помогает управлять кастомными ссылками для маркетинга, кампаний и интеграций. Через него можно отслеживать переходы и связывать их с событиями в приложении. Подробная инструкция: <u>Link Manager</u>

Документация

Подробные инструкции по интеграции, включая установку, конфигурацию, тестирование и многое другое, вы можете найти в полной документации.

Команда разработки

  • Павел Богарт, pibogar1@mts.ru
  • Анита Хасанова, arkhas12@mts.ru
  • Леонид Перлин, lperlin@mts.ru

Package Metadata

Repository: mtswebservices/mts-analytics-ios-sdk

Default branch: main

README: README.md