Класс AMPAppMetricaPush

Основной класс для обработки Push-уведомлений.

Методы экземпляраМетоды экземпляра

СвойстваСвойства

Описание методовОписание методов

+downloadAttachmentsForNotificationRequest:+downloadAttachmentsForNotificationRequest:

+ (void)downloadAttachmentsForNotificationRequest:(UNNotificationRequest *)request
                                         callback:(AMPAttachmentsDownloadCallback)callback);

Загружает прикрепленные файлы в push-уведомлениях. Метод доступен для iOS 10.0 и выше.

Параметры:

typedef void (^AMPAttachmentsDownloadCallback) (NSArray<UNNotificationAttachment *> * _Nullable attachments, NSError * _Nullable error)

+handleApplicationDidFinishLaunchingWithOptions:+handleApplicationDidFinishLaunchingWithOptions:

+ (void)handleApplicationDidFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions

Обрабатывает открытие push-уведомления из метода application:didFinishLaunchingWithOptions:. Метод должен быть вызван после инициализации AppMetrica SDK.

Параметры:

+handleDidReceiveNotificationRequest:+handleDidReceiveNotificationRequest:

+ (void)handleDidReceiveNotificationRequest:(UNNotificationRequest *)request

Обрабатывает получение push-уведомления из расширения Notification Service Extension.

Метод должен быть вызван в реализации метода didReceiveNotificationRequest:withContentHandler:.

Параметры:

+handleRemoteNotification:+handleRemoteNotification:

+ (void)handleRemoteNotification:(NSDictionary *)userInfo

Обрабатывает открытие push-уведомления из метода application:didReceiveRemoteNotification:fetchCompletionHandler:. Метод должен быть вызван после инициализации AppMetrica SDK.

Параметры:

+handleSceneWillConnectToSession:+handleSceneWillConnectToSession:

+ (void)handleSceneWillConnectToSessionWithOptions:(UISceneConnectionOptions *)connectionOptions

Обрабатывает открытие push-уведомления из метода scene:willConnectToSession:options:. Метод должен быть вызван после инициализации AppMetrica SDK.

Параметры:

+isNotificationRelatedToSDK:+isNotificationRelatedToSDK:

+ (BOOL)isNotificationRelatedToSDK:(NSDictionary *)userInfo;

Возвращает YES, если push-уведомление относится к AppMetrica.

Параметры:

Возвращает:

• YES — если push-уведомление относится к AppMetrica.
• NO — если push-уведомление не относится к AppMetrica.

+setDeviceTokenFromData:+setDeviceTokenFromData:

+ (void)setDeviceTokenFromData:(nullable NSData *)data

Регистрирует device token приложения с production-окружением. Метод должен быть вызван после инициализации AppMetrica SDK.

Параметры:

+setDeviceTokenFromData:pushEnvironment:+setDeviceTokenFromData:pushEnvironment:

+ (void)setDeviceTokenFromData:(nullable NSData *)data
               pushEnvironment:(AMPAppMetricaPushEnvironment)pushEnvironment

Регистрирует device token приложения с указанным окружением. Метод должен быть вызван после инициализации AppMetrica SDK.

Параметры:

+setExtensionAppGroup:+setExtensionAppGroup:

+ (void)setExtensionAppGroup:(NSString *)appGroup

Регистрирует общую группу App Groups приложения и Notification Service Extension.

Регистрация необходима для отслеживания доставки push-уведомлений. Подробнее в разделе Настройка сбора статистики push-уведомлений.

Параметры:

+userDataForNotification:+userDataForNotification:

+ (nullable NSString *)userDataForNotification:(NSDictionary *)userInfo

Возвращает произвольную строку данных, которая передается в push-уведомлении:

• В поле Дополнительные данные при отправке из интерфейса AppMetrica.
• В поле data при отправке с помощью Push API.

Параметры:

Возвращает:

Произвольная строка данных.

Описание свойствОписание свойств

+userNotificationCenterDelegate+userNotificationCenterDelegate

@property (readonly, class) id<AMPUserNotificationCenterDelegate> userNotificationCenterDelegate;

Возвращает делегат AMPUserNotificationCenterDelegate, который обрабатывает foreground push-уведомления на iOS 10 и выше.

Для обработки foreground push-уведомлений, добавьте этот код в методе application:didFinishLaunchingWithOptions::

[UNUserNotificationCenter currentNotificationCenter].delegate = [AMPAppMetricaPush userNotificationCenterDelegate];

Для ручной обработки push-уведомлений используйте userNotificationCenterHandler.

+userNotificationCenterHandler+userNotificationCenterHandler

@property (readonly, class) id<AMPUserNotificationCenterHandling> userNotificationCenterHandler;

Возвращает делегат AMPUserNotificationCenterHandling, который позволяет вручную обрабатывать foreground push-уведомления на iOS 10 и выше.

Используйте этот делегат, если вы реализуете протокол UNUserNotificationCenterDelegate с собственной логикой. При этом необходимо реализовать каждый метод из делегата UNUserNotificationCenterDelegate и вызывать соответствующие методы в AMPUserNotificationCenterHandling.

Для упрощенной обработки push-уведомлений используйте userNotificationCenterDelegate.