iOS 推送集成
|
收藏
极光推送
上报推送 ID
为了保证登录之后的用户也能设置 registrationID 属性,需要在 - registrationIDCompletionHandler: 回调和调用神策 - login: 接口之后,各上报一次 registrationID。
// 神策 SDK 初始化之后,在极光回调中上报 registrationID
[JPUSHService registrationIDCompletionHandler:^(int resCode, NSString *registrationID) {
// 将 registrationID 保存到神策用户表的 jiguang_id 字段中(这⾥的 jiguang_id 只是一个示例字段)
[[SensorsAnalyticsSDK sharedInstance] set:@"jiguang_id" to:registrationID];
}];
// login 之后,再次上报 registrationID
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK 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];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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];
}
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
友盟推送
上报 deviceToken
为了保证登录之后的用户也能设置 deviceToken 属性,需要在获取到 deviceToken 时和调用神策 -login: 接口之后,各上报一次 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 只是一个示例字段)
[[SensorsAnalyticsSDK sharedInstance] set:@"umeng_id" to:hexToken];
/**
* 将 hexToken 进行缓存
*/
}
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
// 为了保证登录后的用户也能正确设置 deviceToken,调用 login 之后,需要再次上报。
NSString *hexToken = <#取出之前缓存的 hexToken#>
[[SensorsAnalyticsSDK sharedInstance] set:@"umeng_id" to:hexToken];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[UMessage didReceiveRemoteNotification:userInfo];
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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]]) {
[UMessage didReceiveRemoteNotification:userInfo];
}
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
个推推送
上报推送 ID
为了保证登录之后的用户也能设置 clientId 属性,需要在 GeTuiSdkDelegate 协议方法 GeTuiSdkDidRegisterClient: 和调用神策 - login: 接口之后,各上报一次 clientId。
- (void)GeTuiSdkDidRegisterClient:(NSString *)clientId {
// 将clientId 保存到用户表的 getui_id 字段中(这里的 getui_id 只是一个示例字段)
[[SensorsAnalyticsSDK sharedInstance] set:@"getui_id" to:clientId];
}
// 为了保证登录后的用户也能正确设置 clientId,调用 login 之后,再次上报 clientId
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"getui_id" to:GeTuiSdk.clientId];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// [ GTSdk ]:将收到的APNs信息传给个推统计
[GeTuiSdk handleRemoteNotification:userInfo];
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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];
}
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
阿里云推送
上报推送 ID
为了保证登录之后的用户也能设置 deviceId 属性,需要在 CloudPushSDK 初始化方法回调以及调用神策 - login: 接口之后,各上报一次 deviceId。
// 阿里云推送 SDK 初始化
[CloudPushSDK asyncInit:@"*****" appSecret:@"*****" callback:^(CloudPushCallbackResult *res) {
if (res.success) {
NSLog(@"Push SDK init success, deviceId: %@.", [CloudPushSDK getDeviceId]);
// 将 deviceId 保存到用户表的 aliyun_id 字段中(这里的 aliyun_id 只是一个示例字段)
[[SensorsAnalyticsSDK sharedInstance] set:@"aliyun_id" to:[CloudPushSDK getDeviceId]];
} else {
NSLog(@"Push SDK init failed, error: %@", res.error);
}
}];
// 为了保证登录后的用户也能正确设置 deviceId,调用 login 之后,再次上报 deviceId
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"aliyun_id" to:[CloudPushSDK getDeviceId]];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// 上报通知点击事件
[CloudPushSDK sendNotificationAck:userInfo];
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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]]) {
// 上报通知点击事件
[CloudPushSDK sendNotificationAck:userInfo];
}
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
华为推送
上报推送 ID
为了保证登录之后的用户也能设置华为推送的 device token 属性,需要在获取到原始的 device token 时按照华为官方文档处理(参考华为官方文档)下然后上报, 之后再调用神策 - login: 接口之后再上报一次。
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// 参考华为官方文档处理下 deviceToken
NSString *deviceTokenString = "按照华为官方文档处理下获取到的一个字符串";
NSString *hmsDeviceToken = [[HmsInstanceId getInstance] getToken:deviceTokenString];
[[SensorsAnalyticsSDK sharedInstance] set:@"hms_id" to:hmsDeviceToken]; // hms_id 只是一个示例字段
}
// 为了保证登录后的用户也能正确设置 device token,调用 login 之后,再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"hms_id" to:hmsDeviceToken];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// 上报通知点击事件
[[EventReport getInstance] reportPushMsgClickEvent:userInfo];
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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]]) {
// 上报通知点击事件
[[EventReport getInstance] reportPushMsgClickEvent:userInfo];
}
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
FCM 推送
上报推送 ID
为了保证登录之后的用户也能设置 device token 属性,需要在获取到 device token 后再调用神策 - login: 接口之后再上报一次。
extension AppDelegate: MessagingDelegate {
func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
guard let fcmPushId = fcmToken else {
return
}
SensorsAnalyticsSDK.sharedInstance()?.set("FCM_id", to: fcmPushId) // FCM_id 只是一个示例字段
}
}
// 为了保证登录后的用户也能正确设置 device token,调用 login 之后,再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"FCM_id" to:deviceTokenString];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// 上报通知点击事件
[[EventReport getInstance] reportPushMsgClickEvent:userInfo];
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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]]) {
// 上报通知点击事件
[[EventReport getInstance] reportPushMsgClickEvent:userInfo];
}
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
APNs 推送
上报推送 ID
为了保证登录之后的用户也能设置 device token 属性,需要在获取到 device token 以及调用神策 - login: 接口各上报一次。
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// 将 deviceToken 转为化字符串,建议转为为 hex
NSString *deviceTokenString = "转化后的字符串";
[[SensorsAnalyticsSDK sharedInstance] set:@"apns_id" to:deviceTokenString]; // apns_id 只是一个示例字段
}
// 为了保证登录后的用户也能正确设置 device token,调用 login 之后,再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"apns_id" to:deviceTokenString];
记录 「推送打开」事件并处理智能运营平台推送的消息
// iOS10 一下版本,iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction: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;
// 记录 推送打开 事件
[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
// 处理平台推送的消息
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
completionHandler(); // 系统要求执行这个方法
}
UniPush 推送
上报推送 ID
为了保证登录之后的用户也能设置 cid 属性,需要在获取到 cid 以及调用神策 - login: 接口各上报一次。由于 UniPush 目前有 1.0 和 2.0 两个版本,下面以 2.0 版本来说明,1.0 版本的 请参考 DCloud 官网文档。
uni.getPushClientId({
success: (res) => {
let cid = res.cid;
sensors.setProfile({ "uni-id": cid }); // uni_id 只是一个示例字段
},
fail(err) {
console.log(err);
}
});
// 为了保证登录后的用户也能正确设置 cid,调用 login 之后,再次上报 cid
sensors.login("<#登录 id#>");
sensors.setProfile({"uni-id":cid});
记录 「推送打开」事件并处理智能运营平台推送的消息
uni.onPushMessage((result) => {
let data = result.data;
if (typeof data !== "string") {
let sf_data = data.payload.sf_data;
//记录推送事件,此处需参考 trackSensorsFocusAppOpenNotificationWithUserInfo 中的 json 解析逻辑赋值事件属性
let sf_properties = {};
sf_properties.$sf_plan_id = sf_data.sf_plan_id;
...
sensors.track("$AppPushClick", sf_properties);
// 根据解析的字段,发现跳转 url 然后进行跳转操作
}
});
测试推送
- 首先发送推送 ID 到神策后,选择上报推送 ID 的 key(这里以 jiguang_id 为例),点击测试推送。
- 填入测试机的推送 ID、推送标题、内容,如下图所示。
- 确认推送,可查看手机是否收到推送,以及查看埋点上报字段是否正确。
附录
+ trackSensorsFocusAppOpenNotificationWithUserInfo: 方法详情
/**
* 埋点“App 打开推送”事件。
*
* @param userInfo 包含与远程通知相关的信息的字典
*/
+ (void)trackSensorsFocusAppOpenNotificationWithUserInfo:(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) {
}
[SensorsAnalyticsSDK.sharedInstance track:@"$AppPushClick" withProperties:pushProperties];
}
+ dealSensorsFocusAction: link:customize: 方法详情
/// 神策智能运营处理推送消息,做页面跳转
/// @param userInfo 包含与远程通知相关的信息的字典
/// @param aLink 打开 URL 的回调
/// @param aCustomized 处理自定义消息回调
+ (BOOL)dealSensorsFocusAction:(NSDictionary *)userInfo link:(void (^)(NSString * _Nonnull))aLink customize:(void (^)(NSDictionary * _Nonnull))aCustomized {
@try {
// 解析 sf_data
NSString *jsonString = userInfo[@"sf_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"]) {
// 处理自定义消息
// 如果你们已经有了根据附加字段跳转逻辑,此处无需处理。(因为神策智能运营发的推送消息会兼容极光控制台的 "附加字段")
NSDictionary *customized = sfDictionary[@"customized"];
if (aCustomized) {
aCustomized(customized);
}
}
return YES;
} @catch (NSException *exception) {
}
return NO;
}
附录方法的封装类
如果不想把附录中的示例方法一个个复制到项目中,可以使用封装好的工具类 SensorsFocusHelper 来调用示例方法。使用步骤如下:
- 下载 SensorsFocusHelper 类,解压后复制到项目中
- 引入 SensorsFocusHelper.h
- 调用 SensorsFocusHelper 类中的同名方法
附录中 + dealSensorsFocusAction: link:customize: 方法需要开发者在 TODO 注释的位置添加上具体的业务跳转逻辑,SensorsFocusHelper 类将具体的业务跳转逻辑封装成 block 回调,具体的使用方式请参考以下示例:
[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
// TODO 处理打开 URL 消息,--> 请处理 URL
} customize:^(NSDictionary * _Nonnull customizedDic) {
// TODO 处理自定义消息,--> 请处理自定义消息
}];
注:本文档内容为神策产品使用和技术细节说明文档,不包含适销类条款;具体企业采购产品和技术服务内容,以商业采购合同为准。