微信小游戏订阅消息接入最佳实践
小游戏作为时下游戏行业的热点和风口，越来越多的游戏公司开始布局小游戏赛道。
小游戏是以小程序为载体的游戏产品形态，无需下载、即点即玩等特点，相对于 App 形态的游戏来说有着明显优势：研发投入低、用户有增量、买量有红利等。
其中，微信订阅消息支持调用 api 接口实现个性化推送的能力，亦可对接 AE 运营模块实现个性化与精细化的运营。
本文会具体说明，AE 运营模块在小游戏运营中的最佳实践。
1. 什么是微信订阅消息
基于微信的通知渠道，微信为开发者提供了可以高效触达用户的订阅消息能力，以便实现服务的闭环并提供更佳的体验。
开发者在游戏内，可向用户发起消息订阅。开发者需后台自行记录用户是否订阅成功及订阅成功的次数。
用户在小游戏中订阅指定的消息内容后，开发者可以在后台通过下发消息的 API 把一条模版消息发送给用户，用户最终在微信的“服务通知”中收到。
用户成功订阅一次，开发者可在游戏认为场景合适的时机，向该用户发下一条模版消息。
2. 微信小游戏后台准备
2.1 前置准备
申请微信小程序，完成备案和认证
小程序【服务类目】= 游戏
2.2 获取 APP ID 和 APP Secret
是用于确保小程序或应用的安全性和稳定性的重要标识符和密钥
- Appid：作为应用的唯一标识符，主要用于在微信开发者工具中进行开发和调试。它是系统自动生成的，确保了每个小程序或应用的唯一性，便于在数据库中添加检索，方便快速查找和管理。
- Appsecret：作为应用的密钥，主要用于数据加密和解密等操作。它类似于密码，用于保证数据的安全性和准确性，提高系统的可靠性和可用性。appsecret的生成遵循一般的密码安全性要求，确保其强度和安全性。
开发者需要妥善保管自己的 Appid 和 Appsecret，以防止未经授权的访问和数据泄露，确保小程序或应用的安全性和稳定性。
2.2.1 获取方式
进入微信小程序后台：[开发] - [开发管理] - [开发设置]，首次登录可获取系统自动生成的 APPID 和 APPSecret
APPSecret 默认不被明文保存，首次获取密钥后请妥善存储
2.2.2 更新方式
APPSecret 只会在首次生成时以明文显示，若忘记或丢失则需要通过“重置”按钮重新获得密钥。
只有管理员才有权限重置密钥。
每个账号每月使用重置 API 调用次数与本接口共10次清零操作机会，清零生效一次即用掉一次机会；
⚠️ 注意：重置密钥时，请同步更新 AE 运营模块中通道对应的密钥并重新链接，否则会导致相关的运营任务失效。
2.3 设置模版
2.3.1 模版创建方式
进入微信小程序后台：[订阅消息] - [公共模版库] 查看模版库中的内容。微信小游戏后台提供了海量的消息订阅模版库可供选择。您可以“选用”适合您消息推送场景的模版库，选择需要的关键词，并“提交”创建，便可以生成一个自定义模版。
2.3.2 我的模版
通过公共模版库的选用和提交后，便可以在 [我的模版] 中查看当前小游戏订阅消息可推送的所有模版。
AE 运营模块的【微信 - 订阅消息通道】中支持拉取/更新对应的小游戏下的全部模版。
点开对应的模版 [详情] ，可以查看模版ID ， 模版参数及其数据类型。
3. 对接 AE 三方平台通道
3.1 上报 OpenID
为了将模版订阅消息通过 AE 推送通道成功推给用户，您需要将微信小程序的 OpenID 上报至 AE 系统并绑定用户属性，以用于运营任务的微信订阅消息推送。技术文档详见 微信订阅消息接入文档
3.2 微信订阅消息通道创建
3.2.1 应用授权
您可以通过 “应用授权” 入口授权微信小程序模版信息的调用。
同一个小程序共享同一套 APP ID 和 APP Secret，仅需一次授权即可。
密钥的获取方式详见：
点击【三方平台】通道右上方的「应用授权」进入到所示界面，您可自定义应用名称，并填入在【步骤 2.2】 中获取的小程序对应的 APP ID 和 APP Secret。
若所输入信息正确，点击 “连接并保存”后，系统会提示您 连接成功。
当 AppID 和 AppSecret 验证有效后，access_token 会每两小时自动刷新一次，确保应用的正常连接状态。
3.2.2 新建通道
点击 三方平台 - 微信订阅消息 右上角 +新建通道 即可以进入到订阅消息通道创建页面。
-
通道名称：微信订阅消息通道的名称
-
选择授权应用：在新建通道时，您可以选择连接状态正常的应用，通道会自动拉取该应用微信后台所有可用的订阅消息模版。若应用连接状态异常，请先去「应用授权」中检查。
-
用户 Open ID：接收消息的目标用户 ID 类型，可选 用户属性（数值和字符串类型属性）。在目标用户人数预估时会过滤发送 ID 为空的用户。OpenID 的上报方式请查看技术文档。
-
小程序设置：点击订阅消息卡片跳转小程序界面的设置，此为通道层级参数设置，任务层级可覆盖。
- 小程序类型：分为 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 |
3.2.3 管理通道
-
开启/关闭通道
- 通道开关开启后，若应用连接成功，则通道为“连接正常”状态，否则，为“连接异常”状态。
- 通道开启后，创建新的任务时可选用该通道 ；
- 通道关闭后，新建新的任务时不可选（下拉中不显示），运行中的任务会自动结束，审批中的任务会自动撤回。
-
编辑/删除通道
通道关闭后才可以对其进行编辑或删除操作。
3.3 创建运营推送任务
选择 微信- 订阅消息通道 创建任务
选择触达方式和选择触达通道是同一个弹窗的两步：点击「微信 - 订阅消息」卡片后，弹窗直接切换到通道列表，选中已开启的通道后点击「确定」，即可进入任务编辑页面
您可以在推送内容里选择想要的模版，并填入需要发送的内容
保存并提交，审批通过后运营任务上线。
3.4 发送测试
测试方法一：
在任务编辑页「推送内容」底部点击「发送测试」，可以向对应的账号发送测试消息，不会创建任务。模版参数全部填好之前，该按钮为灰色不可用。弹窗中填写的是通道「用户 Open ID」属性对应的发送 ID：
测试方法二：
上线一个真实的运营任务，把 目标人群圈选 选择 目标测试账号 即可定向推送，其他用户就收不到。
4. 订阅消息可发送次数机制说明
4.1 场景说明
微信小游戏通道发送测试的时候，可能会遇到第一次发送成功，第二次再发送就发送失败了，显示提示：user refuse to accept the msg.
4.2 原因
目前微信小游戏只支持 " 一次性订阅消息"，每次订阅只能发送一条消息。
订阅消息类型
（1）一次性订阅：用户自主订阅后，可不限时间地下发一条对应的服务消息；每次订阅只能发送一条消息。
（2）长期订阅：用户订阅一次后，可长期下发多条消息。长期订阅对资质的要求很高，目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下公共服务业务。
每次订阅只能发送一条消息，但是用户的 订阅次数 可以 累加。
案例：将微信小游戏 模版A 订阅代码绑定至 “礼包” 按钮（即打开礼包一次，即会调用一次模版注册逻辑）
那么 用户点击了几次礼包按钮就累计了几次订阅次数
- 单个用户能接受的订阅消息次数和该用户在游戏内触发订阅机制的次数相关。
- 同一个模版消息，可能 A 用户能收到多次（累计了多次订阅），B用户只能收到一次（仅累积一次订阅）
4.3 建议
- 相同的微信订阅消息，游戏内活跃用户可以收到的消息更多，新用户或者非活跃用户收到的消息会相对较少，可以搭配一些其他的运营策略增加小游戏内的订阅次数，促使用户收到更多推送消息。