使用别名与标签：精准推送的核心手段

一、核心概念说明

1. 别名（Alias）：业务ID与推送ID的绑定

别名用于将业务系统中的用户唯一标识符（如 userID、手机号、邮箱等）与 EngageLab 推送系统中的 注册ID（registrationID / UID） 建立一对一映射。

注册ID 是 WebPush 或 AppPush SDK 为每个用户生成的唯一标识，用于推送消息识别，通常对业务方无实际意义，且与设备无强绑定关系。

核心特征：

• 🧩 一对一绑定： 每个注册ID只能绑定一个别名。
• 🧠 业务可识别： 使用业务系统原有的用户ID，方便业务逻辑。
• 🔒 持久有效： 除非显式解绑，绑定关系将长期有效。

应用示例：

• 订单状态变更推送（如：user123 订单已发货）
• 账户安全通知（如：user456 密码修改）

2. 标签（Tag）：基于属性的动态分组

标签用于标记用户的属性、行为或状态，实现用户群体的动态划分和分组推送。

核心特征：

• 🔁 多对多关系： 一个注册ID可拥有多个标签，一个标签下也可对应多个用户。
• 📈 实时变动： 支持动态增删标签，响应用户行为变化。
• 🧱 支持多维度： 如「VIP会员」、「近30天未登录」、「iOS用户」

应用示例：

• 对“连续3天未登录的VIP用户”推送激活奖励
• 对“购物车有商品但未结算”的用户进行限时提醒

二、为什么使用别名与标签？

🎯 解决的问题

EngageLab 的推送注册ID由 SDK 自动生成，与业务系统用户无直接关系。要实现业务识别级别的精准推送，开发者需要：

• ✅ 将业务系统中的 用户ID → 注册ID 建立绑定（使用别名）
• ✅ 按业务需求将用户划分为不同分组（使用标签）

✨ 核心价值总结

三、使用方式详解

1. 设置别名与标签

✅ 服务端 API 设置

• 文档链接：设置别名和标签

• 示例请求：

              
              POST /v4/devices/{registration_id}
{
    "tags": {
        "add": [
            "VIP",
            "iOS用户"
        ]
    },
    "alias": "user_5678"
}

            

✅ 客户端 SDK 设置

• Web SDK：setTagsAlias
• Android SDK：标签与别名 API
• iOS SDK：标签与别名 API

2. 发起推送

✅ 控制台操作

• 在推送创建页选择标签或别名用户群体

✅ API 调用方式

• 文档链接：创建推送 API

• 示例请求：

              
              POST v4/push
{
    "from": "push",
    "to": {
        "tag": [
            "VIP"
        ],
        "tag_and": [
            "未登录30天"
        ]
    },
    "body": {
        "platform": "all",
        "notification": {
            "alert": "Hi, MTPush!",
            "android": {
                "alert": "回归好礼",
                "title": "亲爱的VIP用户，欢迎回来！立即领取专属优惠"
            },
            "ios": {
                "alert": {
                    "title": "回归好礼",
                    "body": "亲爱的VIP用户，欢迎回来！立即领取专属优惠"
                }
            }
        }
    }
}

            

四、最佳实践推荐

✅ 三层标签体系设计建议

五、常见问题与注意事项

六、总结

通过合理配置别名与标签，开发者可以：

• 🧠 减少开发复杂度和维护成本
• 📊 提升推送精准度、转化率和ROI
• 🔄 覆盖用户从激活到留存的完整生命周期

👉 更多资料请参考 EngageLab 开发文档