极光推送

上报推送 ID

为了保证登录之后的用户也能设置 registrationID 属性，需要在 - registrationIDCompletionHandler: 回调和调用海纳 - setUserUId: 接口之后，各上报一次 registrationID。

    // 海纳 SDK 初始化之后，在极光回调中上报 registrationID
    [JPUSHService registrationIDCompletionHandler:^(int resCode, NSString *registrationID) {
        [[HinaCloudSDK sharedInstance] set:@"jiguang_id"  to:registrationID];
    }];
    // 用户登录之后，再次上报 registrationID
    [[HinaCloudSDK sharedInstance] setUserUId:<#登录 ID#>];
    [[HinaCloudSDK sharedInstance] set:@"jiguang_id" to:registrationID];

记录 「推送打开」事件并处理智能运营平台推送的消息

//  iOS10以下，点击通知的回调
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

    // Required, iOS 7 Support
    [JPUSHService handleRemoteNotification:userInfo];

    // 处理平台推送的消息
    [HinaFocusHelper dealHinaFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
        // TODO 处理打开 URL 消息，--> 请处理 URL
    } customize:^(NSDictionary * _Nonnull customizedDic) {
        // TODO 处理自定义消息，--> 请处理自定义消息
    }];
    completionHandler(UIBackgroundFetchResultNewData);
}

// iOS10以上，点击通知的回调
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler  API_AVAILABLE(ios(10.0)){
    // Required
    NSDictionary *userInfo = response.notification.request.content.userInfo;
    if ([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }

    // 处理平台推送的消息
    [HinaFocusHelper dealHinaFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
        // TODO 处理打开 URL 消息，--> 请处理 URL
    } customize:^(NSDictionary * _Nonnull customizedDic) {
        // TODO 处理自定义消息，--> 请处理自定义消息
    }];
    completionHandler();  // 系统要求执行这个方法
}

友盟推送

上报deviceToken

为了保证登录之后的用户也能设置 deviceToken 属性，需要在获取到 deviceToken 时和调用海纳 - setUserUId: 接口之后，各上报一次 deviceToken。

/** 远程通知注册成功委托 */
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

    [UMessage registerDeviceToken:deviceToken];

    if (![deviceToken isKindOfClass:[NSData class]]) return;
    const unsigned *tokenBytes = (const unsigned *)[deviceToken bytes];
    NSString *hexToken = [NSString stringWithFormat:@"%08x%08x%08x%08x%08x%08x%08x%08x",
                          ntohl(tokenBytes[0]), ntohl(tokenBytes[1]), ntohl(tokenBytes[2]),
                          ntohl(tokenBytes[3]), ntohl(tokenBytes[4]), ntohl(tokenBytes[5]),
                          ntohl(tokenBytes[6]), ntohl(tokenBytes[7])];
    // 将 deviceToken 保存到海纳用户表 umeng_id 中（这里的 umeng_id 只是一个示例字段）
    [[HinaCloudSDK sharedInstance] set:@"umeng_id" to:hexToken];

    /**
     * 将 hexToken 进行缓存
     */
}

记录 「推送打开」事件并处理智能运营平台推送的消息

    [[HinaCloudSDK sharedInstance] setUserUId:<#登录 ID#>];

    // 为了保证登录后的用户也能正确设置 deviceToken，调用 setUserUId 之后，需要再次上报。
    NSString *hexToken = <#取出之前缓存的 hexToken#>
    [[HinaCloudSDK sharedInstance] set:@"umeng_id" to:hexToken];

个推推送

上报推送ID

为了保证登录之后的用户也能设置 clientId 属性，需要在 GeTuiSdkDelegate 协议方法 GeTuiSdkDidRegisterClient: 和调用海纳 - setUserUId: 接口之后，各上报一次 clientId。

- (void)GeTuiSdkDidRegisterClient:(NSString *)clientId {
    // 将clientId 保存到用户表的 getui_id 字段中（这里的 getui_id 只是一个示例字段）
    [[HinaCloudSDK sharedInstance] set:@"getui_id" to:clientId];
}

记录 「推送打开」事件并处理智能运营平台推送的消息

// iOS10 一下版本，iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    // [ GTSdk ]：将收到的APNs信息传给个推统计
    [GeTuiSdk handleRemoteNotification:userInfo];

    // 记录 推送打开 事件
    [HinaFocusHelper trackHinaFocusAppOpenNotificationWithUserInfo:userInfo];
    // 处理平台推送的消息
    [HinaFocusHelper dealHinaFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
        // TODO 处理打开 URL 消息，--> 请处理 URL
    } customize:^(NSDictionary * _Nonnull customizedDic) {
        // TODO 处理自定义消息，--> 请处理自定义消息
    }];
    completionHandler(UIBackgroundFetchResultNewData);
}

//  iOS 10: 点击通知进入App时触发，在该方法内统计有效用户点击数
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {

    NSDictionary *userInfo = response.notification.request.content.userInfo;
    if ([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        // [ GTSdk ]：将收到的APNs信息传给个推统计
        [GeTuiSdk handleRemoteNotification:userInfo];
    }
    // 记录 推送打开 事件
    [HinaFocusHelper trackHinaFocusAppOpenNotificationWithUserInfo:userInfo];
    // 处理平台推送的消息
    [HinaFocusHelper dealHinaFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
        // TODO 处理打开 URL 消息，--> 请处理 URL
    } customize:^(NSDictionary * _Nonnull customizedDic) {
        // TODO 处理自定义消息，--> 请处理自定义消息
    }];
    completionHandler();  // 系统要求执行这个方法
}

附录

+ trackHinaFocusAppOpenNotificationWithUserInfo:方法详情

//// 埋点“App 打开推送”事件
/// @param userInfo 包含与远程通知相关的信息的字典
+ (void)trackHinaFocusAppOpenNotificationWithUserInfo:(NSDictionary *)userInfo {
    NSMutableDictionary *pushProperties = [NSMutableDictionary dictionary]; // track 字典
    @try { // sf_data
        NSData *jsonData = [userInfo[@"sf_data"] dataUsingEncoding:NSUTF8StringEncoding];
        NSError *error;
        NSDictionary *sfDictionary = [NSJSONSerialization JSONObjectWithData:jsonData options:NSJSONReadingMutableContainers error:&error];
        if (!error && [sfDictionary isKindOfClass:NSDictionary.class]) {
        // 注意：此处数据映射关系仅作为示例，实际开发中需要结合具体业务场景
            pushProperties[@"$sf_msg_id"] = sfDictionary[@"sf_msg_id"]; // SF 消息 id
            pushProperties[@"$sf_plan_id"] = sfDictionary[@"sf_plan_id"];
            pushProperties[@"$sf_audience_id"] = sfDictionary[@"sf_audience_id"];
            pushProperties[@"$sf_plan_strategy_id"] = sfDictionary[@"sf_plan_strategy_id"];
            pushProperties[@"$sf_plan_type"] = sfDictionary[@"sf_plan_type"];
            pushProperties[@"$sf_strategy_unit_id"] = sfDictionary[@"sf_strategy_unit_id"];
            pushProperties[@"$sf_enter_plan_time"] = sfDictionary[@"sf_enter_plan_time"];
            pushProperties[@"$sf_channel_id"] = sfDictionary[@"$sf_channel_id"];
            pushProperties[@"$sf_channel_category"] = sfDictionary[@"sf_channel_category"];
            pushProperties[@"$sf_channel_service_name"] = sfDictionary[@"sf_channel_service_name"];
            if ([sfDictionary[@"sf_landing_type"] isEqualToString:@"LINK"]) { // 打开 URL
                pushProperties[@"$sf_link_url"] = sfDictionary[@"sf_link_url"];
            }
            NSDictionary *customizedParams = sfDictionary[@"customized"];
            if ([customizedParams isKindOfClass:NSDictionary.class]) {
                [pushProperties addEntriesFromDictionary:customizedParams];
            }
        }
    } @catch (NSException *exception) {

    }
    @try { // aps alert
        NSDictionary *apsAlert = userInfo[@"aps"][@"alert"];
        if ([apsAlert isKindOfClass:NSDictionary.class]) {
        // 注意：此处数据映射关系仅作为示例，实际开发中需要结合具体业务场景
            pushProperties[@"$sf_msg_title"] = apsAlert[@"title"]; // 推送标题
            pushProperties[@"$sf_msg_content"] = apsAlert[@"body"]; // 推送内容
        }
        else if ([apsAlert isKindOfClass:NSString.class]) {
            pushProperties[@"$sf_msg_content"] = apsAlert; // 推送内容
        }
    } @catch (NSException *exception) {

    }
    [HinaCloudSDK.sharedInstance track:@"H_AppPushClick" withProperties:pushProperties];
}

+ dealHinaFocusAction:方法详情

/// 处理推送消息，做页面跳转
/// @param userInfo 包含与远程通知相关的信息的字典
/// @param aLink 打开 URL 的回调
/// @param aCustomized 处理自定义消息回调
+ (BOOL)dealHinaFocusAction:(NSDictionary *)userInfo link:(void (^)(NSString * _Nonnull))aLink customize:(void (^)(NSDictionary * _Nonnull))aCustomized {
    @try {
        // 解析 sf_data
        // NSString *jsonString = userInfo[@"sf_data"];
        NSString *jsonString = userInfo[@"_j_data_"];
        NSData *jsonData = [jsonString dataUsingEncoding:NSUTF8StringEncoding];
        NSError *error;
        NSDictionary *sfDictionary = [NSJSONSerialization JSONObjectWithData:jsonData options:NSJSONReadingMutableContainers error:&error];
        if (!sfDictionary || error) {
            return NO;
        }

        NSString *sf_landing_type = sfDictionary[@"sf_landing_type"];
        if ([sf_landing_type isEqualToString:@"LINK"]) {
            // 打开 URL
            NSString *url = sfDictionary[@"sf_link_url"];
            if (aLink) {
                aLink(url);
            }
        }
        else if ([sf_landing_type isEqualToString:@"CUSTOMIZED"]) {
            // 处理自定义消息
            // 如果你们已经有了根据附加字段跳转逻辑，此处无需处理。（因为hina发的推送消息会兼容极光控制台的 "附加字段"）
            NSDictionary *customized = sfDictionary[@"customized"];
            if (aCustomized) {
                aCustomized(customized);
            }
        }
        return YES;
    } @catch (NSException *exception) {

    }
    return NO;
}

附录方法的封装类

如果不想把附录中的示例方法一个个复制到项目中，可以使用封装好的工具类 HinaFocusHelper 来调用示例方法。使用步骤如下：

  1. 下载 HinaFocusHelper 类，解压后复制到项目中
  2. 引入 HinaFocusHelper.h
  3. 调用 HinaFocusHelper 类中的同名方法

附录中 + dealHinaFocusAction: link:customize: 方法需要开发者在 TODO 注释的位置添加上具体的业务跳转逻辑，HinaFocusHelper 类将具体的业务跳转逻辑封装成 block 回调，具体的使用方式请参考以下示例：

    [HinaFocusHelper dealHinaFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
          // TODO 处理打开 URL 消息，--> 请处理 URL
     } customize:^(NSDictionary * _Nonnull customizedDic) {
          // TODO 处理自定义消息，--> 请处理自定义消息
    }];
附件
作者：邓昊  创建时间：2024-11-04 10:30
最后编辑：邓昊  更新时间：2024-11-20 17:38