Version: 简体中文

APP消息推送

1.概述#

DM Hub支持全渠道客户数据收集，手机App作为其中一个重要的渠道，不仅可以通过埋点接入手机App相关数据，同时也支持个性化消息推送，即在App平台开通消息推送服务，在DM Hub后台完成应用配置后即可直在系统中进行消息编辑、推送和管理。

2.如何配置APP应用#

功能入口：设置中心-营销触点-App消息推送

2.1极光配置说明#

2.1.1查看配置信息#

登录极光开发者控制台，创建应用并查看应用信息。参考极光官方文档

2.1.2DM Hub后台配置#

从极光后台获取了AppKey和Master Secret后填入到DM Hub中，也需要设置一个合适的应用名称方便管理。一旦设置完毕，

请勿在在极光推送控制台中切勿随意修改Master Secret, 一旦Master Secret 在极光推送控制台被修改, 请及时在此处更#

新设置。

添加好应用后，可以点击『更新AppKey状态』以查看是否成功添加。

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。

caution

App消息推送ID并非客户身份，一个客户可以有多个相同推送渠道相同应用的推送id。

4.新建消息#

如关联了多个应用，可以点击右上方切换应用，然后新建消息。

4.1新建极光推送#

极光推送消息字段配置如下：

消息类型：选择营销类或通知类（应用平台本身不区分消息类型，这里的设置区分只是为了系统里面做消息防骚扰）；

消息名称：仅用作DM Hub内部记录识别，不在用户接收到的消息推送中显示；

关联营销活动：需现在互动-营销活动功能创建一个活动，营销活动的功能使用参考（补链接）

消息标题：显示在用户手机通知栏的消息标题

消息内容：显示在通知栏的消息正文，消息正文支持插入客户属性和会员属性作为变量，如下图，选择的微信昵称，收到消息时就会显示实际的昵称；

来源追踪：若勾选，消息中将额外记录以下信息分别用于标识来源和营销活动"cl_sr" : "App Push"，"cl_cp" : //关联的营销活动

内容中支持插入变量和动态文本

插入变量

App Push消息内容支持插入变量。变量类型支持客户属性、值标签、上下文事件，可在【为空时显示】处设置默认值。用户收到插入变量的APP Push时，变量内容会自动显示为DM Hub系统中记录的用户相关信息。

注意：上下文事件属性需要确定对应的事件才可以取到事件的属性值，并不是插入群发就可以取值的，必须结合自动流中的“APP Pusa”组件，选择上下文事件才可以取值发送。

例：在APP消息中插入购买商品和服务事件中的订单号

注意：插入上下文事件属性必须通过自动流回复该消息，且要在回复组件中选择对应的上下文事件才可以生效。

插入动态文本

插入动态文本，APP消息内容可根据不同规则显示特定的内容。如性别等于女，则显示女士。应用场景非常广，比如城市等于上海，显示优惠券满100减20，城市等于广州，显示优惠券满60减10等。

目前支持通过客户属性、会员属性进行规则设置。

条件从上往下依次进行判断，客户首先满足哪个条件就显示对应条件设置的文本内容，都不满足时则显示默认内容。

点击高级设置，可设置以下字段：

附加信息：可以设置“键值对”来自定义更多附加信息，App可以依次作后续消息交互和处理（如果消息类型为自定义消息，那就是事先与App约定好消息的展现形式，App接收到推送的“键值对”后直接按规则呈现）极光参考文档

安卓用户还可以设置以下信息

厂商通道状态：可选通道有vivo通道、华为通道、小米通道、OPPO通道、FCM通道、魅族通道；

通知下发策略：厂商通道优先，厂商通道无效时走极光通道；仅通过极光通道下发；极光通道优先，若用户离线则通过厂商下发

caution

此功能为极光应用的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>