
操作指南
标签功能使用
标签是精准推送中会用到的功能,开发者可以调用移动推送(TPNS)SDK 或服务端 API,为设备绑定一个/多个标签。在完成绑定之后,就可以针对标签来进行推送,方便进行更精细化的运营。
标签推送场景
赛事订阅通知
某直播 App 10月24日18:00有一个足球比赛直播,10月20日开始开放直播预约,希望在直播开始前,给订阅这个节目的用户推送直播即将开始的通知。
在用户订阅这个节目时,可以将这个节目的主题"10241800足球"作为标签和这个用户设备 token 进行绑定,当直播快开始时,选择"足球"这个标签进行比赛即将开始的推送,当比赛完毕后,再调用 TPNS 的解绑标签接口,将"10241800足球"标签和设备 token 进行解绑。
续费通知
应用 A 希望对3天后会员到期的用户推送续费通知,假设当前某设备 token 绑定的标签为"football"和"deadline:20200210",用户在2020年2月9号续期了一个月,则此时需用"deadline:20200310"的标签将"deadline:20200210"替换掉,即 deadline 这个标签类别只能有一个值(最新值),此时可调用 TPNS 提供的 kv 覆盖接口,在不影响其他标签的情况下,解绑"deadline:20200210"标签之后,再绑定"deadline:20200310"标签,推送时(可设置定时推送),选择标签为当天时间+3天的标签,如当天日期是20200307,则可选择标签为"deadline:20200310"进行续费通知的推送。
标签概览
TPNS 目前提供了两大类标签功能,包括用户自定义标签和 TPNS 平台侧维护的预设标签,标签类别如下图所示:
使用前准备
自定义标签管理
自定义标签是指用户可根据自身业务场景,自定义设备标签名字的标签设置方式。
自定义标签使用场景及关键字
标签推送适用于标签绑定设备多(一般绑定设备数超过10个),且推送频次较少(一般该标签的日推送数不超过10次)的场景,针对绑定设备数较小且推送频次较多的标签推送场景,推荐使用账号推送,即通过账号绑定多个设备,用账号替代标签来进行推送。
关键字
冒号":"是标签绑定时的关键字,用户标签的 key-value 分割,例如用户给某个设备 token 打了"level:3"的标签,则 TPNS 后台会将"level"作为这个标签的 key,"3"作为标签的 value,这个不影响用户的实际推送,还是按"level:3"这个标签来推,key-value 方式存储主要是方便后续的同类标签的覆盖,如这个设备 token 还绑定了其他标签,如"male",即此时该设备对应两个标签,"male"和"level:3",如果这个设备对应的会员等级升级到4级了,用户希望用"level:4"标签来覆盖"level:3"标签,而不影响"male"标签,此时可直接调用 kv 覆盖接口来给这个设备设置"level:4"标签,这个设备 token 所绑定的标签则变为"male"和"level:4"。
绑定/解绑标签
TPNS 提供了单标签绑定/解绑单设备,单标签绑定/解绑多设备,多标签绑定/解绑单设备,多标签绑定/解绑多设备的接口。
单标签单设备
推荐场景
调用终端 SDK 接口,如 App 内自动获取用户订阅频道,对该频道标签和设备 token 进行绑定,反之进行解绑。
非频繁的调用 Rest API 接口,如接入测试时的调用。
标签绑定用法
标签解绑用法
使用限制
每个标签最大50个字节。
接口调用逻辑为同步。
多标签单设备
推荐场景
调用终端 SDK 接口,如 App 内自动获取用户特征信息,如年龄,省份,性别等标签信息,对这些标签和用户设备 token 进行绑定,反之进行批量解绑。
调用 Rest API 接口,如 App 运营人员从公司内其他渠道获取该设备对应的订阅信息,如单身,爱好足球,喜欢看电影等,对这些标签和该用户设备 token 进行绑定,反之进行批量解绑。
标签绑定用法
标签解绑用法
使用限制
每个标签最大50个字节。
每次调用标签数量最大500个。
接口调用逻辑为同步。
单标签多设备
推荐场景
此时只能调用 Rest API 接口,如 App 运营人员希望给所有爱好足球的用户打上足球的标签,则可利用此接口进行批量绑定,反之进行批量解绑。
标签绑定用法
标签解绑用法
使用限制
每个标签最大50个字节。
每次调用设备 token 数量最大500个。
接口调用逻辑为同步。
多标签多设备
推荐场景
此时只能调用 Rest API 接口,如 App 运营人员希望给喜欢足球的用户打上足球的标签,喜欢篮球的用户打上篮球的标签,则可以利用此接口进行批量绑定,反之进行批量解绑。
** 标签绑定用法**
标签解绑用法
使用限制
每个标签最大50个字节。
每次调用设备token数量最大500个。
接口调用逻辑为同步。
标签覆盖
TPNS 提供了两种标签覆盖方式,一是普通覆盖,二是按标签类别进行覆盖,又名 kv 覆盖,此时":"号为关键字,作为 key-value 值的分割符。
普通覆盖
推荐场景
调用终端 SDK 接口,如该设备所订阅的所有频道信息已经失效,则需要对这些频道标签和设备进行一一解绑,但需将这些频道标签遍历出来在逐个解绑,则会很不方便,故此时可调用这个接口进行覆盖。
调用 Rest API 接口,如 App 运营人员希望给设备重新设置标签,不想让这个设备受到之前标签的干扰,故可调用这个接口进行覆盖。
标签覆盖用法
使用限制
每个标签最大50个字节。
接口调用逻辑为异步,建议调用的频率间隔1秒以上。
推荐场景
调用终端SDK接口。
调用Rest API接口。
使用说明:以":"进行分割,":"前作为标签类别,":"后面的作为这个标签具体的值,例如 level:2表示该设备所在的等级为2级,假如这个设备对应的等级升级到3级,则需要先删除level:2标签,在添加level:3标签,如果客户明确知道这个设备仅有level:2这一个标签,则可调用普通覆盖接口进行覆盖,但往往一个设备会对应多个标签,如该设备还对应一个test标签,此时要精确删除level:2标签,就需要客户维护该设备对应的全部标签,或者调用信鸽tpns接口把该设备对应的历史标签查找出来再进行删除,这就带来很多的不方便,故可调用此接口,仅进行level类标签的覆盖。
标签覆盖用法
接口说明:当且仅当 tag_list 内全部标签都带有":"时,才会进行 kv 覆盖,例如该 token 已有 test,level:1标签,调用此接口后,该 token 的标签列表则变为 test, test:2, level:3。
使用限制
每个标签最大50个字节。
每次调用标签数量最大500个。
接口调用逻辑为异步,建议调用的频率间隔1秒以上。
删除标签场景
TPNS 提供了两种删除标签的方式,一是删除单设备对应的全部标签,二是删除应用对应的某标签。
删除单设备对应的全部标签
推荐场景
调用终端 SDK 接口。
调用 Rest API 接口。
使用说明: 可利用此接口将设备对应的全部历史标签删除,一般针对设备对应的过期标签,或由于运营人员操作失误,希望重新对设备进行标签设置的场景。
标签删除用法
使用限制
每个标签最大50个字节。
接口调用逻辑为异步,建议调用的频率间隔1秒以上。
删除应用对应的某标签
推荐场景
(1)此时只能调用 Rest API 接口
说明:可利用此接口将应用对应的某些标签进行删除,即对这些标签与对应绑定的设备进行全部解绑之后,在从应用的标签列表中移除,一般应用在一些彻底废弃的标签,如测试时引入的一些test标签,在正式上线之后,将这些test标签移除。
标签删除用法
使用限制
每个标签最大50个字节。
每次调用标签数量最大500个。
接口调用逻辑为异步,建议调用的频率间隔1秒以上。
预设标签管理
预设标签是指 TPNS 平台侧维护的标签,即在用户设备注册或连接到 TPNS 服务器时 SDK 自动采集的标签信息,目前 TPNS 平台维护的预设标签包括:App 版本,系统版本,省份,活跃信息,系统语言,SDK 版本,国家&地区,手机品牌,手机机型。
每个设备只会绑定最新的预设标签,并会进行自动互斥,如某设备的 App 版本当前为1.0.1,当这个设备的 App 版本升级到1.0.2时,则会自动将该设备和1.0.1版本标签进行解绑,并重新对该设备和1.0.2版本标签进行绑定。