Подключение и инициализация
Библиотека AppMetrica состоит из двух фреймворков: один содержит основную функциональность SDK, другой — обработку крэшей. Если вы не используете обработку крэшей средствами AppMetrica, то подключение только основного фреймворка позволит уменьшить размер приложения.
- iOS;
Шаг 1. Подключите библиотеку
Библиотека может работать со следующими системами управления зависимостями:
Библиотека поддерживает статический и динамический фреймворки для CocoaPods.
Чтобы подключить библиотеку с обработкой крэшей, добавьте в Podfile проекта зависимость:
Статический фреймворк
pod 'YandexMobileMetrica', '4.5.2'
СкопированоПример подключения статического фреймворка на GitHub.
Динамический фреймворк
pod 'YandexMobileMetrica/Dynamic', '4.5.2'
Скопировано
Чтобы подключить библиотеку без обработки крэшей, используйте зависимость YandexMobileMetrica/Static/Core
или YandexMobileMetrica/Dynamic/Core
.
Чтобы подключить библиотеку, добавьте в Cartfile
следующую зависимость и сохраните файл:
binary "https://raw.githubusercontent.com/yandexmobile/metrica-sdk-ios/master/YandexMobileMetrica.json" ~> 4.5.2
Скопировано
Чтобы подключить библиотеку, выполните следующее:
В Xcode, в своем проекте выберите вкладку Swift Packages.
Укажите URL репозитория
https://github.com/yandexmobile/metrica-sdk-ios
, в нем находится Swift-пакет.Настройте правило для выбора версии пакета.
Ограничение.Подключение с помощью Swift Package Manager поддерживается, начиная с версии 3.14.0 AppMetrica SDK.
- Выберите необходимые библиотеки.
- Добавьте
YandexMobileMetrica.framework
в проект. - (Опционально) Для подключения обработки крэшей добавьте
YandexMobileMetricaCrashes.framework
. - Добавьте следующие зависимости: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'WebKit', 'SafariServices' (с настройкой Optional).
- Добавьте
-ObjC
вOther Linker Flags
.
Для подключения библиотеки выполните следующее:
Шаг 2. Инициализируйте библиотеку
#import <YandexMobileMetrica/YandexMobileMetrica.h>
Инициализируйте библиотеку в методе application:didFinishLaunchingWithOptions:
вашего UIApplicationDelegate
:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // Initializing the AppMetrica SDK. YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:@"API_key"]; [YMMYandexMetrica activateWithConfiguration:configuration]; }
Скопировано
import YandexMobileMetrica
Инициализируйте библиотеку в методе application(_:didFinishLaunchingWithOptions:)
вашего UIApplicationDelegate
:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool { // Initializing the AppMetrica SDK. let configuration = YMMYandexMetricaConfiguration.init(apiKey: "API_key") YMMYandexMetrica.activate(with: configuration!) }
Скопировано
API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.
Убедитесь, что он указан верно.
AppMetrica позволяет отслеживать предустановленные приложения. Подробнее см. в разделе трекинг предустановленных приложений.
Шаг 3. (Опционально) Настройте отправку событий, атрибутов профиля и Revenue
Чтобы собирать информацию о действиях в приложении, настройте отправку собственных событий. Подробнее в разделе Отправка собственных событий.
Чтобы собирать информацию о пользователях, настройте отправку атрибутов профиля. Подробнее в разделе Профили.
Чтобы отслеживать покупки в приложении, настройте отправку Revenue. Подробнее в разделе In-App покупки.
Шаг 4. Протестируйте работу библиотеки
- Запустите приложение с AppMetrica SDK и используйте его некоторое время.
- Убедитесь, что устройство подключено к интернету.
Возможные проблемы и их решение
- Совершите в приложении минимум 10 действий, которые инициируют отправку событий.
Это необходимо, потому что события накапливаются и отправляются на сервер по несколько штук.
- Подождите 10 минут и проверьте отчет. События отображаются в отчете не сразу.
- Пример интеграции SDK в вашем приложении.
- ID приложения в веб-интерфейсе AppMetrica.
- ID устройства.
- Установите приложение AppMetrica на тестовое устройство.
- Авторизуйтесь и выберите из списка ваше приложение в AppMetrica.
- В левом верхнем углу нажмите.
- Apple IDFA указан в поле IDFA. Укажите его в веб-интерфейсе AppMetrica.
Как получить Apple IDFAПримечание. Тестирование атрибуции можно включить в приложении AppMetrica. Для этого включите Тест атрибуции. - Производителя и модель устройства, платформу и версию ОС, версию AppMetrica SDK.
Проверьте настройки отслеживания сессий. Подробнее в разделе Отслеживание активности пользователей.