推送任务通道设置
1.功能概述
运营模块目前支持 Webhook 通道、消息推送、客户端通道和三方平台通道（微信、KakaoTalk、抖音）四种触达方式，您可以通过 Webhook 通道对接企业自建的通道平台，也可以直接采用 AE 运营模块预置的消息推送通道，实现常见的 App 推送平台能力接入。您还可以通过对接 AE SDK 的方式接入客户端通道，实现应用内的实时触达。三方平台中，我们支持接入微信小程序订阅消息、KakaoTalk Brand Message 和抖音推荐页游戏卡，让您更加方便快捷地在这些平台上进行消息推送。
2. 新建通道
2.1 Webhook 通道
在通道设置页面（运营设置 > 通道设置），您可以新建通道和管理已有通道，其中管理操作支持发送测试、开/关通道以及编辑/删除等。
2.1.1 新建通道
点击右上角 +新建通道 即可以进入到创建 Webhook 通道页面。
- 通道名称：Webhook通道的名称
- URL：接收消息推送的接口地址，支持同一个 URL 地址配置多个通道。
- 自定义请求头：开启后，可以为发往该 URL 的请求添加自定义请求头。
- 发送 ID：消息推送的目标用户主体ID ，可选用户属性中数值和字符串类型属性。在目标用户人数预估时会过滤发送 ID 为空的用户（比如游戏内的邮件系统接收消息的目标用户 ID 为角色 ID，短信系统接收消息的目标用户 ID 为手机号等）
- 通道鉴权：您可以开启通道鉴权填写密钥，以防止非法调用提高通道的安全性
- 触达漏斗设置：开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据
- 内容模板：您可以自定义该通道发给用户的具体内容的模板，支持文本、动态文本、数值、单选下拉、日期、时间和对象组等字段类型，如发送邮件通道可以通过对象组类型配置道具内容（比如：道具 ID 和道具数量）
- 自定义参数：根据通道要求选择性添加，该参数为透传
关于 Webhook 通道接入的更多技术接入内容，您可以查阅Webhook通道接入文档。
2.1.2 管理已有通道
- 发送测试
通道创建成功后，默认关闭状态，您可以先进行发送测试，确定能发送成功后再开启通道。
您可以通过点击 操作 中的小飞机按钮进入发送测试弹窗，根据所选通道的配置填写相关信息。
之后您可以点击 “查看请求”来预览系统生成的请求结构体是否满足您本次的发送测试需求，确认无误后点击 “确认发送” 即可进行发送测试。
操作成功后，系统也会将本次发送测试是否成功的状态返回，便于您确认状态或排查问题。
-
开/关通道
- Webhook通道开启后，创建新的任务时可选用该通道 ；
- Webhook通道关闭后，新建新的任务时不可选（下拉中不显示），运行中的任务会自动结束，审批中的任务会自动撤回。
-
编辑/删除
通道关闭后才可以对其进行编辑或删除操作。
2.2 消息推送
目前预置的消息推送平台有 FCM、极光推送和 APNs，您可以根据需要接入相应应用。
2.2.1 FCM
- 通道名称：FCM 通道的名称，不支持重名
- 发送 ID：推送目标用户的FCM registration token字段，需先将FCM registration token作为用户属性上报
- 服务器私钥：您需要上传该项目的 FCM 服务器私钥文件。密钥获取方式详见 FCM服务器密钥获取指南
- 触达漏斗设置：开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据
- 透传参数：您可以根据自己的需求来添加透传参数，透传参数主要用于业务侧应用的内部业务逻辑处理或特殊展示需求。
FCM registration token字段上报和触达漏斗设置，详见消息推送技术接入文档中关于FCM推送相关的技术接入内容。
2.2.2 极光
- 通道名称：自定义通道的名称，不支持重名
- 发送 ID：推送目标用户的极光ID字段，需先将极光ID作为用户属性上报
- AppKey & MasterSecret：极光推送平台注册的应用 AppKey和MasterSecret。极光应用参数获取详见 极光应用接入参数获取指南
- 触达漏斗设置：开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据
- 透传参数：您可以根据自己的需求来添加透传参数，透传参数主要用于业务侧应用的内部业务逻辑处理或特殊展示需求。
极光ID字段上报和触达漏斗设置，详见消息推送技术接入文档中关于极光推送相关的技术接入内容。
2.2.3 APNs
- 通道名称：自定义通道的名称，不支持重名
- 发送 ID：推送目标用户的APNs Token字段，需先将APNs Token作为用户属性上报
- 证书类型：支持选择 P12 或 P8 证书进行配置，也支持选择生产环境或开发环境。APNs证书获取详见 APNs 推送证书设置指南
- 触达漏斗设置：开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据
- 透传参数：您可以根据自己的需求来添加透传参数，透传参数主要用于业务侧应用的内部业务逻辑处理或特殊展示需求。
APNs Token字段上报和触达漏斗设置，详见消息推送技术接入文档中关于APNs推送相关的技术接入内容。
2.2.4 发送测试
配置完成通道后，可以直接在通道设置中进行通道的效果测试，点击对应通道后面的操作列 发送测试 按钮（见下图指示）即可进入通道测试。
在发送测试时，需要填写用于验收效果的测试账号对应的发送ID（可以使用AE的 用户细查 功能查询测试账号的发送ID）以及消息通知的 标题、内容等信息。不同通道的弹窗略有不同：都可以设置跳转方式（打开应用 / 打开网页 / 打开指定页面）和消息大图地址；APNs、极光通道还要选择发送环境（生产环境 / 开发环境），极光通道另有右侧图标地址；FCM、APNs 通道的弹窗里还会列出通道配置的透传参数。点击确认发送后，即可在手机上查看对应效果。
2.3 客户端通道
客户端通道需要开启项目级客户端通道能力并对接 AE SDK 后方可使用，请联系您的客户经理体验该功能。
2.3.1 新建通道
点击右上角 +新建通道 即可以进入到创建 客户端通道页面。
- 通道名称：客户端通道的名称
- 消息类型：客户端在接收到推送消息后，通过「消息类型」区分不同的端内触发场景。例如：“弹窗”的消息类型可定义为 popup
- 发送 ID：接收消息的目标用户 ID 类型，可选 用户属性（数值和字符串类型属性）或者 客户端参数，在目标用户人数预估时会过滤发送 ID 为空的用户（比如游戏内的邮件系统接收消息的目标用户 ID 为角色 ID，短信系统接收消息的目标用户 ID 为手机号等）
- 触达漏斗设置：开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据。触达漏斗事件需携带运营任务下发的透传参数，详见客户端触发式SDK接入文档中的触达漏斗设置。
- 内容模板：您可以自定义该通道发给用户的具体内容的模板，支持文本、动态文本、数值、单选下拉、日期、时间和对象组等字段类型，如发送邮件通道可以通过对象组类型配置道具内容（比如：道具 ID 和道具数量）
- 自定义参数：根据通道要求选择性添加，该参数为透传
2.3.2 发送测试
通道创建成功后，默认为关闭状态，您可以先进行发送测试，确定通道连通后再开启使用。点击操作栏的小飞机按钮即可进入发送测试流程。
客户端触发式发送测试需要使用测试设备，您可在测试设备列表中选择或添加测试设备，并开启Debug模式。Debug模式开启方式见客户端触发式接入文档。
确认推送内容后，点击发送开始进行测试，并根据进度条观测进度。当进度条显示“拉取任务”成功后，您就可以在设备上验证是否收到推送内容。系统将返回本次发送测试结果，便于您确认状态或排查问题。
2.3.3 管理通道
-
开启/关闭通道
- 客户端通道开启后，创建新的任务时可选用该通道 ；
- 客户端通道关闭后，新建新的任务时不可选（下拉中不显示），运行中的任务会自动结束，审批中的任务会自动撤回。
-
编辑/删除通道
通道关闭后才可以对其进行编辑或删除操作。
关于客户端通道接入的更多详情内容您可以查阅 客户端通道接入文档
2.4 三方平台（微信/KakaoTalk/抖音）
三方平台页签下目前有「微信 - 订阅消息」「KakaoTalk - Brand Message」「抖音 - 推荐页游戏卡」三类通道；如果项目里看不到需要的通道，或需要对接其他三方通道，请联系您的客户经理。
最佳实践可参考 微信小游戏消息接入最佳实践
2.4.1 应用授权
您可以通过 “应用授权” 入口授权微信小程序模版信息的调用。
同一个小程序共享同一套 APP ID 和 APP Secret，仅需一次授权即可。
点击【三方平台】通道右上方的「应用授权」进入到所示界面，您可自定义应用名称，并填入小程序对应的 APP ID 和 APP Secret。
若所输入信息正确，点击 “连接并保存”后，系统会提示您 连接成功。
当 AppID 和 AppSecret 验证有效后，access_token 会每两小时自动刷新一次，确保应用的正常连接状态。
2.4.2 新建通道
点击 三方平台 - 微信订阅消息 右上角 +新建通道 即可以进入到订阅消息通道创建页面。
-
通道名称：微信订阅消息通道的名称
-
选择授权应用：在新建通道时，您可以选择连接状态正常的应用，通道会自动拉取该应用微信后台所有可用的订阅消息模版。若应用连接状态异常，请先去「应用授权」中检查。
-
用户 Open ID：接收消息的目标用户 ID 类型，可选 用户属性（数值和字符串类型属性）。在目标用户人数预估时会过滤发送 ID 为空的用户。Open ID 的上报方式请查看技术文档。
-
小程序设置：点击订阅消息卡片跳转小程序界面的设置，此为通道层级参数设置，任务层级可覆盖。
- 小程序类型：分为 formal (正式版），developer (开发版），trial (体验版），不填的话默认为正式版
- 小程序语言：分为 zh_CN (简体中文)，en_US (英文)，zh_HK (繁体中文)，zh_TW (繁体中文)，不填的话默认为 zh_CN (简体中文)
- 跳转地址：点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
-
内容模板：
微信小游戏的推送消息，需要用户订阅成功后才能发送到用户的微信消息中。
在应用成功授权并连接后，通道可以通过 token 可以一次性获取微信后台所有用户创建的订阅消息模板。您可以在通道中保存需要的模板并在运营任务中选用。
点击【刷新模版列表】按钮可以重新调取接口获得通道下新的模版列表。
- 内容模版参数支持的全部类型
模板中参数的数据类型是微信消息模版定义好的，以拉取到的参数类型为准。
| 微信数据类型 | 类型说明 | Mapping 运营输入方式 | 说明 | 参数规格限制 |
|---|---|---|---|---|
| thing.DATA | 事物 | 动态文本 | 可汉字、数字、字母或符号组合 | 20 |
| number.DATA | 数字 | 数值 | 只能数字，可带小数 | 32 |
| letter.DATA | 字母 | 文本 | 只能字母 | 32 |
time.DATA | 时间 | 时间 | 24小时制时间格式（支持+年月日），支持填时间段，两个时间点之间用“~”符号连接 | |
| date.DATA | 日期 | 日期 | 年月日格式（支持+24小时制时间），支持填时间段，两个时间点之间用“~”符号连接 | |
| symbol.DATA | 符号 | 动态文本 | 只能符号 | 5 |
| amount.DATA | 金额 | 文本 | 1个币种符号+10位以内纯数字，可带小数，结尾可带“元” | 11 |
| phone_number.DATA | 电话 | 文本 | 数字、符号 | 17 |
| car_number.DATA | 车牌 | 文本 | 8位以内，第一位与最后一位可为汉字，其余为字母或数字 | 8 |
| name.DATA | 名字 | 文本 | 10个以内纯汉字或20个以内纯字母或符号 | 汉字 10 字母 20 |
| phrase.DATA | 汉字 | 文本 | 5个以内汉字 | 5 |
2.4.3 管理通道
-
开启/关闭通道
- 通道开关开启后，若应用连接成功，则通道为“连接正常”状态，否则，为“连接异常”状态。
- 通道开启后，创建新的任务时可选用该通道 ；
- 通道关闭后，新建新的任务时不可选（下拉中不显示），运行中的任务会自动结束，审批中的任务会自动撤回。
-
编辑/删除通道
通道关闭后才可以对其进行编辑或删除操作。
关于微信订阅消息通道接入的技术文档您可以查阅 微信订阅消息通道接入文档
3. 疲劳控制
疲劳控制是指当多个运营任务使用同样的触达通道时，单用户在一定时间段内接收同类通道最大推送次数的限制。您可以设置各个触达方式的疲劳控制规则，并在创建运营任务时选择开启疲劳控制以减少对用户的过度打扰。
进入 运营设置 > 疲劳控制，打开通道的开关即进入编辑状态，您可以根据需求对相关通道进行疲劳控制规则编辑（Webhook 通道按单个通道设置），多个条件之间是且的关系，编辑完成后点击右上角的「保存」。目前支持的周期单位为分钟、小时、天和周。