公会群能力接入指南
收藏能力简介
抖音「公会群」旨在打造一个便捷化的交流互动平台，便于公会成员之间进行沟通交流，以及高效组织各类游戏相关活动 。公会长可在抖音平台自行创建公会、联盟、帮派等的专属群组，并将其与游戏内的公会进行绑定操作。绑定完成后，公会成员即可在游戏内一键加群至相应群中。
核心特性
- •一键绑定与加入：由公会长在游戏内发起，将游戏公会与抖音群轻松绑定；成员可在公会页面一键跳转至加群界面，路径极简。
- •状态实时查询：提供 JS API，允许游戏实时查询公会与群的绑定状态，从而实现动态、智能的 UI 展示（如对不同角色显示“绑定”、“加 入”或“解绑”按钮）。
- •服务端管理能力：除了公会长可在端上解绑，还提供服务端 OpenAPI，赋予开发者在后台管理绑定关系的能力，有效处理公会长账号异常等特殊情况。
- •高价值用户沉淀：将最具价值的公会玩家沉淀至私域群聊，便于进行精细化运营、活动组织和意见收集，显著提升用户留存和群活跃指标。
示例介绍
- •MMORPG/SLG 游戏：帮派、联盟林立，公会群是组织“国战”、“盟战”等大型活动的最佳阵地。
- •MOBA/FPS 游戏：固定车队、开黑小队需要便捷的沟通渠道，公会群能有效提升组队效率与战术配合。
- •休闲社交游戏：家族、社团等玩家组织可通过公会群分享游戏心得、组织线上/线下聚会，增强情感连接。
「公会群」互动案例
公会活动组织 | 攻略经验分享 | 游戏日常交流 | 游戏组队开黑 | 游戏资讯分享 |
接入收益
- •用户生命周期 ：加群前VS加群后，人均游戏时长+15.5%
- •留存：加群玩家VS小游戏玩家大盘，次日留存高33%、7日留存高27%
- •群活跃：公会群VS活跃群大盘，日均发言率高16.2%、日均进群率高28.6%
接入流程
用户分为公会长和公会成员的流程，部分页面实现逻辑（包括UI）由小游戏承接、剩余部分由平台承接。
名词 | 说明 |
公会 | 游戏内自行维护的群体，可以是帮派，群组等，通过 unionId 唯一标识 |
公会长 | 游戏内自行维护的公会的管理人员，一般给予公会长绑定和公开群的权限 |
unionId | 游戏与平台交互的主要字段，由游戏侧生成和存储，平台会记录 unionId 与 公开群的绑定信息，并提供查询/绑定/解绑 等能力 |
整体链路
接入详情
场景 | 步骤说明 | 示例截图 |
前置判断 |
| |
展示公会群信息 |
| |
绑定公会和公开群（公会长） |
| |
解除绑定公会和公开群（公会长） JSAPI 解绑必须和绑定是同一人 同时也支持游戏服务端OpenAPI 解除绑定 |
| |
加入群聊（公会成员） |
（成功加入后，也需要保留“加入群”按钮，公会成员一点就进入群聊互动） |
FAQ
- 1.Q：调用
tt.canIuse 返回 false 怎么办？A：这表示当前用户的抖音客户端版本过低，不支持公会群能力。游戏应该隐藏所有公会群相关的 UI 入口，并可以友好地提示用户“更新抖音到最新版本，体验更完整的公会功能”。- 2.Q：什么角色可以执行绑定和解绑操作？A：绑定操作没有严格的身份限制，游戏可以根据自己的逻辑，赋予公会长或管理员权限。但客户端解绑（
tt.unbindUnionGroup）有严格限制，必须由最初执行绑定的同一个抖音用户发起。如果该用户无法操作，则需要游戏服务端通过 OpenAPI 来强制解绑。- 3.Q：一个游戏公会可以绑定多个抖音群吗？A：不可以。一个
unionId 在同一时间只能绑定一个抖音群。如果需要更换群聊，必须先解绑旧的，再绑定新的。- 4.Q：解绑后，群里的成员会被踢出去吗？A：不会。解绑只是取消了游戏公会与抖音群的关联关系。群本身以及群内成员不会受到任何影响。只是后续新成员无法再通过游戏内的“一键加入”入口加群。
- 5.Q：调用
tt.joinUnionGroup 成功后，如何确定用户真的加入了群？A：出于用户隐私和平台规范，JS API 无法获取用户最终是否点击“加入”的精确结果。success 回调仅代表成功拉起了加群页面。游戏逻辑不应强依赖于用户的最终加群结果。- 6.Q：如何做好公会群能力的埋点和监控？A：建议在以下关键节点进行埋点：（1）按钮曝光：分别统计“绑定”、“解绑”、“加入”按钮的曝光次数。（2）按钮点击：统计上述按钮的点击次数。（3）API 调用结果：详细记录
tt.bindUnionGroup, tt.unbindUnionGroup, tt.joinUnionGroup 的 success 和 fail 回调次数，并记录失败时的错误码信息。这有助于排查问题和衡量转化率。