Документация
Интеграция SDK

Подключение AppMetrica Push SDK

Перед началом работы с AppMetrica Push SDK необходимо подключить и инициализировать AppMetrica SDK не ниже версии 2.6.2.

Шаг 1. Библиотека адаптирована для работы с системой управления зависимостями CocoaPods. Для подключения библиотеки добавьте в Podfile проекта зависимость:

 pod 'YandexMobileMetricaPush', '0.4.0'
Если вы не используете CocoaPods
  1. Загрузите библиотеку AppMetrica Push.
  2. Добавьте YandexMobileMetricaPush.framework в проект.
Примечание. Библиотеки AppMetrica SDK и AppMetrica Push SDK должны быть подключены одним из этих способов.

Шаг 2. Зарегистрируйте приложение в APNs. Это необходимо для подготовки приложения к работе с push-уведомлениями. Для отправки уведомлений на устройства с iOS версии 7 и выше добавьте в код приложения следующие изменения:

if ([application respondsToSelector:@selector(registerUserNotificationSettings:)]) {
        UIUserNotificationSettings *settings = // ...
        [application registerUserNotificationSettings:settings];
        [application registerForRemoteNotifications];
    }
    else {
        UIRemoteNotificationType notificationTypes =
            UIRemoteNotificationTypeBadge |
            UIRemoteNotificationTypeSound |
            UIRemoteNotificationTypeAlert;
        [application registerForRemoteNotificationTypes:notificationTypes];
    }

Как правило, эти данные передаются в методе - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions.

Подробно об используемых методах:

Шаг 3. Для отправки push-уведомления с помощью AppMetrica необходим device token вашего приложения. Чтобы зарегистрировать его, добавьте следующий код в вашу реализацию UIApplicationDelegate:

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    // Если до этого шага не была инициализирована библиотека AppMetrica SDK, вызов метода приведет к аварийной остановке приложения.
    [YMPYandexMetricaPush setDeviceTokenFromData:deviceToken];
}

Шаг 4. Настройте обработку открытия push-уведомления, добавив следующий код в соответствующие методы UIApplicationDelegate:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [YMPYandexMetricaPush handleApplicationDidFinishLaunchingWithOptions:launchOptions];
    return YES;
}
- (void)application:(UIApplication *)application
        didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    [YMPYandexMetricaPush handleRemoteNotification:userInfo];
}
- (void)application:(UIApplication *)application
        didReceiveRemoteNotification:(NSDictionary *)userInfo
        fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler
{
    [YMPYandexMetricaPush handleRemoteNotification:userInfo];
}

При необходимости вы можете передавать вместе с push-уведомлением дополнительную информацию. Эти данные указываются в веб-интерфейсе AppMetrica при настройке push-кампании. Чтобы получать эту информацию, используйте метод:

NSString *userData = [YMPYandexMetricaPush userDataForNotification:userInfo];

где userInfo содержит данные о push-уведомлении.