极光推送

上报推送 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];
}];

OBJECTIVE-C

// login 之后，再次上报 registrationID
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"jiguang_id" to:registrationID];

OBJECTIVE-C

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

//  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();  // 系统要求执行这个方法
}

OBJECTIVE-C

友盟推送

上报 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 进行缓存
	 */
}

OBJECTIVE-C

[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];

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

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

个推推送

上报推送 ID

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

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

OBJECTIVE-C

// 为了保证登录后的用户也能正确设置 clientId，调用 login 之后，再次上报 clientId
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"getui_id" to:GeTuiSdk.clientId];

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

阿里云推送

上报推送 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:[NSString stringWithFormat:@"ios_%@",[CloudPushSDK getDeviceId]]];
    } else {
        NSLog(@"Push SDK init failed, error: %@", res.error);
    }
}];

OBJECTIVE-C

// 为了保证登录后的用户也能正确设置 deviceId，调用 login 之后，再次上报 deviceId
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"aliyun_id" to:[NSString stringWithFormat:@"ios_%@",[CloudPushSDK getDeviceId]]];

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

腾讯云推送

上报推送 ID

实现 XGPushDelegate 协议，获取 xgToken 并上报，示例代码如下：

- (void)xgPushDidRegisteredDeviceToken:(nullable NSString *)deviceToken xgToken:(nullable NSString *)xgToken error:(nullable NSError *)error {
  [[SensorsAnalyticsSDK sharedInstance] set:@"tencent_id" to:[NSString stringWithFormat:@"ios_%@",xgToken]];
}

JS

// 为了保证登录后的用户也能正确设置 xgToken，调用 login 之后，再次上报 xgToken
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"tencent_id" to:[NSString stringWithFormat:@"ios_%@",[[XGPushTokenManager defaultTokenManager] xgTokenString]]];

JS

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

- (void)xgPushDidReceiveNotificationResponse:(nonnull id)response withCompletionHandler:(nonnull void (^)(void))completionHandler {
    NSDictionary *userInfo;
    if ([response isKindOfClass:[UNNotificationResponse class]]) {
        userInfo = ((UNNotificationResponse *)response).notification.request.content.userInfo;
    } else if ([response isKindOfClass:[NSDictionary class]]) {
        userInfo = (NSDictionary *)response;
    }
    if (![userInfo isKindOfClass:[NSDictionary class]]) {
        return;
    }
    NSString *custom = userInfo[@"custom"];
    NSData *customData = [custom dataUsingEncoding:NSUTF8StringEncoding];
    NSError *error;
    NSDictionary *customDic = [NSJSONSerialization JSONObjectWithData:customData options:NSJSONReadingMutableContainers error:&error];
    userInfo = customDic;
    // 记录 推送打开 事件
	[SensorsFocusHelper trackSensorsFocusAppOpenNotificationWithUserInfo:userInfo];
    // 处理平台推送的消息
	[SensorsFocusHelper dealSensorsFocusAction:userInfo link:^(NSString * _Nonnull urlString) {
        // TODO 处理打开 URL 消息，--> 请处理 URL
    } customize:^(NSDictionary * _Nonnull customizedDic) {
        // TODO 处理自定义消息，--> 请处理自定义消息
    }];
    completionHandler();
}

CODE

华为推送

上报推送 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 只是一个示例字段
}

OBJECTIVE-C

// 为了保证登录后的用户也能正确设置 device token，调用 login 之后，再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"hms_id" to:hmsDeviceToken];

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

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 只是一个示例字段
    }
}

OBJECTIVE-C

// 为了保证登录后的用户也能正确设置 device token，调用 login 之后，再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"FCM_id" to:deviceTokenString];

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

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 只是一个示例字段
}

OBJECTIVE-C

// 为了保证登录后的用户也能正确设置 device token，调用 login 之后，再次上报 device token
[[SensorsAnalyticsSDK sharedInstance] login:<#登录 ID#>];
[[SensorsAnalyticsSDK sharedInstance] set:@"apns_id" to:deviceTokenString];

OBJECTIVE-C

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

// 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();  // 系统要求执行这个方法
}

OBJECTIVE-C

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);
  }
});

JS

// 为了保证登录后的用户也能正确设置 cid，调用 login 之后，再次上报 cid
sensors.login("<#登录 id#>");
sensors.setProfile({"uni-id":cid});

JS

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

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 然后进行跳转操作
  }
});

JS

测试推送

首先发送推送 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];
}

OBJECTIVE-C

+ 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;
}

OBJECTIVE-C

附录方法的封装类

如果不想把附录中的示例方法一个个复制到项目中，可以使用封装好的工具类 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 处理自定义消息，--> 请处理自定义消息
}];

OBJECTIVE-C

极光推送

上报推送 ID

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

友盟推送

上报 deviceToken

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

个推推送

上报推送 ID

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

阿里云推送

上报推送 ID

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

腾讯云推送

上报推送 ID

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

华为推送

上报推送 ID

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

FCM 推送

上报推送 ID

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

APNs 推送

上报推送 ID

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

UniPush 推送

上报推送 ID

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

测试推送

附录

+ trackSensorsFocusAppOpenNotificationWithUserInfo: 方法详情

+ dealSensorsFocusAction: link:customize: 方法详情

附录方法的封装类

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

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

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

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

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

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

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

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

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