一、需求背景
1.1 背景描述
APP 在运营过程中，都拥有属于自己的账号体系，其账号运营体系不尽相同，例如银行类 APP 的账号体系为银行卡号、社交类 APP 体系为社交 ID 号、自定义昵称、手机号等等。因此第三方消息推送在基于账号体系场景下进行消息精准推送，例如银行类 APP 账户余额变动、订单状态更新等，则需要与账号体系进行打通、绑定、识别并进行单个用户精准推送消息。
因此个推消息推送推出基于不同体系账号下的 APP 提供了别名推送功能，可有效打通不同体系下的账号屏障，基于个推 CID 与各个 APP 绑定账号关系，实现用户的精准推送，以满足某些场景下的特定推送需求。
1.2 名称解释
| 名词 | 解释 |
|---|---|
| CID | 个推业务层中的对外用户标识，用于标识客户端身份，由第三方客户端获取并保存到第三方服务端，是个推 SDK 的唯一识别号，简称 cid。 |
| 别名 | 别名是 APP 为用户定义的标识，可用于用户账号与个推 cid 关联，建议将邮箱、昵称、手机号等用户标识设为别名。为用户绑定别名后，可以通过别名圈选目标用户进行推送。 |
二、技术实现方案
2.1 前置准备
完成 android 集成指南 和 ios 集成指南 。
2.2 设置别名
开发者可在客户端或者服务端给 cid 设置别名，客户端需要区分 android 和 ios，开发者选择其中一个渠道（客户端或服务端）设置即可。
2.2.1 客户端设置别名
| 平台 | 实现方式 |
|---|---|
| android | 在成功获取 cid 的回调方法 onReceiveClientId 内，调用 绑定别名接口 将 APP 的用户标识设置为 cid 的别名。 |
| ios | 在成功获取 cid 的回调方法 GeTuiSdkDidRegisterClient 内，调用 绑定别名接口 将 APP 的用户标识设置为 cid 的别名。 |
注意事项：
- 重复绑定别名以最后一次为准，同一个 cid 绑定接口调用的间隔需大于 1 s，客户端单个设备每天限制调用 100 次。
- 一个 cid 只支持绑定一个别名，，一个别名至多绑定 10 个 cid 。
2.2.1 服务端设置别名
开发者可通过调用 个推服务端 api 或者直接从 个推开发者中心 页面绑定别名。
2.2.1.1 服务端 api 设置别名
开发者需要自己存储 cid，在系统新增 cid 时，调用 绑定别名接口 将 APP 的用户标识设置为 cid 的别名。
2.2.1.2 开发者中心设置别名
登陆 个推开发者中心 ，进入下图页面可选择添加单个别名或者批量导入别名。
①添加单个别名：点击【添加别名】输入别名和 cid 即可绑定别名用户。
②批量导入别名：首先创建一个别名和对应 cid 的 TXT 文本，然后点击【批量导入】上传别名列表文本，最后点击【导入】即可批量添加别名以及对应的 cid 用户。
2.3 服务端推送
开发者可通过调用 个推服务端 api 或者直接从 个推开发者中心 页面推送消息。
2.3.1 服务端 api 推送
使用 执行别名单推 接口，给指定别名用户进行推送。
2.3.2 开发者中心推送
点击 创建通知/透传 消息，选择【别名用户】进行消息推送。例如绑定别名用户为 test ，输入 test 即可圈选测试别名下的所有用户进行推送。
编辑：yimen，如若转载，请注明出处：https://www.yimenapp.com/kb-yimen/15459/
部分内容来自网络投稿，如有侵权联系立删
