抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

群标签能力接入方案

收藏
我的收藏

一、能力介绍

群标签能力是抖音小游戏继粉丝群、官方群后提供的第三大群聊能力。接入此能力后,可以满足群粉丝在群内聊天时,在群昵称后自动携带由厂商配置的称号标签,且点击标签即可查询获得方式以及启动游戏。
接入收益:
    1.丰富群聊话题,增加粉丝聊天积极性,提高群的整体活跃度
    2.增加群内复访游戏入口,提高用户留存

二、业务路径

三、能力示意

    1.群主选择标签

官方群管理员&游戏公会粉丝群群主默认可见对应游戏的标签选项,其他游戏铭牌需厂商申请挂载
群聊设置页
标签选择页
选择小游戏标签

    2.群聊展示标签(粉丝自动携带)

群聊发现铭牌
点击铭牌查看铭牌卡&游戏入口
铭牌规则详情页&游戏入口

四、标签配置流程

    1.找到能力入口

登录开放平台,找到「运营能力」-「用户留存」-「游戏群标签能力」

    2.完成基础配置

基础配置指的是配置铭牌卡的背景图,此图应用于该游戏的所有标签卡片。
若调整背景图,将同步更新所有标签卡片;
最多可上传1张图,图片尺寸400*180,大小不超1M,支持 jpg、jpeg、png 格式
图片上传后会进入审核链路,审核结果将通过开放平台站内信同步
基础配置入口
上传背景图

    3.新增标签配置

新增标签配置指的是配置标签的展示文案,包括名称、获取规则、有效期、标签 ICON、标签颜色
注意:这里不涉及任何接口能力,只是用于配置标签的展示样式。
成功提交后进入审核流程,审核通过会以站内信&端内通知,审核通过后可以获得标签 id 用于技术配置!单游戏最多上架9个标签
新增标签入口
配置标签文案&图片素材

    4.通过接口完成标签下发

下发方式详见下方技术接入指引

五、技术接入指引

open api

js api

c# api

六、示例

本期一个用户只能展示一个标签,后续才会支持多个标签且能够顺延标签(比如第4个场景,二期才会支持顺延为123)
目前新的下发标签会替换掉上一个标签,平台不存上一个标签是什么
下发和删除操作
结果
    1.下发后删除
    a.给 A 用户佩戴一个标签 123
    b.给 A 用户删除一个标签 123
无标签
    2.连续下发标签
    a.给 A 用户佩戴一个标签 123
    b.给 A 用户佩戴一个标签 456
佩戴 456
    3.删除最早的一个标签
    a.给 A 用户佩戴一个标签 123
    b.给 A 用户佩戴一个标签 456
    c.给 A 用户删除一个标签 123
佩戴 456
    4.删除最后一个标签
    a.给 A 用户佩戴一个标签 123
    b.给 A 用户佩戴一个标签 456
    c.给 A 用户删除一个标签 456
无标签