回执统计接口

更新时间:2025-03-25 11:59:43

本文档介绍了与回执统计相关的API。您可以根据需要选择是否进行接入。完成接入后,您将能够获取通知点击率等统计数据。

上报通知点击事件

通过将通知点击事件的ACK(确认)信息上报到推送服务器,您可以追踪用户的通知交互情况。有关详细步骤,请参考文档iOS SDK集成——通知处理

接口定义

+ (void)sendNotificationAck:(NSDictionary *)userInfo;

参数说明

参数

类型

是否必填

说明

参数

类型

是否必填

说明

userInfo

NSDictionary

通知的payload信息。

使用示例

Swift
Object C
func userNotificationCenter(_ center: UNUserNotificationCenter, 
                            didReceive response: UNNotificationResponse, 
                            withCompletionHandler completionHandler: @escaping () -> Void) {
    print("收到点击回调通知")
    handleUserInfo(response.notification.request.content.userInfo)
    
    // 判断点击动作
    let userAction = response.actionIdentifier
    if userAction == UNNotificationDefaultActionIdentifier {
        print("点击了打开通知")
        CloudPushSDK.sendNotificationAck(response.notification.request.content.userInfo)
    }
    
    if userAction == UNNotificationDismissActionIdentifier {
        print("点击了清除通知")
        CloudPushSDK.sendDeleteNotificationAck(response.notification.request.content.userInfo)
    }
    
    completionHandler()
}

func handleUserInfo(_ userInfo: [AnyHashable: Any]) {
    // 处理 userInfo
}
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    NSLog(@"收到点击回调通知");
    [self handleUserInfo:response.notification.request.content.userInfo];
    
    // 判断点击动作
    NSString *userAction = response.actionIdentifier;
    if ([userAction isEqualToString:UNNotificationDefaultActionIdentifier]) {
        NSLog(@"点击了打开通知");
        [CloudPushSDK sendNotificationAck:userInfo];
    }
    
    if ([userAction isEqualToString:UNNotificationDismissActionIdentifier]) {
        NSLog(@"点击了清除通知");
        [CloudPushSDK sendDeleteNotificationAck:userInfo];
    }
    
    completionHandler();
}

- (void)handleUserInfo:(NSDictionary *)userInfo {
    // 处理 userInfo
}

上报通知删除事件

将通知删除事件的ACK(确认)信息上报到推送服务器,以便获取用户删除通知的相关数据。详细的使用说明请参见iOS通知删除上报配置

接口定义

+ (void)sendDeleteNotificationAck:(NSDictionary *)userInfo;

参数说明

参数

类型

是否必选

说明

参数

类型

是否必选

说明

userInfo

NSDictionary

通知的payload信息。

(废弃)上报通知点击事件(App关闭)

上报通知点击事件到移动推送服务器。

  • SDK V1.8.1以下版本支持。

  • 点击通知将App从关闭状态拉起时,在didFinishLaunchingWithOptions回调中调用该接口。

接口定义

+ (void)handleLaunching:(NSDictionary *)launchOptions;

参数说明

参数

类型

是否必填

说明

参数

类型

是否必填

说明

launchOptions

NSDictionary

didFinishLaunchingWithOptions 回调中的launchOptions参数。

(废弃)上报通知点击事件(App打开)

上报通知点击事件到移动推送服务器。

  • SDK V1.8.1以下版本支持。

  • App处于打开状态(前台或后台),在didReceiveRemoteNotification回调中调用该接口。

  • App处于前台,通知不弹窗,直接触发回调;App处于后台,通知弹窗并触发回调。

接口定义

+ (void)handleReceiveRemoteNotification:(NSDictionary *)userInfo;

参数说明

参数

类型

是否必填

说明

参数

类型

是否必填

说明

userInfo

NSDictionary

didReceiveRemoteNotification回调中的参数userInfo

  • 本页导读 (0)
  • 上报通知点击事件
  • 接口定义
  • 参数说明
  • 使用示例
  • 上报通知删除事件
  • 接口定义
  • 参数说明
  • (废弃)上报通知点击事件(App关闭)
  • 接口定义
  • 参数说明
  • (废弃)上报通知点击事件(App打开)
  • 接口定义
  • 参数说明