三方账号打通

三方账号打通

一、需求背景

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 的别名。

注意事项:

  1. 重复绑定别名以最后一次为准,同一个 cid 绑定接口调用的间隔需大于 1 s,客户端单个设备每天限制调用 100 次。

  2. 一个 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 即可圈选测试别名下的所有用户进行推送。

开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询