# App 消息推送

> 神策分析致力于帮助客户搭建开放的数据平台，便于客户更深入的利用数据。本节文档涉及较多技术细节，适用于对相关功能有经验的用户参考。如果对文档内容有疑惑，请咨询您的数据咨询顾问获取一对一的协助。

App 消息推送是一种常用的运营手段，国内已有多家公司向 Android 和 iOS 开发者提供推送服务。神策分析 1.6 版本中提供了如下的方案，以便使用[极光推送](https://www.jiguang.cn)和[小米推送](http://dev.xiaomi.com/console/?page=appservice\&mod=push)等第三方推送服务的开发者，能够将神策分析的分析结果同步到推送服务中，以便向定向的人群推送特定的消息，从而将用户行为分析能力与推送服务结合，提高 App 的运营效果。

开发者将神策分析的结果同步到第三方推送服务的大致步骤如下：

* 开发者在第三方推送平台注册账号、添加应用；
* 在 App 中集成神策分析和第三方推送服务：
  1. 在 App 集成第三方推送平台的 SDK 和神策分析的 SDK，在 App 中获取第三方推送平台的设备推送 ID，并将该 ID 保存在神策分析的用户 Profile 中；
  2. 在 App 中处理推送消息，并使用神策分析追踪推送结果；
* 在神策分析中添加推送相关配置，如 AppKey、保存设备推送 ID 的 Profile 名称等；
* 在神策分析中通过用户分群等功能使用 App 推送。

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr4sELTuWvtjzN9v%2Fapp_push_process.png?generation=1557976818678277\&alt=media)

以下详细说明如何集成第三方推送服务。

## 1. 在 iOS 中集成第三方推送系统

### 1.1 获取设备推送 ID

首先，开发者需要在 App 中集成第三方推送系统的 SDK，并在 App 初始化过程中获取设备推送 ID，并保存在神策分析的用户 Profile 中。以下简要说明集成第三方推送系统的集成方式。

#### 极光推送

开发者请参考极光推送[《iOS SDK 文档》](http://docs.jiguang.cn/jpush/client/iOS/ios_sdk/)，将极光推送的 SDK 集成到 App 中。请参考 [《神策分析 iOS SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/ios_sdk.html) 将神策分析 SDK 集成到 App 中。

在 iOS App 中，获得 APNs 的 Device Token 后，需要向极光推送注册，注册成功后极光推送会推送 `kJPFNetworkDidLoginNotification` 通知，开发者需要监听该通知，并从极光推送中获取 Registration Id：

```objectivec
  // 在 App 初始化成功的回调函数中
  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *) launchOptions {

   // 初始化极光SDK之后，从极光推送获取 Registration Id
    [JPUSHService registrationIDCompletionHandler:^(int resCode, NSString *registrationID) {
        if (resCode == 0) {
            // 将极光推送的 Registration Id 存储在神策分析的用户 Profile "jgId" 中
            [SensorsAnalyticsSDK.sharedInstance profilePushKey:@"jgId" pushId:registrationID];

        }
    }];
  }
  // App 成功获取 APNs 的 Device Token
  - (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

    // 向极光推送注册 Device Token
    [JPUSHService registerDeviceToken:deviceToken];
  }
```

**注意:** 为了保证 Registration Id 能成功绑定到最新的用户上，需要在登录\切换用户时，重新绑定 Registration Id.

```
[[SensorsAnalyticsSDK sharedInstance] login:account];

[JPUSHService registrationIDCompletionHandler:^(int resCode, NSString *registrationID) {
    if (resCode == 0) {
        // 将极光推送的 Registration Id 存储在神策分析的用户 Profile "jgId" 中
        [SensorsAnalyticsSDK.sharedInstance profilePushKey:@"jgId" pushId:registrationID];

    }
}];
```

#### 小米推送

开发者请参考小米推送[《iOS SDK 文档》](https://dev.mi.com/console/doc/detail?pId=98)，将小米推送的 SDK 集成到 App 中。请参考 [《神策分析 iOS SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/ios_sdk.html) 将神策分析 SDK 集成到 App 中。

在 App启动时注册小米推送服务，注册成功后获取 APNs 的 Device Token ,注册时需要添加 MiPushSDKDelegate 协议。

```objectivec
@interface AppDelegate ()<MiPushSDKDelegate,UNUserNotificationCenterDelegate>

@end
```

```objectivec
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    //小米 注册APNS成功, 注册deviceToken
    [MiPushSDK bindDeviceToken:deviceToken];
}
```

实现MiPushSDKDelegate协议中的方法获取regId。

```objectivec
#pragma mark MiPushSDKDelegate
- (void)miPushRequestSuccWithSelector:(NSString *)selector data:(NSDictionary *)data
{
    // 请求成功
    // 可在此获取regId
    if ([selector isEqualToString:@"bindDeviceToken:"]) {
        // 将小米推送的regId 存储在神策分析的用户 Profile "xmId" 中
        [SensorsAnalyticsSDK.sharedInstance profilePushKey:@"xmId" pushId:data[@"regid"]];

    }
}
```

#### 个推

请参考个推[《iOS SDK 文档》](http://docs.getui.com/getui/mobile/ios/overview/)，将个推的 SDK 集成到 App 中。开发者需要将 App 的设备推送 ID 保存在神策分析的用户 Profile 中。神策分析的用户分群等分析功能会使用该设备推送 ID 进行用户关联。请参考 [《神策分析 iOS SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/ios_sdk.html) 将神策分析 SDK 集成到 App 中。

开发者在 `GeTuiSdkDelegate` 的 `- GeTuiSdkDidRegisterClient:` 中获取 clientId 保存在神策分析的用户 Profile 中：

```objectivec
- (void)GeTuiSdkDidRegisterClient:(NSString *)clientId {
    //将 clientId 保存到用户表中的 gtId 中
    [SensorsAnalyticsSDK.sharedInstance profilePushKey:@"gtId" pushId:clientId];

}
```

### 1.2 App 推送效果追踪

开发者可以使用神策分析追踪推送效果。当用户收到推送消息时，通过神策分析 SDK 上报消息推送成功事件，并通过漏斗分析等功能，将用户在推送前的行为和推送后的行为关联起来。

我们可以在 App 中监听第三方消息推送服务的广播，当收到消息时调用神策分析的 `track` 接口记录 App 推送成功事件；当用户点击消息打开 App 或执行其他行为时，调用 `track` 接口记录 App 消息打开事件。

假设 App 推送成功事件的名称为 `AppReceivedNotification`，中文名称为 `App 消息推送成功`，包含事件属性:

* `msg_title` - 消息标题
* `msg_id` - 消息唯一ID

以下简要介绍如何在 App 中记录上述 `App 消息推送成功` 事件，追踪极光推送的推送效果。

**极光推送**

根据极光推送文档所述，需要为AppDelegate添加Delegate，代码如下：

```objectivec
@interface AppDelegate ()<JPUSHRegisterDelegate>

@end
```

用户需要在 AppDelegate.m 中实现以下回调方法并在回调方法中调用神策分析 SDK 追踪推送成功的事件。

```objectivec
// iOS 10 Support
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler {
    // Required
    NSDictionary * userInfo = notification.request.content.userInfo;
    if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }

    // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
    [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                    @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                    @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_j_msgid"]]
                                }];
    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler(UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionSound|UNNotificationPresentationOptionAlert); // 需要执行这个方法，选择是否提醒用户，有Badge、Sound、Alert三种类型可以设置
}
// iOS 10 Support
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    // Required
    NSDictionary * userInfo = response.notification.request.content.userInfo;
    if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }
    // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件

   // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler();  // 系统要求执行这个方法
}
// Required, iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

    [JPUSHService handleRemoteNotification:userInfo];

    if (application.applicationState == UIApplicationStateActive) {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_j_msgid"]]
                        }];
    }
    else if (application.applicationState == UIApplicationStateBackground)
    {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_j_msgid"]]
                            }];
    }
    else if (application.applicationState == UIApplicationStateInactive)
    {
        // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
    }

    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler(UIBackgroundFetchResultNewData);
}
```

**小米推送**

用户需要在 AppDelegate.m 中实现以下回调方法并在回调方法中调用神策分析 SDK 追踪推送成功的事件。

```objectivec
// iOS 10 Support
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    // Required
    NSDictionary * userInfo = notification.request.content.userInfo;
    if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }

    // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
    [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                    @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                    @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                                }];
    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler(UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionSound|UNNotificationPresentationOptionAlert); // 需要执行这个方法，选择是否提醒用户，有Badge、Sound、Alert三种类型可以设置

}
// iOS 10 Support
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    // Required
    NSDictionary * userInfo = response.notification.request.content.userInfo;
    if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }
    // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件

    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler();  // 系统要求执行这个方法
}
// Required, iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

    [JPUSHService handleRemoteNotification:userInfo];

    if (application.applicationState == UIApplicationStateActive) {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                        }];
    }
    else if (application.applicationState == UIApplicationStateBackground)
    {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                            }];
    }
    else if (application.applicationState == UIApplicationStateInactive)
    {
        // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
    }

    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];
    completionHandler(UIBackgroundFetchResultNewData);

}
```

**个推**

用户需要在 AppDelegate.m 中实现以下回调方法并在回调方法中调用神策分析 SDK 追踪推送成功的事件。

```objectivec
// iOS 10 Support
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    // Required
    NSDictionary * userInfo = notification.request.content.userInfo;

    // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
    [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                    @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                    @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                                }];
    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];

    completionHandler(UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionSound|UNNotificationPresentationOptionAlert); // 需要执行这个方法，选择是否提醒用户，有Badge、Sound、Alert三种类型可以设置
}
// iOS 10 Support
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    // Required
    NSDictionary * userInfo = response.notification.request.content.userInfo;

    // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
    [[SensorsAnalyticsSDK sharedInstance] track:@"AppOpenNotification" withProperties:@{
                    @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                    @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                                }];
    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];

    completionHandler();
}
// Required, iOS 7 Support
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

    if (application.applicationState == UIApplicationStateActive) {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                        }];
    }
    else if (application.applicationState == UIApplicationStateBackground)
    {
        // 收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedNotification" withProperties:@{
                        @"msg_title":[NSString stringWithFormat:@"%@",userInfo[@"aps"][@"alert"]],
                        @"msg_id":[NSString stringWithFormat:@"%@",userInfo[@"_id_"]]
                            }];
    }
    else if (application.applicationState == UIApplicationStateInactive)
    {
        // 用户点击通知栏打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
    }

    // 直接上报数据
    [[SensorsAnalyticsSDK sharedInstance] flush];

    completionHandler(UIBackgroundFetchResultNewData);
}

- (void)GeTuiSdkDidReceivePayloadData:(NSData *)payloadData andTaskId:(NSString *)taskId andMsgId:(NSString *)msgId andOffLine:(BOOL)offLine fromGtAppId:(NSString *)appId {
    //收到个推消息
    NSString *payloadMsg = nil;
    if (payloadData) {
        payloadMsg = [[NSString alloc] initWithBytes:payloadData.bytes length:payloadData.length encoding:NSUTF8StringEncoding];
    }
    NSString *msg = [NSString stringWithFormat:@"taskId=%@,messageId:%@,payloadMsg:%@%@",taskId,msgId, payloadMsg,offLine ? @"<离线消息>" : @""];
    NSLog(@"\n>>>[GexinSdk ReceivePayload]:%@\n\n", msg);

    [[SensorsAnalyticsSDK sharedInstance] track:@"AppReceivedGetuiNotification" withProperties:@{@"msg":msg}];
}
```

## 2. 在 Android 中集成第三方推送系统

### 2.1 获取设备推送 ID

首先，开发者需要在 App 中集成第三方推送系统的 SDK，并在 App 初始化过程中获取设备推送 ID，并保存在神策分析的用户 Profile 中。以下简要说明集成第三方推送系统的集成方式。

#### 极光推送

请参考极光推送[《Android SDK 文档》](http://docs.jiguang.cn/jpush/client/Android/android_sdk/)，将极光推送的 SDK 集成到 App 中。开发者需要将 App 的设备推送 ID 保存在神策分析的用户 Profile 中。神策分析的用户分群等分析功能会使用该设备推送 ID 进行用户关联。请参考 [《神策分析 Android SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/android_sdk.html) 将神策分析 SDK 集成到 App 中。

极光推送使用唯一的 Registration Id 标示设备。开发者需要在 Manifest 中定义 Receiver 接受极光推送的广播，通过 `cn.jpush.android.intent.REGISTRATION` 消息获取 Registration Id。

```markup
  <receiver
    android:name="Your Receiver"
    android:enabled="true">
    <intent-filter>
      <action android:name="cn.jpush.android.intent.REGISTRATION" />
      <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />
      <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />
      <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
      <category android:name="You package Name" />
    </intent-filter>
  </receiver>
```

广播 `cn.jpush.android.intent.REGISTRATION` 的 Intent 参数中`JPushInterface.EXTRA_REGISTRATION_ID` 为 Registration Id ，开发者在极光推送初始化完成后，在广播中获取 Registration Id 保存在神策分析的用户 Profile 中：

```java
 public void onReceive(Context context, Intent intent) {
    // 收到极光推送初始化成功的广播
    if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
        // 获取极光推送的 RegistrationId
        final String registrationId = intent.getExtras().getString(JPushInterface.EXTRA_REGISTRATION_ID);
        // 将推送 ID 保存到用户表中
       SensorsDataAPI.sharedInstance().profilePushId("jgId",registrationId);
    }
}
```

**注意：** 由于极光 SDK 只会在第一次初始化成功时，发出 `JPushInterface.ACTION_REGISTRATION_ID` 广播，为确保已安装 App 的老用户也能把推送 ID 保存到神策分析的用户表中，可以在调用 `login` 方法后再次保存推送 ID：

```java
    // 注册成功/登录成功（调用 login 方法）后 保存 jgId 到用户表
    String registrationId=JPushInterface.getRegistrationID(this);
    SensorsDataAPI.sharedInstance().profilePushId("jgId",registrationId);
```

### 小米推送

请参考小米推送服务[《Android SDK 文档》](http://dev.xiaomi.com/doc/?p=544)，将小米推送的 SDK 集成到 App 中。开发者需要将 App 的设备推送 ID 保存在神策分析的用户 Profile 中。神策分析的用户分群等分析功能会使用该设备推送 ID 进行用户关联。请参考 [《神策分析 Android SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/android_sdk.html) 将神策分析 SDK 集成到 App 中。

开发者在小米推送初始化完成后，在广播中获取 Registration Id 保存在神策分析的用户 Profile 中：

```java
@Override
public void onReceiveRegisterResult(Context context, MiPushCommandMessage message) {
    String command = message.getCommand();
    List<String> arguments = message.getCommandArguments();
    String mRegId = ((arguments != null && arguments.size() > 0) ? arguments.get(0) : null);
    if (MiPushClient.COMMAND_REGISTER.equals(command)) {
        if (message.getResultCode() == ErrorCode.SUCCESS) {
            //小米推送初始化成功,将推送 ID 保存到用户表中
            SensorsDataAPI.sharedInstance().profilePushId("xmId",mRegId);
        }
    }
}
```

### 个推

请参考个推[《Android SDK 文档》](http://docs.getui.com/getui/mobile/android/androidstudio_maven)，将个推的 SDK 集成到 App 中。开发者需要将 App 的设备推送 ID 保存在神策分析的用户 Profile 中。神策分析的用户分群等分析功能会使用该设备推送 ID 进行用户关联。请参考 [《神策分析 Android SDK 使用说明》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/android_sdk.html) 将神策分析 SDK 集成到 App 中。

开发者在 GTIntentService 的 onReceiveClientId 中获取 ClientId 保存在神策分析的用户 Profile 中：

```java
    @Override
    public void onReceiveClientId(Context context, String clientid) {
        // 将 clientid 保存到用户表 gtId 中
        SensorsDataAPI.sharedInstance().profilePushId("gtId",clientid);
    }
```

### 2.2 App 推送效果追踪

开发者可以使用神策分析追踪推送效果。当用户收到推送消息时，通过神策分析 SDK 上报消息推送成功事件，并通过漏斗分析等功能，将用户在推送前的行为和推送后的行为关联起来。

我们可以在 App 中监听第三方消息推送服务的广播，当收到消息时调用神策分析的 `track` 接口记录 App 推送成功事件；当用户点击消息打开 App 或执行其他行为时，调用 `track` 接口记录 App 消息打开事件。

假设 App 推送成功事件的名称为 `AppReceivedNotification`，中文名称为 `App 消息推送成功`，包含事件属性:

* `msg_title` - 消息标题
* `msg_id` - 消息唯一ID

以下简要介绍如何在 App 中记录上述 `App 消息推送成功` 事件，追踪极光推送的推送效果。

#### 极光推送

如极光推送文档所述，用户需要在 Receiver 中处理极光推送的广播，并在收到消息时使用神策分析 SDK 追踪推送成功的事件。

```java
 public void onReceive(Context context, Intent intent) {
    if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
        // 极光推送注册成功通知，如前文所述，获得 Registration Id 并保存在神策分析的用户 Profile 中
    } else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
        // 用户收到了自定义消息，自定义消息不会展示在通知栏，只透传给 App
    } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
        // 用户收到了推送消息，使用神策分析追踪 "App 消息推送成功" 事件
        Bundle message = intent.getExtras();
        try {
            JSONObject properties = new JSONObject();
            // 获取消息标题，并保存在事件属性 msg_title 中
            properties.put("msg_title", message.getString(JPushInterface.EXTRA_NOTIFICATION_TITLE));
            // 获取消息 ID，并保存在事件属性 msg_id 中
            properties.put("msg_id", message.getString(JPushInterface.EXTRA_MSG_ID));
            // 使用神策分析追踪 "App 消息推送成功" 事件
            SensorsDataAPI.sharedInstance().track("AppReceivedNotification", properties);
        } catch (InvalidDataException e) {
            e.printStackTrace();
        } catch (JSONException e) {
            e.printStackTrace();
        }
    } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
        // 用户点击打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
    }
}
```

#### 小米推送

如小米推送文档所述，用户需要在 Receiver 中处理小米推送的广播，并在收到消息时使用神策分析 SDK 追踪推送成功的事件。

```java
@Override
public void onNotificationMessageArrived(Context context, MiPushMessage message) {
    try {
        JSONObject properties = new JSONObject();
        // 获取消息标题，并保存在事件属性 msg_title 中
        properties.put("msg_title", message.getTitle());
        // 获取消息 ID，并保存在事件属性 msg_id 中
        properties.put("msg_id", message.getMessageId());
        // 使用神策分析成功" 事件
        SensorsDataAPI.sharedInstance().track("AppReceivedNotification", properties);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

@Override
public void onNotificationMessageClicked(Context context, MiPushMessage message) {
    // 用户点击打开消息，使用收到推送消息类似的方法，使用神策分析记录 "App 打开消息" 事件
}

@Override
public void onReceivePassThroughMessage(Context context, MiPushMessage message) {
   // 用户收到了自定义消息，自定义消息不会展示在通知栏，只透传给 App
}
```

#### 个推

如个推文档所述，用户需要在 GTIntentService 中处理推送消息，可以在透传消息到达时使用神策分析 SDK 追踪消息到达事件。

```java
    @Override
    public void onReceiveMessageData(Context context, final GTTransmitMessage gtTransmitMessage) {
        try {
            JSONObject properties = new JSONObject();
            // 获取消息 ID，并保存在事件属性 msg_id 中
            properties.put("msg_id", gtTransmitMessage.getMessageId());
            // 追踪 "消息到达" 事件
            SensorsDataAPI.sharedInstance().track("AppReceivedNotification", properties);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
```

## 3. 在神策分析中使用推送服务(以极光推送为例)

### 3.1 填写推送配置

开发在第三方推送平台注册了 App 后，使用管理员账户进入神策分析的推送服务管理界面。

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5QGkAcePfiDpUx%2Fapp_push_0.png?generation=1557976819191066\&alt=media)

新建推送服务，选择第三方推送服务商，填入 App Key、Secret Key 等配置信息，特别地，开发者需要填写保存设备推送 ID 的 Profile 名称，如前文的例子中，我们在 `jgId` 中保存极光推送 Android App 的设备推送 ID。

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5VxMI9ImhNZiY0%2Fapp_push_1.png?generation=1557976818651171\&alt=media)

成功添加推送服务后，将可以使用该推送配置，在用户分群、留存用户分析等分析功能中使用消息推送功能。

### 3.2 用户分群

在神策分析中，可以按照用户的事件所体现的过往的行为特征和用户的 Profile 所体现的用户自然属性特征，来对整个用户群体进行分群。开发者可以根据分群结果，对群体中的用户推送消息。如图，当用户编辑用户分群规则时，勾选推送渠道：

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5XibqqAtuu9bBK%2Fapp_push_2.png?generation=1557976809090522\&alt=media)

当用户分群执行成功后，会自动在第三方推送渠道中为满足分群条件的用户标记 Tag，Tag 名称为用户分群的**英文名**。特别地，当开发者拥有多款 App 的多个推送渠道时，可以同时将推送结果同步到多个推送渠道的 Tag 中。

### 3.3 第三方推送平台进行消息推送

开发者可以在第三方推送系统的后台，使用用户分群的英文名对应的 Tag 进行消息推送，例如在极光推送中：

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5ZyU9Juzua_6q9%2Fapp_push_3.png?generation=1557976809014230\&alt=media)

更多关于如何使用神策分析用户分群，可以参考文档[《用户分群》](https://github.com/hxxiaolong/wendang/tree/32bdd85c96b118df803b5923753b4f1908489069/user_segmentation.html)。

### 3.4 用户列表

在神策分析的各种数据分析功能中，都可以根据分析结果获取对应的用户列表，如留存分析中，开发者可以获得第一天留存的用户列表：

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5avSaaMZrHZSxq%2Fapp_push_4.png?generation=1557976818031793\&alt=media)

在用户列表中，可以根据用户列表的生成规则创建用户分群，此时我们也可以为该分群配置消息推送：

![](https://3928609189-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Levm4x0IpHBx6dxiaCM%2F-LeydYULqjq7WfRLX0IT%2F-Leydr5crMA-gTjfF25U%2Fapp_push_5.png?generation=1557976817595517\&alt=media)

进而，在用户分群执行成功后，开发者可以在第三方推送系统的后台使用用户分群的英文名对应的 Tag 进行消息推送。

## 4. 推送效果追踪

如前文所述，开发者在 App 中集成第三方消息推送服务后，可以使用神策分析追踪推送效果。我们对一些常用的推送效果分析，做简单的介绍。

#### 统计推送成功的用户数

可以直接在事件分析中，统计 `App 消息推送成功` 事件的触发用户数，并筛选对应的消息唯一 ID 属性。

#### 分析推送成功的用户的转化

想查看某一段时间内，推送成功的用户的转化，可以在漏斗分析中新建漏斗，第一个步骤为 `App 消息推送成功`，第二个步骤为下订单等行为。

#### 分析推送成功的用户的留存

想查看某一段时间内，推送成功的用户的留存，可以在留存分析中，把初始行为设置为 `App 消息推送成功`，后续行为设置为 `任意事件`，或者某个表示用户留存的核心行为。