标签归档：别名推送

getAlias 获取别名 APP开发接入极光消息推送能力

发表于由
用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package
一门APP开发平台通用JS

getAlias 获取别名 APP开发接入极光消息推送能力

核心代码示例，详情参阅demo

jsBridge.jiguang.getAlias(function(alias){
  alert(alias);
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.getAlias(function(alias){
  alert(alias);
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.getAlias(function(alias){
  alert(alias);
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

个推推送使用别名推送三方账号打通

发表于由

个推推送使用别名推送三方账号打通

一、需求背景

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

bindAlias 绑定别名 APP开发接入个推推送消息SDK

发表于由
用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package
一门APP开发平台通用JS

bindAlias 绑定别名 APP开发接入个推推送消息SDK

♦ 注意这个接口是覆盖逻辑，而不是增量逻辑。即新的调用会覆盖之前的设置。

♦ 同一个别名最多绑定10个 ClientID，当已绑定10个 ClientID 时，再次调用此接口会自动解绑最早绑定的记录。

♦ 此接口与 unBindAlias 一天内最多调用100次，两次调用的间隔需大于5秒。

核心代码示例，详情参阅demo

jsBridge.getui.bindAlias('your_alias', function(succ){
  alert(succ ? "绑定成功" : "绑定失败");
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.getui.bindAlias('your_alias', function(succ){
  alert(succ ? "绑定成功" : "绑定失败");
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.getui.bindAlias('your_alias', function(succ){
  alert(succ ? "绑定成功" : "绑定失败");
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->