APP消息推送
1. 概述
DM Hub 支持全渠道客户数据收集，手机 App 作为其中一个重要的渠道，不仅可以通过埋点接入手机 App 相关数据，同时也支持个性化消息推送，即在 App 平台开通消息推送服务，在 DM Hub 后台完成应用配置后即可直在系统中进行消息编辑、推送和管理。 在 DM Hub 内设置 APP 消息推送前，需先开通极光推送服务或准备自己的推送服务。
2.如何配置 APP 应用
功能入口：设置-系统设置-营销触点-App 消息推送
2.1 极光配置说明
2.1.1 查看配置信息
登录极光开发者控制台，创建应用并查看应用信息。
参考极光官方文档
2.1.2DM Hub 后台配置
从极光后台获取了 AppKey 和 Master Secret 后填入到 DM Hub 中，也需要设置一个合适的应用名称方便管理。一旦设置完毕，
请勿在在极光推送控制台中切勿随意修改 Master Secret, 一旦 Master Secret 在极光推送控制台被修改, 请及时在此处更新设置。
在设置中心进入 APP 消息推送设置，在【应用管理-极光】中，点击右上角【绑定 APPKey】，输入“应用名称”、“AppKey”、“Master Secret”，确认即可。
添加好应用后，在应用列表中可以看到该应用的状态，状态为绿色对勾说明绑定成功。
2.2 添加其他插件应用
2.2.1 基础配置
如果您的 APP 推送应用是其他平台或插件，需先创建好 AppKey 和 Master Secret，然后在此处绑定。 应用名称和 AppKey 固定，其余信息放入 pluginMeta。
在控制台中切勿随意修改 Master Secret, 一旦 Master Secret 在控制台被修改, 请及时在此处更新设置。
2.2.2 新增 pluginMeta 信息，
pluginMeta 信息格式示例（标准个推插件为例）：
{
"channel": {
"provider": "getui",
"providerLabel": "个推",
"appId": "",
"masterSecret": ""
},
"broadcastSetting": {
"url": "http://192.168.33.170:30000/extapppush",
"authType": "none",
"appId": "",
"appSecret": ""
},
"clabapp": {
"url": "https://api.dmhub.cn",
"appId": "",
"secret": ""
},
"ui": [
{
"name": "style",
"label": "展示样式",
"type": "string",
"displayType": "radio",
"options": [
{
"key": "getui",
"label": "个推默认"
},
{
"key": "android",
"label": "安卓原生"
}
],
"value": "getui"
},
{
"name": "isOffline",
"label": "支持离线推送",
"type": "bool",
"displayType": "switch",
"value": false
},
{
"name": "offlineExpireTime",
"label": "离线存储时长(小时)",
"value": 24,
"type": "number",
"min": 1,
"max": 72,
"description": "该时间段内上线过的客户均可收到通知(0-72小时内的正整数)",
"dependsOn": [
{
"key": "isOffline",
"value": true
}
]
},
{
"name": "remindingType",
"label": "提醒方式",
"type": "array",
"displayType": "checkbox",
"options": [
{
"key": "ring",
"label": "响铃"
},
{
"key": "vibrate",
"label": "震动"
}
]
}
]
}
2.2.3channel 说明
| 字段 | 说明 |
|---|---|
| provider | 用于从 app_notification_identity 表查询 pushId |
| providerLabel | 推送身份会显示在客户身份下面，要显示的推送渠道，如果缺失则展示插件 |
| appId、masterSecret 等信息 | 插件服务所需，用于调用推送服务商 |
2.2.4broadcastSetting 说明
| 字段 | 说明 |
|---|---|
| url | 插件服务 url，用于 sms 服务调用插件服务 |
| authType | 鉴权方式，支持 none/default/aliapp |
| appId、appSecret | 鉴权所需信息 |
2.2.5clabapp 说明
| 字段 | 说明 |
|---|---|
| url | DMHub open api url，用于插件服务上传发送事件、群发报告等信息 |
| appId、secret | DMHub open api appId、secret |
2.2.6ui meta 数据结构定义参考
插件渠道绑定 AppKey 接口 requestBody：
{
"name": "",
"appKey": "",
"provider": "plugin",
"pluginMeta": "json字符串"
}
3.App 数据接入
设置完 AppKey 和 Master Secret 并不等同于接入了 App 的客户数据，所以要实现消息发送，还必须通过埋点接入客户数据。
3.1iOS SDK
3.2Android SDK
接入数据后，可在系统中客户—高级筛选—APP 消息推送中筛选支持消息推送的客户。支持三种条件筛选：推送渠道（个推和极光），操作系统（Android 和 iOS），推送应用（接入的应用）
点击查找出的支持消息推送的客户进入客户详情，可以在【客户身份】中看到客户的 App 消息推送 ID。
App 消息推送 ID 并非客户身份，一个客户可以有多个相同推送渠道相同应用的推送 id。
4.新建消息
完成应用绑定并接入了客户后，可以对客户进行消息推送。点击【应用与市场-已安装应用-APP 消息推送】可以进入消息列表。
如关联了多个应用，可以点击右上方切换应用，然后新建消息。
4.1 新建极光推送
极光推送消息字段配置如下：
消息形式：
通知消息：
通知（Notification），指在手机的通知栏（状态栏）上会显示的一条通知信息。这是 Android / iOS 的基本功能。
通知主要用于提示用户。一条通知，简单的填写纯文本的通知内容即可。
应用加上通知功能，有利于提高应用的活跃度。
自定义消息：
自定义消息不是通知，默认不会被 SDK 展示到通知栏上，极光推送仅负责透传给 SDK。其内容和展示形式完全由开发者自己定义。
自定义消息主要用于应用的内部业务逻辑和特殊展示需求。
消息类型：选择营销类或通知类（应用平台本身不区分消息类型，这里的设置区分只是为了系统里面做消息防骚扰）；
消息名称：仅用作 DM Hub 内部记录识别，不在用户接收到的消息推送中显示；
关联营销活动：需现在互动-营销活动功能创建一个活动，营销活动的功能使用参考（补链接）
消息标题：显示在用户手机通知栏的消息标题
消息内容：显示在通知栏的消息正文，消息正文支持插入客户属性和会员属性作为变量，如下图，选择的微信昵称，收到消息时就会显示实际的昵称；
pushID 类型：DM Hub 支持两种极光推送目标-Register_id、alias（别名），请确认使用的是哪种类型的推送目标。如果要从 Register_id 切换到 alias， 需谨慎切换，切换 pushid 类型前，请先确认已经通过 api 接口，将已有用户的 register_id 身份进行了注销，并重新分配了 alias id。否则 register_id 和 alias id 同时存在，会影响 app push 触达。
来源追踪：若勾选，消息中将额外记录以下信息分别用于标识来源和营销活动"cl_sr" : "App Push"，"cl_cp" : //关联的营销活动
内容中支持插入变量和动态文本
- 插入变量
App Push 消息内容支持插入变量。变量类型支持客户属性、值标签、上下文事件，可在【为空时显示】处设置默认值。用户收到插入变量的 APP Push 时，变量内容会自动显示为 DM Hub 系统中记录的用户相关信息。
上下文事件属性需要确定对应的事件才可以取到事件的属性值，并不是插入群发就可以取值的，必须结合自动流中的“APP Push”组件，选择上下文事件才可以取值发送。
例：在 APP 消息中插入购买商品和服务事件中的订单号
- 插入动态文本
插入动态文本，APP 消息内容可根据不同规则显示特定的内容。如性别等于女，则显示女士。应用场景非常广，比如城市等于上海，显示优惠券满 100 减 20，城市等于广州，显示优惠券满 60 减 10 等。
目前支持通过客户属性、会员属性进行规则设置。
点击高级设置，可设置以下字段：
附加信息：可以设置“键值对”来自定义更多附加信息，可支持客户属性、值标签、上下文事件，可在【为空时显示】处设置默认值。用户收到插入变量的 APP Push 时，变量内容会自动显示为 DM Hub 系统中记录的用户相关信息。App 可以依次作后续消息交互和处理（如果消息类型为自定义消息，那就是事先与 App 约定好消息的展现形式，App 接收到推送的“键值对”后直接按规则呈现）极光参考文档
安卓用户还可以设置以下信息
厂商通道状态：可选通道有 vivo 通道、华为通道、小米通道、OPPO 通道、FCM 通道、魅族通道；
通知下发策略：厂商通道优先，厂商通道无效时走极光通道；仅通过极光通道下发；极光通道优先，若用户离线则通过厂商下发
此功能为极光应用的 vip 功能，请确认已开通 vip 服务并且开通对应厂商通道
通知提醒类型设置：开发者可勾选对应的项来指定通知送达时在手机上的提醒类型。但不能越过系统的限制，比如手机的声音要是开着的，振动是允许的，有 LED 指示灯并且是可开启的状态。（在 JPush Android SDK 3.0.3 及以后版本生效。）
提示音自定义：需要播放的铃声文件名，无需传递文件后缀，铃声文件放在 Android 工程的/res/raw 目录下。针对 Android8.0 以上，当传递了 channel_id 时，此属性不生效。
点击通知自定义：打开指定页面 打开指定页面有两种方式
1、填写完整的包名和 Activity，具体格式为：
intent:#Intent;component=com.jiguang.push/com.example.jpushdemo.SettingActivity;end
2、客户端 Activity 在 manifest 配置为：
<activity android:name=".MyActivity" android:exported="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:scheme="app" android:host="example" android:path="/MyActivity/" />
</intent-filter>
</activity>
填写的路径为：app://example/MyActivity/
4.2 新建其它插件应用消息
以个推为例，个推推送消息设置与极光消息类似，除消息类型、名称、标题，内容、来源追踪、附加字段等，个推还支持以下设置：
展示样式：可选择个推默认（通知栏的消息内容可以展示两行）或安卓原生（通知栏的消息内容仅支持展现一行）；
支持离线推送：若打开该开关，可设置 0-72 小时内的整数离线存储时长，即使消息推送时用户的 APP 处于离线状态，该时间段内上线的客户均可收到推送通知；
5.推送消息
5.1 群发
消息创建后即可在 APP 消息列表中展现，点击【发送】按钮，设置发送对象和发送时间即可群发：
发送对象：所有 App 用户将发送给所有安装了该 app 的用户；部分 App 用户需选择消息发送群组；匿名 App 用户将发送给安装了 App 但没有注册的用户（在 DM Hub 也没有相关的客户数据，此类用户便是匿名用户）。
发送时间：可以选择立即发送或者定时发送。
如设置了定时发送，可在【计划中的定时群发】中查看，在定时发送时间之前可以修改发送时间或取消发送。
5.1.2 查看群发数据
在【群发记录】中可查看所有群发任务列表及群发状态。
消息发送之后，可以在【APP 消息列表】的群发记录下看到群发次数，点击【已群发 XX 次】可查看发送记录明细，包含发送批次、发送对象、发送时间和发送数，送达率、点击率等。
5.2 自动流触发
自动流中直接选择 App 消息组建，选择设置好的消息内容进行发送。自动流详细操作步骤参考自动流程
5.3 行为记录
在时间轴中会记录系统发送手机应用通知、发送手机应用通知成功、收到手机应用通知、点击手机应用通知等事件。利用这些事件，可以在高级筛选中进行客户筛选。
