Подключение и инициализация

Библиотека AppMetrica состоит из двух фреймворков: один содержит основную функциональность SDK, другой — обработку крэшей. Если вы не используете обработку крэшей средствами AppMetrica, то подключение только основного фреймворка позволит уменьшить размер приложения.

AppMetrica SDK также поддерживает следующие платформы:
  1. Шаг 1. Подключите библиотеку
  2. Шаг 2. Инициализируйте библиотеку
  3. Шаг 3. (Опционально) Настройте отправку событий, атрибутов профиля и Revenue
  4. Шаг 4. Протестируйте работу библиотеки

Шаг 1. Подключите библиотеку

Библиотека может работать со следующими системами управления зависимостями:

Библиотека поддерживает статический и динамический фреймворки для CocoaPods.

Чтобы подключить библиотеку с обработкой крэшей, добавьте в Podfile проекта зависимость:

  • Статический фреймворк

    pod 'YandexMobileMetrica', '3.9.4'
    Скопировано

    Пример подключения статического фреймворка на GitHub.

  • Динамический фреймворк

    pod 'YandexMobileMetrica/Dynamic', '3.9.4'
    Скопировано

Чтобы подключить библиотеку без обработки крэшей, используйте зависимость YandexMobileMetrica/Static/Core или YandexMobileMetrica/Dynamic/Core.

Примечание. Если в Podfile присутствует строка use_frameworks!, рекомендуем использовать динамический фреймворк.
Если вы не используете указанные системы управления зависимостями

Для подключения библиотеки выполните следующее:

  1. Добавьте YandexMobileMetrica.framework в проект.
  2. (Опционально) Для подключения обработки крэшей добавьте YandexMobileMetricaCrashes.framework.
  3. Добавьте следующие зависимости: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'SafariServices' (с настройкой Optional).
  4. Добавьте -ObjC в Other Linker Flags.

Шаг 2. Инициализируйте библиотеку

Инициализируйте библиотеку в методе application:didFinishLaunchingWithOptions: вашего UIApplicationDelegate:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Initializing the AppMetrica SDK.
    YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:@"API_key"];
    [YMMYandexMetrica activateWithConfiguration:configuration];
}
Скопировано
Что такое API key?

API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

Убедитесь, что он указан верно.

AppMetrica позволяет отслеживать предустановленные приложения. Подробнее см. в разделе трекинг предустановленных приложений.

Примечание. Требования: deployment target 8.0 и выше.

Шаг 3. (Опционально) Настройте отправку событий, атрибутов профиля и Revenue

Чтобы собирать информацию о действиях в приложении, настройте отправку собственных событий. Подробнее в разделе Отправка собственных событий.

Чтобы собирать информацию о пользователях, настройте отправку атрибутов профиля. Подробнее в разделе Профили.

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

Чтобы отслеживать покупки в приложении, настройте отправку Revenue. Подробнее в разделе Выручка.

Шаг 4. Протестируйте работу библиотеки

Чтобы проверить работу библиотеки:
  1. Запустите приложение с AppMetrica SDK и используйте его некоторое время.
  2. Убедитесь, что устройство подключено к интернету.
  3. В интерфейсе AppMetrica убедитесь, что:
    • В отчете Аудитория появился новый пользователь.
    • В отчете Вовлечённость → Сессии увеличилось число сессий.
    • В отчете События и Профили появились отправленные события и атрибуты профиля.

Возможные проблемы и их решение

Не увеличивается число сессий

Проверьте настройки отслеживания сессий. Подробнее в разделе Отслеживание активности пользователей.

Нет событий
  1. Совершите в приложении минимум 10 действий, которые инициируют отправку событий.

    Это необходимо, потому что события накапливаются и отправляются на сервер по несколько штук.

  2. Подождите 10 минут и проверьте отчет. События отображаются в отчете не сразу.
В списке нет моей проблемы
Если в списке нет вашей проблемы, обратитесь в службу поддержки. В обращении укажите:
  1. Пример интеграции SDK в вашем приложении.
  2. ID приложения в веб-интерфейсе AppMetrica.
  3. ID устройства.
    Как получить Apple IDFA
    1. Установите приложение AppMetrica на тестовое устройство.
    2. Авторизуйтесь и выберите из списка ваше приложение в AppMetrica.
    3. В левом верхнем углу нажмите  → Устройство.
    4. Apple IDFA указан в поле IDFA. Укажите его в веб-интерфейсе AppMetrica.
    Примечание. Тестирование атрибуции можно включить в приложении AppMetrica. Для этого включите Тест атрибуции.
  4. Производителя и модель устройства, платформу и версию ОС, версию AppMetrica SDK.