Интеграция SDK

SDK под iOS предоставляется в виде модулей с исходным кодом.

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

pod 'AppMetricaAnalytics', '~> 5.8.1'

pod 'AppMetricaCore', '~> 5.8.1'
pod 'AppMetricaCrashes', '~> 5.8.1'
pod 'AppMetricaWebKit', '~> 5.8.1'

pod 'AppMetricaCore', '~> 5.8.1' # Основной модуль для работы с AppMetrica SDK, обязателен для подключения
pod 'AppMetricaAdSupport', '~> 5.8.1' # Необходим для сбора идентификаторов, без него не будет собираться IDFA
pod 'AppMetricaCrashes', '~> 5.8.1' # Модуль для отлова крэшей и отправки ошибок
pod 'AppMetricaWebKit', '~> 5.8.1' # Модуль для настройки отправки событий из JS-кода в WebView

dependencies: [
   .package(
      url: "https://github.com/appmetrica/appmetrica-sdk-ios",
      from: "5.8.1"
   )
],

.target(
   name: "MyTargetName",
   dependencies: [
      .product(name: "AppMetricaCore", package: "AppMetrica"),
      .product(name: "AppMetricaCrashes", package: "AppMetrica"),
      .product(name: "AppMetricaWebKit", package: "AppMetrica"),
      // .product(name: "AppMetricaAdSupport", package: "AppMetrica"), // Этот модуль отлючен
   ]
),

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

import AppMetricaCore

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    // Initializing the AppMetrica SDK.
    let configuration = AppMetricaConfiguration(apiKey: "API key")
    AppMetrica.activate(with: configuration!)
}

#import <AppMetricaCore/AppMetricaCore.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Initializing the AppMetrica SDK.
    AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
    [AMAAppMetrica activateWithConfiguration:configuration];
    return YES;
}

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

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

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

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

   Примечание

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

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

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

Чтобы проверить работу библиотеки:

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

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

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

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

Нет событий

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

2. Подождите 10 минут и проверьте отчет. События отображаются в отчете не сразу.

Проблемы со Swift Package Manager

Ознакомьтесь со статьями Ошибка «Library Not Found» при запуске приложения на устройстве и Ошибка во время установки библиотеки на устройство.

В списке нет моей проблемы

Если в списке нет вашей проблемы, обратитесь в службу поддержки. В обращении укажите:

1. Пример интеграции SDK в вашем приложении.

2. ID приложения в веб-интерфейсе AppMetrica.

3. ID устройства.

   Как получить Apple IDFA

   1. Установите приложение AppMetrica на тестовое устройство.

   2. Авторизуйтесь и выберите из списка ваше приложение в AppMetrica.

   3. В левом верхнем углу нажмите → Устройство.

   4. Apple IDFA указан в поле IDFA. Укажите его в веб-интерфейсе AppMetrica.

      Примечание

      Тестирование атрибуции можно включить в приложении AppMetrica. Для этого включите Тест атрибуции.

4. Производителя и модель устройства, платформу и версию ОС, версию AppMetrica SDK.

Узнайте больше

• Как включить отправку данных о местоположении пользователей?

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