成就系统功能介绍
开发者可以在开发者中心后台配置并发布游戏成就，玩家在游戏内触发并获得成就，从而提升玩家在游戏中的参与度，鼓励玩家以不同的玩法来玩游戏。TapTap 为游戏增加了点亮「白金成就」荣誉标识，对于那些孜孜不倦完成全部成就的玩家给予奖励。
核心优势
对于游戏开发者：
- 更多曝光： 用户可以在 TapTap 展示自己的游戏成就，从而给游戏带来更多曝光。
- 提高用户生命周期价值：建立用户成长体系（精神激励），提升玩家在游戏中的参与度。
- 数据验证：以用户分层来完善用户画像，帮助开发者用数据评估游戏内的玩法设计难易度。
- 支持多端：TapSDK 4.3.0 以上版本支持 iOS、Andriod、Unity 版本，同时包含 PC 端展示
对于游戏玩家：
- 游戏体验：成就内容的趣味性，提升玩家在游戏内的体验。
- 情绪激发：激发玩家的荣誉感、收集欲望，提升用户粘性。
- 数据资产：可以在 TapTap 记录自己的游戏里程碑。
前期准备
为了确保 TapTap 能记录到用户的成就数据，需要用户进行 TapTap 账号登录，故此建议开发者接入 TapTap 登录。 如果游戏本身自带账号系统，可以将游戏账号进行 TapTap 账号绑定。
名词解释
基础信息
| 名词 | 释义 | 规则 |
|---|---|---|
| 成就 ID | 向 SDK 上报成就的唯一标识，可以按照游戏自己的要求来定义成就 ID | 只允许英文+数字，最多可以包含 40 个字符 |
| 名称 | 成就的简称，例如「驾车高手」 | 最多可以包含 40 个字符 |
| 简介 | 成就的简要说明，通常用来告诉玩家如何获得成就，例如「驾驶汽车连续躲避 10 个障碍物」 | 最多可以包含 200 个字符 |
| 图标 | 与成就内容相关的方形图标 | 图标 UI 规则：只需要提供成就解锁时的 512×512 PNG 或 JPG 彩色图片，TapTap 会自动生成未解锁状态时的灰度版本 |
| 初始状态 | 成就的初始化状态，分为隐藏成就和显示成就 | 一旦初始设置，后续不可再修改 |
成就稀有度
获得成就人数的百分比，值越低，获得人数越少，成就就越稀有。
计算公式 = 解锁此成就的人数/使用 TapTap 账号登录人数。
为了确保稀有度的保真性，在用户触达成就模块前，引导用户进行 TapTap 登录授权
解锁状态
当玩家在游戏内触达到开发者设定的目标时，成就状态会发生改变。
- 未解锁：提交成就发布后的初始化状态，即玩家未达成成就；
- 已解锁：玩家解锁成就，分为：
- 非分步成就：当玩家触达成就后，「未解锁」状态直接变为「已解锁」状态；
- 分步成就：当玩家触达到成就某步骤数时，「未解锁」状态上会展示完成度百分比，当完成所有步骤后，状态变为「已解锁」状态。
分步成就
分步成就会让玩家用更长的时间逐步达成成就。随着玩家逐步取得成就，可以向 TapTap 上报玩家的进度。TapTap 会记录进度信息，并在玩家达到解锁该成就的必要条件时提醒游戏，同时告 知玩家成就达成。
数值范围：创建时必须定义解锁成就所需的步骤总数（此数字必须介于 2 到 100,000,000 之间）。步骤总数达到解锁值后，成就即被解锁（即使它已被隐藏）。开发者无需存储用户的累积进度。
不可重置：分步成就在游戏进程中是累积的，并且进度无法从游戏内删除或重置。例如，「赢得 20 场比赛」将被视为分步成就。而「连续赢得 5 局游戏」则不行，因为当玩家输掉游戏时，其进度将被重置。「拥有 2,000 个金币」也不符合条件，因为玩家在玩游戏时可能会获得、也会失去金币。对于后两项成就，你可以把成就名称设定为「连续获胜」或「金币总数」，并在玩家达成目标时解锁的标准成就。
隐藏成就
设为隐藏成就后，用户无法看到隐藏成就的解锁明细包括成就图片、成就名称、成就简介，只有用户解锁后才能查看。在创建时，开发者可以将自己的成就初始状态置为「显示成就」或者「隐藏成就」。
白金成就
对于高品质的游戏，当玩家获得有价值的普通成就时，会额外解锁白金成就。
定义范围：正式发布时被选为白金成就解锁条件的普通成就，未发布的成就不算在内。一旦发布了白金成就后，范围不可再被修改，即不能增加也不能移除。
白金徽章：开通白金成就后，TapTap会为游戏定制专属的白金徽章，当用户解锁白金成就时，也能佩戴上对应的白 金徽章。
功能说明
创建普通成就
要为新游戏创建一个成就，你可以在开发者中心、游戏服务下找到开发与构建标签。选择成就菜单，然后点击创建普通成就。
填写成就的相关信息，点击保存，这个成就进入到审核中状态。审核通过后状态会置为待发布，审核不通过后状态会置为已驳回。
编辑普通成就
成就发布前，需要编辑已经创建的成就，请在成就列表里点击编辑。此时，可以看到与第一次创建成就时一样的配置页面，根据需要进行编辑。
一旦成就发布后，成就 ID、分步成就、成就分组和初始状态这四项配置将无法修改。
成就测试
- 开发者可以前往「测试」Tab 下，可以添加若干个非注销的TapTap 账号成为测试人员，最多可以添加 100 个；
- 测试人员可以体验到「审核中」「已驳回」「待发布」状态的成就数据，来进行测试；
- 在进行测试后发现数据不合理，修改了后想重新测试，只需「重置进度」或「删除成就」即可；
- 如果测试人员的数据在发布前，没有进行重置，是会带到正式环境的，和其他用户的数据共同展示（注：是否需要删档测试，取决于运营需求）。
- 在发布前，仅「游戏管理员」和「测试人员」可以预览成就用户端的页面，确保配置和数据上报正确。
- 注意，白金成就无法测试，即使测试人员完成普通成就也不会解锁待发布状态的白金成就。
发布普通成就
当成就测试完毕后，将处于待发布状态，至少要完成创建 5 个普通成就才能发布，点击发布成就，所有成就将发布到正式环境，请谨慎操作。
删除/重置成就
成就发布前，通过点击成就列表末尾的按钮，来删除和重置未发布的成就。
成就发布后，不能被删除和重置 。
创建白金成就
为了确保白金成就的质量，在创建白金成就时审核人员会根据游戏质量是否高于平均水品来判断审核结果。详细请参考**白金成就审核标准**。
拥有白金成就的游戏在 TapTap 上会有显眼的白金奖杯标识，可以给游戏带来不错的品质提升和效应传播，从而获得更多的曝光。
为了确保白金成就的挑战性，开发者需要创建 10 个白金解锁条件内的普通成就后，才能创建白金成就，提交时需要配置图标、名称和简介，当白金成就审核通过后，就可以发布了。
白金成就审核标准
审核标准
-
不适用于评分低于 5 分的游戏
-
游戏关注量大于 5 万的游戏
-
游戏时长或内容量在同品类产品中处于较为正常的水平（除特殊情况）
-
不接入io游戏
-
不接入玩法单一的益智游戏（如数独）
-
不接入休闲小游戏
-
不接入传奇类游戏
-
不接入纯视觉小说（无互动、无选项，无多路线）
-
免费游戏中，用户不需要付费，仍然可以获得所有成就
-
付费游戏中，用户不需要购买DLC或其他内购，仍然可以获得白金成就。
-
游戏不破坏平台整体调性
推荐成就类型
| 类型 | 范例 |
|---|---|
| 进度类 | 人物等级提升至20级 |
| 首次类 | 第一次使用传送点系统 |
| 挑战类 | 10秒内击杀XX |
| 彩蛋类 | 发现隐藏 Npc |
| 排行类 | XX拿到第一名 |
| 收集类 | 获得所有卡牌（非付费内容） |
| 成就类 | 获得其他所有成就（即白金成就） |
平台禁止使用成就类型
-
氪金总量类（如累计充值等）
-
明显的引导攀比类
-
引导好评等
-
其他违反法律、普世价值观等等
-
广告类
发布白金成就
发布白金成就后，无法再更改白金成就解锁条件，如果发生误操作不小心发布了成就，请在带成就包体上架前 3 天工单告知我们，及时为游戏进行调整。 另外，在发布后的 2 周内，TapTap 会为有白金成就的游戏，额外制作白金徽章，当玩家解锁白金成就时，就能佩戴专属徽章啦！
游戏内成就通知
- 当玩家在游戏中触发成就行为，在游戏顶部推送冒泡。界面的成就队列只有 1 条，如同时触发多条成就，则会排队显示。
- 开发者对于游戏内的成就展示页和冒泡通知可以选择显示或隐藏。
游戏内查看成就
- 若用户安装了 TapTap 客户端，可以在游戏内直接拉起端内的成就页面
- 若用户没有安装 TapTap 客户端，可以在游戏内 Webview 打开成就页面
需要用户在游戏内进行过 TapTap 登录授权
TapTap 上展示成就
- TapTap 登录游戏：使用 TapTap 登录的玩家可以直接在 「TapTap 客户端-我的-游戏成就」查看已解锁和未解锁的游戏成就。
- 非 TapTap 登录游戏：如果游戏本身存在账号体系，需要游戏自己绘制一个 TapTap 账号绑定入口，将游戏账号和 TapTap 账号关联起来，将成就数据同步到 TapTap 上。
- 当单个成就解锁人数达到 200 时，才能展示该成就玩家解锁百分比数据。
关于绑定 TapTap 账号的两种场景如何处理
- 场景 1：用户有一个非 TapTap 登录账号（账号 A），和一个没登录过游戏的 TapTap 号，需要游戏这里做账号绑定，那 TapTap 上展示的是账号 A 的成就数据
- 场景 2：用户有一个非 TapTap 登录账号（账号 A），和一个已经登录过游戏的 TapTap 号（账号 B），那 TapTap 上展示的是账号 B 的成就数据。那如果用户想要展示账号 A 的数据，那就游戏自身需要有解绑账号的功能，即把账号 B 和 TapTap 账号解除绑定，把 TapTap 账号置换出来和账号 A 进行绑定
接入说明
接入准备
- 入驻成为 TapTap 的开发者；
- 在 TapTap 开发者中心创建游戏应用，且需要开通「游戏服务」生成应用配置；
- 若要给子账号添加权限，请至「权限管理」中给该账号设置「游戏管理员」权限；
- 下载 TapSDK（最低支持版本 v4.3.0）集成到游戏包内。
接入流程
接入指南
见 成就系统 > 开发指南。
常见问题
游戏上线了，还能再申请「白金成就」吗？
白金成就不受游戏上线的影响。既能在游戏上线前创建好白金成就，也可以在游戏上线后创建。
「白金成就」审核时，还能发布新的普通成就吗？
白金成就的申请和创建并不影响普通成就的发布，可以随时提交已经准备好的普通成就。
在申请「白金成就」通过前，玩家已经获得全部成就了，还能补领吗？
如果有玩家在白金成就发布前，已经获得到全部的普通成就，再为游戏创建白金成就时，玩家依然可以自动获得。
如果已经是上架的老游戏了，对于已经使用自建账户登录或者第三方登录的用户，怎么接入使用 TapTap 成就系统呢？
答：针对老用户来说，就使用自建账号/第三方账号登录，登录后需要调用 TapSDK 的绑定接口，对老用户进行绑定。绑 定成功后，需要同步本地的成就数据给到 TapTap 成就服务。如果是新用户的话，直接 TapTap 登录就可以了，就不需要进行绑定这一步骤了。
如果是已经上架的老游戏接成就系统，那老用户已经完成过的成就，还能再触发吗？
老用户已完成的数据有两个方式可以同步：
- 通过服务器 API 的方式提前同步一份数据到 TapTap 成就服务；
- 若游戏本身记录了成就达成的数据，那么游戏找合适的时间点把以前记录的数据转化为「成就 ID」通过 SDK 达成一次（注：需要临时关一下通知，不然顶部会有多个提醒通知）。
如果玩家已经解锁了「白金成就」，开发者在后台又新增了一个普通成就，玩家的「白金成就」标志会消失吗？
不会，白金成就的范围在发布后是不会修改的，新创建的普通成就不会被计算在白金解锁条件范围内，故也不会影响白金成就。
游戏有多个区服或可以创建多个角色，如果重复获得成就，SDK 的逻辑是怎样的？
成就记录跟着账号走，每个成就只记录第一次获得的行为，之后重复获得将不做展示。