进阶功能

1. 发送自定义回执

说明：

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

参数：

• 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 = new String(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. 设置标签

说明：

• 设置一组标签，后续可使用该标签定向推送
• 需要在获取到 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 = new Tag();
      //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 查询标签

说明：

• 返回用户的标签
• 请求结果见用户 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 = tagCmdMessage.getTags();

        /*  code 值说明
            0：成功
            20002：查询标签失败，频率过快
        */
    }
}

4. 绑定别名

说明：

• 绑定别名，后续可以使用该别名进行定向推送，重复绑定以最后一次为准，两次调用的间隔需大于 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. 解绑别名

说明：

• 解绑别名，两次调用的间隔需大于 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 点击回执

说明：

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

参数：

• context：应用的 Context
• url：applink url

返回：

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