海纳嗨数-帮助中心
iOS推送集成
极光推送
上报推送 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 来调用示例方法。使用步骤如下:
- 下载 HinaFocusHelper 类,解压后复制到项目中
- 引入 HinaFocusHelper.h
- 调用 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-08 10:38
最后编辑:邓昊 更新时间:2024-11-08 10:38