https://github.com/mobiletelesystems/mts-analytics-static-swiftpm-ios-sdk
https://github.com/mobiletelesystems/mts-analytics-static-swiftpm-ios-sdk
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mobiletelesystems/mts-analytics-static-swiftpm-ios-sdk
- Owner: MobileTeleSystems
- License: other
- Created: 2025-04-16T11:29:55.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-27T11:06:57.000Z (7 months ago)
- Last Synced: 2025-10-27T13:08:57.138Z (7 months ago)
- Language: Swift
- Size: 27.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# [MTS Analytics SDK](https://a.mts.ru/support/)
[](https://swiftpackageindex.com/MobileTeleSystems/mts-analytics-ios-sdk)
[](https://swiftpackageindex.com/MobileTeleSystems/mts-analytics-ios-sdk)
## Инсталляция SDK
### Swift Package Manager
[Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs) — это инструмент для автоматизации распространения кода на Swift, встроенный непосредственно в компилятор.
После того как ваш **Swift Package** настроен, подключить **MTAnalytics** в качестве зависимости можно очень просто: достаточно добавить его в список **dependencies** в файле **Package.swift** или в раздел пакетов прямо в **Xcode**.
#### Через Xcode:
1. Откройте меню **File** > **Add Package Dependency**.
2. Укажите GitHub ссылку на SDK: `https://github.com/MobileTeleSystems/mts-analytics-ios-sdk`
#### Через Package.swift:
1. Добавьте зависимость в **Package.swift**
```
.dependencies: [
.package(url: "https://github.com/MobileTeleSystems/mts-analytics-ios-sdk", from: "6.1.0")
],
```
2. В секции **targets** подключите модуль SDK:
```
.target(
name: "YourLibrary",
dependencies: [
.product(name: "MTAnalytics", package: "mts-analytics-ios-sdk"),
]
),
```
### Cocoapods
1. Чтобы добавить библиотеку MTAnalytics в проект, через CocoaPods добавьте в Podfile:
```ruby
pod 'MTAnalytics', '~> 6.1.0'
```
Теперь при установке MTAnalytics через Cocoapods, начиная с **5.3.0**, необходимо указывать **pod GRDB** таким образом:
```ruby
pod 'GRDB.swift', git: 'https://github.com/groue/GRDB.swift.git', tag: 'v6.29.3'
pod 'MTAnalytics', '~> 6.1.0'
```
2. Далее устанавливаем ссылку на библиотеку MTAnalytics в Podfile:
```ruby
source 'https://github.com/MobileTeleSystems/mts-analytics-ios-sdk'
```
3. Сохраните **Podfile** и введите `pod install` в Терминале для установки библиотеки.
4. Откройте проект в Xcode через `.xcworkspace` файл.
## Использование SDK
1. Сделайте импорт библиотеки:
```swift
import MTAnalytics
```
2. Инициализируйте библиотеку в методе application(_:didFinishLaunchingWithOptions:) вашего UIApplicationDelegate.
#### Для UIKit
```swift
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 и добавьте этот код:
```swift
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:
```swift
import SwiftUI
@main
struct YourAppNameApp: App {
// Подключаем AppDelegate через property wrapper
@UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
```
## Функциональность SDK
**Конфигурация SDK**: На этом этапе вы настраиваете параметры работы SDK - длительность сессий, лимиты хранения событий, режим отправки данных в роуминге. Конфигурация задаётся через MTAnalyticsConfiguration.
Подробная инструкция: [Конфигурация](https://a.mts.ru/support/analytics-software/app-sdk-setup/ios-sdk#шаг-3-конфигурация-библиотеки)
**Отправка событий:** Чтобы собирать аналитику пользовательских действий в приложении, настройте отправку событий SDK. События могут описывать клики, просмотры экранов, открытия функций.
Подробности см.: [Events](https://a.mts.ru/support/analytics-software/app-sdk-setup/data-collection/mapping/app)
**Подключение Crashlytics:** MTAnalytics SDK поддерживает интеграцию с Crashlytics, чтобы отслеживать сбои и падения приложения.
Это помогает выявлять критические ошибки и улучшать стабильность.
Руководство по настройке: [Crashlytics](https://a.mts.ru/support/analytics-software/crashlytics)
**Электронная коммерция**: Для отслеживания покупок, просмотров товаров и корзины используйте событие E-commerce. Поддерживается логирование товарных событий (просмотр, добавление в корзину, оформление заказа). Это позволит строить воронки продаж и анализировать поведение пользователей на всех этапах.
Подробности см.: [Ecommerce](https://a.mts.ru/support/analytics-software/app-sdk-setup/data-collection/mapping/app)
**А/Б-тесты и Remote Config**: Для экспериментов и персонализации интерфейса можно подключить А/Б-тесты и Remote Config. Это позволяет динамически изменять логику или внешний вид приложения без публикации в App Store.
Подробности: [A/B тесты](https://a.mts.ru/support/analytics-software/experiments/remote-config-ios)
**Отслеживание Deeplink**: Если приложение открывается по ссылкам (deeplink или universal link), важно передавать эти данные в SDK. Это позволяет корректно учитывать источник установки и перехода.
Подробная инструкция: [Отслеживание Deeplink](https://a.mts.ru/support/analytics-software/app-sdk-setup/data-collection/deeplink)
**Работа с Link Manager:** Link Manager помогает управлять кастомными ссылками для маркетинга, кампаний и интеграций. Через него можно отслеживать переходы и связывать их с событиями в приложении.
Подробная инструкция: [Link Manager](https://a.mts.ru/support/analytics-software/app-sdk-setup/link/general)
## Документация
Подробные инструкции по интеграции, включая установку, конфигурацию, тестирование и многое другое, вы можете найти в [полной документации](https://a.mts.ru/support/).
## Команда разработки
- Павел Богарт, pibogar1@mts.ru
- Анита Хасанова, arkhas12@mts.ru
- Леонид Перлин, lperlin@mts.ru