Подключение и инициализация
Библиотека AppMetrica состоит из двух фреймворков: один содержит основную функциональность SDK, другой — обработку крэшей. Если вы не используете обработку крэшей средствами AppMetrica, то подключение только основного фреймворка позволит уменьшить размер приложения.
Шаг 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>
Инициализируйте библиотеку в методе initialize
расширения NSExtensionPrincipalClass
:
+ (void)initialize { if ([self class] == [MMSTodayViewController class]) { // Initializing the AppMetrica SDK. YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:@"API_key"]; [YMMYandexMetrica activateWithConfiguration:configuration]; } }
Скопировано
import YandexMobileMetrica
Инициализируйте библиотеку в методе initialize
расширения NSExtensionPrincipalClass
:
override class func initialize() { if self === MMSTodayViewController.self { // 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.
Проверьте настройки отслеживания сессий. Подробнее в разделе Отслеживание активности пользователей.