移动推送: 如何向指定的一群用户(标签用户)推送消息？

客户端绑定自定义Tag操作指南

1. 功能简介

• 定义：绑定标签（BindTag）是将特定的标签（tag）关联到目标设备、账号或别名上，以便于通过这些标签进行定向消息推送的服务。
• 用途：实现精准的消息推送，如按用户兴趣、地区等属性分类推送，提升消息到达的针对性和效率。

2. 接口调用说明

• 接口名称：bindTag
• 目标类型：支持以下三种目标类型绑定标签：
  • 本设备（通过参数CloudPushService.DEVICE_TARGET指定）
  • 本设备绑定的账号（通过参数CloudPushService.ACCOUNT_TARGET指定）
  • 别名（通过参数CloudPushService.ALIAS_TARGET指定，并提供别名参数）

3. 参数配置

• tags: 需要绑定的标签数组，每个App最多可定义1万个标签，单个标签字符长度最大为128个字符（中文算1个字符）。
• callback: 异步回调函数，用于接收操作结果，包含成功与失败的处理逻辑。

4. 示例代码

• Kotlin示例

PushServiceFactory.getCloudPushService()
    .bindTag(CloudPushService.DEVICE_TARGET, arrayOf("tag1", "tag2"), null, object : CommonCallback {
        override fun onSuccess(s: String) {
            // 标签绑定成功的处理逻辑
        }

        override fun onFailed(errorCode: String, errorMsg: String) {
            // 标签绑定失败的处理逻辑
        }
    })

• Java示例

PushServiceFactory.getCloudPushService().bindTag(
    CloudPushService.DEVICE_TARGET, 
    new String[]{"tag1", "tag2"}, 
    null, 
    new CommonCallback() {
        @Override
        public void onSuccess(String s) {
            // 标签绑定成功的处理逻辑
        }

        @Override
        public void onFailed(String errorCode, String errorMsg) {
            // 标签绑定失败的处理逻辑
        }
    });

5. 注意事项

• 生效时间：绑定的标签在10分钟内生效，请考虑此延迟对即时推送策略的影响。
• 数量限制：避免在单个标签上绑定超过十万级设备，以免影响推送响应速度。对于大规模设备集合，建议采用更细粒度的标签管理或全推方式。
• 异步操作：接口执行为异步模式，需通过回调处理结果。

通过上述步骤，客户端可以成功调用bindTag接口增加自定义标签，服务端则能够基于这些标签实施定向消息推送策略。