APP 消息推送

1. 概述

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

使用新渠道下的 APP 消息推送功能的前置条件：

• 开启 TMS 上新渠道框架开关。
• 联系客户经理协助执行数据迁移的脚本，逐步迁移老渠道的数据。确保在开启新渠道框架开关后，之前创建的模板、发送记录、事件和自动流程能够正常使用。

2. 如何配置 APP 应用

在 DM Hub 内设置 APP 消息推送前，需先开通极光推送服务或准备自己的推送服务。

功能入口：设置 > 系统设置 > 营销触点 > App 消息推送 > 应用管理

2.1. 极光配置说明

2.1.1. 查看配置信息

登录极光开发者控制台，创建应用并查看应用信息。

详情参考极光官方文档。

2.1.2. DM 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.3. channel 说明

字段	说明
provider	用于从 app_notification_identity 表查询 pushId
providerLabel	推送身份会显示在客户身份下面，要显示的推送渠道，如果缺失则展示插件
appId、masterSecret 等信息	插件服务所需，用于调用推送服务商

2.2.4. broadcastSetting 说明

字段	说明
url	插件服务 url，用于 sms 服务调用插件服务
authType	鉴权方式，支持 none/default/aliapp
appId、appSecret	鉴权所需信息

2.2.5. clabapp 说明

字段	说明
url	DMHub open api url，用于插件服务上传发送事件、群发报告等信息
appId、secret	DMHub open api appId、secret

2.2.6. ui meta 数据结构定义参考

插件渠道绑定 AppKey 接口 requestBody：

{
  "name": "",
  "appKey": "",
  "provider": "plugin",
  "pluginMeta": "json字符串"
}

3. App 数据接入

设置完 AppKey 和 Master Secret 并不等同于接入了 App 的客户数据，所以要实现消息发送，还必须通过埋点接入客户数据。

• iOS SDK 参考文档。

• Android SDK 参考文档。

接入数据后，可在系统中客户—高级筛选—APP 消息推送中筛选支持消息推送的客户。支持三种条件筛选：推送渠道（个推和极光），操作系统（Android 和 iOS），推送应用（接入的应用）。

点击查找出的支持消息推送的客户进入客户详情，可以在【客户身份】中看到客户的 App 消息推送 ID。

caution

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

4. 新建消息

完成应用绑定并接入了客户后，可以对客户进行消息推送。点击【渠道运营 > APP 消息推送】可以进入消息列表。如关联了多个应用，可以点击切换应用，然后新建消息。推送消息字段配置如下：

• 消息形式，分为通知消息和自定义消息：

  • 通知消息：通知（Notification），指在手机的通知栏（状态栏）上会显示的一条通知信息。这是 Android / iOS 的基本功能。 通知主要用于提示用户。一条通知，简单的填写纯文本的通知内容即可。应用加上通知功能，有利于提高应用的活跃度。
  • 自定义消息：自定义消息不是通知，默认不会被 SDK 展示到通知栏上，极光推送仅负责透传给 SDK。其内容和展示形式完全由开发者自己定义。自定义消息主要用于应用的内部业务逻辑和特殊展示需求。

• 模版名称：该消息在系统里的名称，仅用作系统内部记录识别，不会在用户收到的推送消息中显示。

• 所属分组：推送消息所属分组。

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

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

• 消息内容：显示在通知栏的消息正文，消息正文支持插入变量和动态文本：

  • 插入变量，变量类型支持客户属性、值标签、上下文事件，可在 【为空时显示】 处设置默认值。用户收到插入变量的 APP Push 时，变量内容会自动显示为 DM Hub 系统中记录的用户相关信息。
  • 插入动态文本，插入动态文本，APP 消息内容可根据不同规则显示特定的内容。如性别等于女，则显示女士。应用场景非常广，比如城市等于上海，显示优惠券满 100 减 20，城市等于广州，显示优惠券满 60 减 10 等。

• pushId 类型：DM Hub 支持 ClientID。

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

• 附加信息：可以设置“键值对”来自定义更多附加信息，可支持客户属性、值标签、上下文事件，可在【为空时显示】处设置默认值。用户收到插入变量的 APP Push 时，变量内容会自动显示为 DM Hub 系统中记录的用户相关信息。App 可以依次作后续消息交互和处理（如果消息类型为自定义消息，那就是事先与 App 约定好消息的展现形式，App 接收到推送的“键值对”后直接按规则呈现）极光参考文档。

• 支持离线推送，若打开该开关，可设置 0-72 小时内的整数离线存储时长，即使消息推送时用户的 APP 处于离线状态，该时间段内上线的客户均可收到推送通知；

• 提醒方式：响铃或震动。

5. 推送消息

5.1. 群发

消息创建后即可在 APP 消息列表中展现，点击【发送】按钮，设置发送对象和发送时间即可群发：

• 发送对象：所有 App 用户将发送给所有安装了该 app 的用户；部分 App 用户需选择消息发送群组；匿名 App 用户将发送给安装了 App 但没有注册的用户（在 DM Hub 也没有相关的客户数据，此类用户便是匿名用户）。
• 发送时间：可以选择立即发送或者定时发送。

如设置了定时发送，可在【计划中的定时群发】中查看，在定时发送时间之前可以修改发送时间或取消发送。

5.1.1. 查看群发数据

在【APP 消息推送 > 群发记录】中可查看所有群发任务列表及群发状态。通过群发记录可以看到每条短信已群发次数，点击 发送状态 旁的 详情，可查看发送批次、发送对象、发送时间、客户触达等数据。

5.2. 自动流触发

自动流中直接选择 App 消息组建，选择设置好的消息内容进行发送。自动流详细操作步骤参考自动流程

5.3. 行为记录

在时间轴中会记录系统发送手机应用通知、发送手机应用通知成功、收到手机应用通知、点击手机应用通知等事件。利用这些事件，可以在高级筛选中进行客户筛选。