导航|地址|刷新
进阶功能-个推文档中心






文档中心开发者中心

，欢迎您！

您的优惠服务将于到期。





基本资料



安全设置



应用管理




退出登录
登录/注册SDK下载个推学堂请选择产品
消息推送

用户运营

OneID服务

AI应用工坊

统计分析

用户分析

标签管理

模型管理

短信服务

数字人外呼

一键认证

合规检测

点击提升







体验更多产品服务


欢迎登录开发者中心

立即登录

本月不再提醒





快速入门
快速接入指南

产品简介

开发者中心使用说明

进阶功能

名词解释

多厂商推送接入说明


客户端
Android
概述

3分钟演示

集成指南

API接口

进阶功能

AppLink集成

Maven集成视频


Android多厂商
厂商应用开通指南

厂商SDK集成指南

厂商消息报表补全

厂商SDK更新日志

厂商通道限额&QPS说明


iOS
概述

3分钟演示

集成指南

API接口

AppLink集成

iOS 证书配置指南

iOS集成视频

隐私清单说明


HarmonyOS
概述

集成指南

厂商应用开通指南

API接口


小程序

客户端插件

卓信ID
概述

使用指南

Android接口

iOS接口

服务端接口


Open Harmony
简介

使用入门

通知类型介绍

获取Push Token

推送场景化消息
发送通知消息

发送语音播报消息

推送后台消息


Push Kit常见问题



服务端
RestAPI V2 (推荐使用)
开发前必读

接口调用规范

进阶功能说明

公共参数

多厂商参数

鉴权API

推送API

统计API

用户API

返回码说明

服务端 SDK


老版文档
导航


个推回执文档

Open Harmony API
场景化消息
功能介绍

请求体结构说明

请求体参数说明

响应参数

请求示例


基于应用信息生成鉴权令牌



推送应用场景
三方账号打通

自定义通知铃声

消息分类

自定义通知图标

角标设置

通知大图、大文本

标签推送

emoji 表情推送

消息终止、覆盖和撤回

微信小程序推送

iOS 时效性通知（即时通知）

LiveActivity(灵动岛）文档说明


点击提升方案
文案圈人操作手册

流程画布操作手册

应用内弹窗操作手册

点击提升方案集成指南

到达率提升方案

点击率提升方案


常见问题
客户端推送常见问题

Android常见问题

iOS常见问题

服务端常见问题


SDK更新日志

购买指南
消息推送计费说明

消息推送购买指引


推送服务使用协议




当前位置：个推文档 > 客户端 > Android > 进阶功能



进阶功能


进阶功能

1. 发送自定义回执

类名	com.igexin.sdk.PushManager
接口	public boolean sendFeedbackMessage(Context context,String taskid,String messageid,int actionid)

说明：

第三方自定义回执，可用于数据统计

参数：

context：应用的 Context

taskid：下发任务的任务 ID

messageid：下发任务的消息 ID

actionid：用户自定义的 actionid，int 类型，取值 90001-90999，厂商可用范围60001-60999

返回：

true：发送成功；false：发送失败；taskid 为空或者 messageid 为空 或者 actionid 不在取值范围以内

接口调用示例：

在个推回调中发送回执
@Override public void onReceiveMessageData(Context context, GTTransmitMessage msg) { byte[] payload = msg.getPayload(); String data = newString(payload); Log.d(TAG, "receiver payload = " + data); String taskid = msg.getTaskId(); String messageid = msg.getMessageId(); /*** * 第三方回执调用接口，actionid可根据业务场景自定义数值 */ boolean result = PushManager.getInstance().sendFeedbackMessage(context, taskid, messageid, actionid); }
个推厂商用户可用此功能统计自定义通知埋点，60001表示“通知展示”，60002表示“通知点击”。详细请联系技术支持：文档中心右侧“技术咨询”

2. 设置标签

类名	com.igexin.sdk.PushManager
接口	public int setTag(Context context,Tag[] tag, String sn)

说明：

设置一组标签（覆盖操作，cid只会绑定当前传入的标签），后续可使用该标签定向推送

需要在获取到 Clientid 之后调用。默认一天只能成功设置一次（可联系技术支持进行修改）

请求结果见用户 IntentService 中的onReceiveCommandResult(Context context, GTCmdMessage cmdMessage)

参数：

context：应用的 Context

tag：用户标签

sn：用户自定义的序列号，用来唯一标识该动作，用户 IntentService 中会回执该结果

接口调用示例：
String[] tags = new String[] {"tag1", "tag2", "tag3"}; Tag[] tagParam = new Tag[tags.length]; for (int i = 0; i < tags.length; i++) { Tag t = newTag(); //name 字段只支持：中文、英文字母（大小写）、数字、除英文逗号和空格以外的其他特殊符号，具体请看代码示例 t.setName(tags[i]); tagParam[i] = t; } PushManager.getInstance().setTag(context, tagParam, String.valueOf(System.currentTimeMillis()));
请求结果处理示例：
// 在用户 IntentService 中添加以下代码： @Override public void onReceiveCommandResult(Context context, GTCmdMessage cmdMessage) { Log.d(TAG, "onReceiveCommandResult -> " + cmdMessage); int action = cmdMessage.getAction(); if (action == PushConsts.SET_TAG_RESULT) { String sn = ((SetTagCmdMessage) cmdMessage).getSn(); String code = ((SetTagCmdMessage) cmdMessage).getCode(); /* code 值说明 0：成功 10099：SDK 未初始化成功 20001：tag数量过大（单次设置的 tag 数量不超过 100) 20002：调用次数超限（默认一天只能成功设置一次） 20003：标签重复 20004：服务初始化失败 20005：setTag 异常 20006：tag为空 20007：sn 为空 20008：离线，还未登陆成功 20009：该 appid 已经在黑名单列表（请联系技术支持处理） 20010：已存 tag数目超限 20011：tag内容格式不正确 */ Log.d(TAG, "settag result sn = " + sn + ", code = " + code ); } }
3 查询标签

类名	com.igexin.sdk.PushManager
接口	public int queryTag(Context context, String sn)

说明：

返回用户的标签

请求结果见用户 IntentService 中的onReceiveCommandResult(Context context, GTCmdMessage cmdMessage)

参数：

sn ：对应设置标签时的序列号；setTag(context,tags,sn)

返回：

20007：sn为空
20002：查询标签失败，频率过快.
0：查询标签成功

请求结果处理示例：
// 在用户 IntentService 中添加以下代码： @Override public void onReceiveCommandResult(Context context, GTCmdMessage cmdMessage) { Log.d(TAG, "onReceiveCommandResult -> " + cmdMessage); int action = cmdMessage.getAction(); if (action == PushConsts.QUERY_TAG_RESULT) { Tag[] tags = ((QueryTagCmdMessage) cmdMessage).getTags();; /* code 值说明 0：成功 20002：查询标签失败，频率过快。限制每10分钟只能调用1次 */ } }
4. 绑定别名

类名	com.igexin.sdk.PushManager
接口	public boolean bindAlias(Context context,String alias,String sn)

说明：

绑定别名，后续可以使用该别名进行定向推送，重复绑定以最后一次为准，两次调用的间隔需大于 1s，单个 cid 在 24 小时内限制调用50次。

可用于与客户账号系统关联，建议将邮箱、昵称、手机号等用户标识设为别名

使用场景：同一个账号（比如手机号）分别登陆在 A、B、C 三台设备上的同一个 APP， 产生了 3 个不同的 cid, 想让这三台设备同时接收到推送，就可以考虑使用该接口，让三台设备的三个 cid 都绑定同一个别名也就是你的账号（比如手机号），最多支持 10 台设备，也就是最多绑定 10 个 cid

请求结果见用户 IntentService 中的 onReceiveCommandResult(Context context, GTCmdMessage cmdMessage)

参数：

context – 应用的 Context

alias – 别名名称：长度 40 字节，支持中、英文（区分大小写）、数字以及下划线

sn - 用户自定义的序列号，用来唯一标识该动作

请求结果处理示例
// 在用户 IntentService 中添加以下代码： @Override public void onReceiveCommandResult(Context context, GTCmdMessage cmdMessage) { Log.d(TAG, "onReceiveCommandResult -> " + cmdMessage); int action = cmdMessage.getAction(); if (action == PushConsts.BIND_ALIAS_RESULT) { String sn = ((BindAliasCmdMessage) cmdMessage).getSn(); String code = ((BindAliasCmdMessage) cmdMessage).getCode(); /* code 结果说明 0：成功 10099：SDK 未初始化成功 30001：绑定别名失败，频率过快，两次调用的间隔需大于 1s 30002：绑定别名失败，参数错误 30003：当前 cid 绑定别名次数超限 30004：绑定别名失败，未知异常 30005：绑定别名时，cid 未获取到 30006：绑定别名时，发生网络错误 30007：别名无效 30008：sn 无效 */Log.d(TAG, "bind alias result sn = " + sn + ", code = " + code); } }
5. 解绑别名

类名	com.igexin.sdk.PushManager
接口	public boolean unBindAlias(Context context,String alias,boolean isSelf,String sn)

说明：

解绑别名，两次调用的间隔需大于 1s。只能解绑与当前应用 cid 关联的别名，单个 cid 在 24 小时内限制调用50次。

请求结果见用户 IntentService 中的 onReceiveCommandResult(Context context, GTCmdMessage cmdMessage)

参数：

context：应用上下文

alias：别名名称

isSelf：是否只对当前 cid 有效，如果是 true，只对当前 cid 做解绑；如果是 false，对所有绑定该别名的 cid 列表做解绑

用户自定义的序列号，用来唯一标识该动作

请求结果处理示例
// 在用户 IntentService 中添加以下代码： @Override public void onReceiveCommandResult(Context context, GTCmdMessage cmdMessage) { Log.d(TAG, "onReceiveCommandResult -> " + cmdMessage); int action = cmdMessage.getAction(); if (action == PushConsts.UNBIND_ALIAS_RESULT) { String sn = ((UnBindAliasCmdMessage) cmdMessage).getSn(); String code = ((UnBindAliasCmdMessage) cmdMessage).getCode(); /* code 结果说明 0：成功 10099：SDK 未初始化成功 30001：解绑别名失败，频率过快，两次调用的间隔需大于 1s 30002：解绑别名失败，参数错误 30003：当前 cid 解绑别名次数超限 30004：解绑别名失败，未知异常 30005：解绑别名时，cid 未获取到 30006：解绑别名时，发生网络错误 30007：别名无效 30008：sn 无效*/Log.d(TAG, "unbindAlias result sn = " + sn + ", code = " + code); } }
6. 发送 Applink 点击回执

类名	com.igexin.sdk.PushManager
接口	public boolean sendApplinkFeedback(Context context, String url)

说明：

用于点击回执统计，消息无法下发时，可以通过该方式下发短信进行补量（Android M 开始支持）

参数：

context：应用的 Context

url：applink url

返回：

true：发送成功；false：发送失败，url 为空




以上文档对您是否有帮助？
有帮助没帮助



您的改进建议

是否遇到以下问题

问题类型


1、内容与功能不一致；

2、文章描述不清晰；

3、图片和视频难理解；

4、对产品功能不满意；

5、不是我想要的内容；

6、其他:


问题类型不能为空



反馈建议



联系方式



取 消提 交





反馈成功

非常感谢您的反馈，我们会继续努力做到更好！
确定






在这篇文章中：1. 发送自定义回执2. 设置标签3 查询标签4. 绑定别名5. 解绑别名6. 发送 Applink 点击回执





开发者中心SDK 下载



文档中心搜索

搜 索















------
导航页 打开网址