Report Push Notification Data

For APNs push channel data such as device reach and notification clicks, the terminal must actively report the data to obtain statistical information. Starting from SDK version 5.1.4, RC iOS SDK provides an interface for reporting data.

tip

The push data statistics feature is only available for production environments of launched applications. If your application is hosted in a global data center, ensure that the SDK version is configured correctly to report data to the appropriate data center. For more details, refer to the knowledge base document RC Global Data Center Usage Guide.

Report Push Reach Data

Use the recordReceivedRemoteNotificationEvent: interface to report push reach data. This capability is supported on iOS 10 and above. Currently, only push reach data for one-to-one chat and group chat conversation types is supported. Reporting push reach data for ultra groups and push-only notifications is not supported.

/*!
    Record the event of receiving a remote push notification.

    @param userInfo    The content of the remote push notification.

    @discussion This method is used to track the delivery rate of RC push services.
    If you need to track the delivery rate of push services, you must implement a notification extension in your app. In the NotificationService's -didReceiveNotificationRequest: withContentHandler: method,
    initialize the appkey first, then call this method and pass the push content userInfo.

    @discussion If there is a separate statistics service address, you also need to set the independent statistics service address after initialization.

    Example:

    - (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
        self.contentHandler = contentHandler;
        self.bestAttemptContent = [request.content mutableCopy];

        NSDictionary *userInfo = self.bestAttemptContent.userInfo;
        [[RCCoreClient sharedCoreClient] initWithAppKey:RONGCLOUD_IM_APPKEY];
        if (RONGCLOUD_STATS_SERVER.length > 0) {
        [[RCCoreClient sharedCoreClient] setStatisticServer:RONGCLOUD_STATS_SERVER];
        }
        [[RCCoreClient sharedCoreClient] recordReceivedRemoteNotificationEvent:userInfo];

        self.contentHandler(self.bestAttemptContent);
    }

    @remarks Advanced feature
    */
- (void)recordReceivedRemoteNotificationEvent:(NSDictionary *)userInfo;

Report Push Click Data

Use the recordRemoteNotificationEvent interface to report remote push notification click data.

/*!
 Record the event of clicking a remote push notification.

 @param userInfo    The content of the remote push notification.

 @discussion This method is used to track the click-through rate of RC push services.
 If you need to track the click-through rate of push services, simply call this method in the AppDelegate's -application:didReceiveRemoteNotification: method and pass the launchOptions.

 @remarks Advanced feature
 */
- (void)recordRemoteNotificationEvent:(NSDictionary *)userInfo;