--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.by/docs/en/sdk/ios/analytics/quick-start.md - https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/quick-start.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt # Интеграция SDK SDK под iOS предоставляется в виде модулей с исходным кодом. ## Шаг 1. Подключите библиотеку {#integration} {% list tabs %} - CocoaPods Чтобы подключить библиотеку аналитики, добавьте в Podfile проекта зависимость: ```ruby translate=no pod 'AppMetricaAnalytics', '~> 6.6.0' ``` #### {#app-for-kids} {% cut "У меня детское приложение" %} Если ваше приложение предназначено для детей, подключите модули без использования `AppMetricaAdSupport`: ```ruby translate=no pod 'AppMetricaCore', '~> 6.6.0' pod 'AppMetricaCrashes', '~> 6.6.0' pod 'AppMetricaWebKit', '~> 6.6.0' ``` {% endcut %} {% cut "Мне не нужен весь функционал" %} Если вам не нужен полный функционал AppMetrica SDK, подключите только необходимые модули: ```ruby translate=no pod 'AppMetricaCore', '~> 6.6.0' # Основной модуль для работы с AppMetrica SDK, обязателен для подключения pod 'AppMetricaAdSupport', '~> 6.6.0' # Необходим для сбора идентификаторов, без него не будет собираться IDFA pod 'AppMetricaCrashes', '~> 6.6.0' # Модуль для отлова крэшей и отправки ошибок pod 'AppMetricaWebKit', '~> 6.6.0' # Модуль для настройки отправки событий из JS-кода в WebView ``` {% endcut %} - SPM в Xcode #### Интеграция через интерфейс Xcode {#integration-xcode} Чтобы подключить библиотеку, выполните следующее: 1. В окне Xcode навигатора проектов (**Project Navigator**) выберите свой проект (если у вас используется **Workspace**). Затем в верхнем меню нажмите **File** и выберите **Add Package Dependencies...**. ![Project Navigator](../../../../_images/xcode_add_package_dependency.png) 2. Укажите URL репозитория `https://github.com/appmetrica/appmetrica-sdk-ios`. ![URL репозитория](../../../../_images/appmetrica-spm-url.png) 3. Оставьте только нужные модули (чтобы выключить модуль в `Add to Target` выберите значение `None`): ![нужные модули](../../../../_images/spm-select-packages.png) * `AppMetricaCore` — обязательный основной модуль SDK. Должен быть подключен для работы с AppMetrica. * `AppMetricaAdSupport` — модуль используется для сбора идентификаторов, включая IDFA. * `AppMetricaCrashes` — модуль предназначен для отлова крэшей и отправки ошибок. * `AppMetricaWebKit` — модуль позволяет осуществлять отправку событий из JavaScript кода в WebView. {% note info %} Если ваше приложение предназначено для детей, подключите модули без использования `AppMetricaAdSupport`. {% endnote %} - Package.swift #### Интеграция через Package.swift манифест {#integration-package-swift} Для начала добавьте следующую зависимость в массив `dependencies:` вашего пакета: ```swift translate=no dependencies: [ .package( url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "6.6.0" ) ], ``` Модули AppMetrica SDK, которые вы можете подключить в зависимости от потребностей вашего проекта: * `AppMetricaCore` — обязательный основной модуль SDK. Должен быть подключен для работы с AppMetrica. * `AppMetricaAdSupport` — модуль используется для сбора идентификаторов, включая IDFA. * `AppMetricaCrashes` — модуль предназначен для отлова крэшей и отправки ошибок. * `AppMetricaWebKit` — модуль позволяет осуществлять отправку событий из JavaScript кода в WebView. {% note info %} Если ваше приложение предназначено для детей, подключите модули без использования `AppMetricaAdSupport`. {% endnote %} Пример подключения модулей в массиве `dependencies:` таргета: ```swift translate=no .target( name: "MyTargetName", dependencies: [ .product(name: "AppMetricaCore", package: "AppMetrica"), .product(name: "AppMetricaCrashes", package: "AppMetrica"), .product(name: "AppMetricaWebKit", package: "AppMetrica"), // .product(name: "AppMetricaAdSupport", package: "AppMetrica"), // Этот модуль отлючен ] ), ``` - Tuist через Package.swift #### Интеграция через Tuist с Package.swift манифестом Добавьте в Tuist/Package.swift ``` import PackageDescription #if TUIST import struct ProjectDescription.PackageSettings let packageSettings = PackageSettings( productTypes: [:] ) #endif let package = Package( name: "NewTuist", dependencies: [ .package(url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "5.0.0") ] ) ```` Теперь добавьте зависимости в Project.swift. Для работы AppMetrica требуется флаг линковщика "-ObjC". Добавьте его во все таргеты, которые статически слинкованы с AppMetrica, например: ``` dependencies: [ .external(name: "AppMetricaCore"), ], settings: .settings( base: ["OTHER_LDFLAGS": "$(inherited) -ObjC"] ) ``` {% endlist %} ## Шаг 2. Инициализируйте библиотеку {#initialization} {% list tabs group=instructions %} - Swift Добавьте импорт: ```swift translate=no import AppMetricaCore ``` Инициализируйте библиотеку в методе `application(_:didFinishLaunchingWithOptions:)` вашего `UIApplicationDelegate`: ```swift translate=no 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!) } ``` - Objective-C Добавьте импорт: ```obj-c translate=no #import ``` Инициализируйте библиотеку в методе `application:didFinishLaunchingWithOptions:` вашего `UIApplicationDelegate`: ```obj-c translate=no - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // Initializing the AppMetrica SDK. AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"]; [AMAAppMetrica activateWithConfiguration:configuration]; return YES; } ``` {% endlist %} {% cut "Что такое API key?" %} API key — уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при [добавлении приложения](https://appmetrica.yandex.ru/application/new). Посмотреть его можно в разделе **Настройки** → **Основное**. {% endcut %} AppMetrica позволяет отслеживать предустановленные приложения. Подробнее в разделе [трекинг предустановленных приложений](https://appmetrica.yandex.by/docs/ru/mobile-tracking/preinstalled-app-attr.md). ## Шаг 3. (Опционально) Настройте отправку событий, атрибутов профиля и Revenue {#send} 1. Чтобы собирать информацию о действиях в приложении, настройте отправку собственных событий. Подробнее в разделе [Отправка собственных событий](https://appmetrica.yandex.by/docs/ru/data-collection/about-events.md). 2. Чтобы собирать информацию о пользователях, настройте отправку атрибутов профиля. Подробнее в разделе [Профили](https://appmetrica.yandex.by/docs/ru/data-collection/about-profiles.md). {% note info %} В отличие от событий, атрибут профиля может принимать только одно значение. При отправке нового значения атрибута старое значение перезаписывается. {% endnote %} 4. Чтобы отслеживать покупки в приложении, настройте отправку Revenue. Подробнее в разделе [In-App покупки](https://appmetrica.yandex.by/docs/ru/data-collection/about-revenue.md). ## Шаг 4. Протестируйте работу библиотеки {#test} Чтобы проверить работу библиотеки: 1. Запустите приложение с AppMetrica SDK и используйте его некоторое время. 2. Убедитесь, что устройство подключено к интернету. 3. В интерфейсе AppMetrica убедитесь, что: * В отчете [Аудитория](https://appmetrica.yandex.by/docs/ru/mobile-reports/audience-report.md) появился новый пользователь. * В отчете **Вовлечённость** → **Сессии** увеличилось число сессий. * В отчете [События](https://appmetrica.yandex.by/docs/ru/mobile-reports/events-report.md) и [Профили](https://appmetrica.yandex.by/docs/ru/mobile-reports/profile-report.md) появились отправленные события и атрибуты профиля. ## Узнайте больше {#learn-more} - [Настройка отправки собственных событий](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#report-event) - [Настройка отправки атрибутов профиля](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-attribute-profile) - [Настройка отправки событий Ecommerce](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-ecommerce) - [Настройка отправки событий Revenue](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-revenue) - [Настройка отправки событий Ad Revenue](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-adrevenue) - [Как включить отправку данных о местоположении пользователей?](https://appmetrica.yandex.by/docs/ru/troubleshooting/troubleshooting.md#region) ## Возможные проблемы и их решение {#faq} - [Не увеличивается число сессий](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-errors.md#faq-session-count) - [Нет событий](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-errors.md#no-events) - [Проблемы со Swift Package Manager](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-errors.md#swift-manager) - [В списке нет моей проблемы](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-errors.md#not-found) Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот. Написать в службу поддержки Предложить улучшение для документации