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