如何为你的 Open Badges 添加 LinkedIn“添加到个人资料”按钮

刚刚获得一份凭证的收件人，正处在这枚徽章整个生命周期中最有动力的一刻。他们完成了课程、通过了考试、达成了里程碑——在大约三十秒的时间里，他们希望全世界(或者至少是他们的人脉圈)知道这件事。如果接下来的步骤是“下载 PDF、打开 LinkedIn、点击添加个人资料板块、手动输入认证名称、颁发机构和凭证 URL，还要祈祷日期没打错”，大多数人会直接关掉这个页面。

LinkedIn 的“添加到个人资料”按钮消除了上述每一个手动步骤。收件人只需点击一次，LinkedIn 就会打开一个已经预填好的认证对话框，他们确认后，凭证就会出现在其许可证和认证栏目中——颁发机构正确、名称正确，还带有一个直接指向你公开验证页面的链接。在 badges.ninja 上，这并不是一个需要你另行开发的集成，而只是颁发者资料中的一个字段。

这个按钮到底做了什么

LinkedIn 的“添加到个人资料”功能依赖于一个格式特定的 URL。当有人点击它时，LinkedIn 会读取一些查询参数——认证名称、颁发机构、颁发日期以及一个认证 URL——然后打开“添加认证”表单，并预先填好这些字段。收件人查看确认后点击保存，认证就会显示在他们的资料上。

让大多数颁发者感到困惑的，往往不是 URL 的格式，而是“颁发机构”这个字段。LinkedIn 在这里并不接受任意的公司名称字符串，它需要的是你所在组织的 LinkedIn 公司主页，通过 ID 来解析，这样凭证才能显示你的徽标，并链接回你的官方主页，而不是渲染成一段没有链接的纯文本。这就是徽章平台在生成一个可用按钮之前，唯一需要你提供的信息，也是这篇指南要讲解的唯一一步。

第 1 步：找到你的 LinkedIn 组织 ID

如果你为自己的组织管理着一个 LinkedIn 公司主页，那么这个 ID 在你自己的管理员视图中就能看到：

1. 前往你所在组织的 LinkedIn 主页，点击管理员工具 → 以成员身份查看(或者在以管理员身份登录的情况下直接跳转过去)。
2. 查看 URL。对于一个公司主页，它看起来会是 linkedin.com/company/12345678/admin/ 这样的形式——其中的数字就是你的组织 ID。
3. 如果你自己并不管理这个主页(比如由合作伙伴负责你们的 LinkedIn 主页)，请向管理者索要这个数字 ID，而不是那个自定义 URL 短名——自定义名称(/company/acme-training/)和数字 ID 是两回事，按钮需要的是数字。

把这个 ID 记下来备用，这是你唯一需要的新信息。

第 2 步：把它粘贴到你的颁发者资料中

badges.ninja 上的每个颁发者都有一个设置页面。打开你的颁发者，把 LinkedIn 组织 ID 字段和其余的颁发者信息——名称、邮箱、徽标——一起添加进去。这和你第一次注册颁发者时填写的是同一个表单，所以如果你是回来重新查看，会很熟悉这个界面布局。

保存好，就完成了。这里没有独立的 LinkedIn OAuth 流程，没有应用审核，也不需要和 LinkedIn 开发者控制台交换 API 密钥。组织 ID 是一个公开标识符——你并不是在以你的 LinkedIn 主页身份进行身份验证，只是在告诉 badges.ninja，在为你的收件人生成预填 URL 时，应该引用哪一个公司主页。

因为这个字段是设置在颁发者层面，而不是每个徽章上，所以它会追溯生效。绑定到该颁发者的每一份凭证——不论过去还是未来颁发的——都会在下一次其验证页面渲染时自动获得这个按钮。你不需要重新颁发任何东西，也不需要去修改单个徽章类别。

第 3 步：收件人看到的效果

一旦设置好组织 ID，该颁发者名下每一份凭证的验证页面和 PDF 证书，都会包含一个添加到 LinkedIn 个人资料按钮。从收件人的角度看，流程是这样的：

1. 打开自己的凭证——可以从 badges.ninja/me 的收件人门户、邮件里的验证链接，或是公开的验证页面进入。
2. 点击添加到 LinkedIn 个人资料。
3. LinkedIn 会打开自带的“添加认证”对话框，其中已经预填好凭证名称、你的组织(带徽标，并正确关联)、颁发日期，以及指向公开、可验证凭证页面的凭证 URL。
4. 确认后点击保存。

不需要复制粘贴徽章名称，不需要猜“凭证 URL”这个字段该填什么，也不用担心一次打字错误就把一份真实凭证变成资料上一行无法验证的文字。整个交互耗时不到十秒，而这一点很重要——在“我获得了这个”和“这已经出现在我的资料上”之间，每多一个步骤，都是收件人可能放弃的地方。

关于排查问题的简短说明

有两件事会导致按钮出问题，在假设是系统故障之前，这两点都值得先检查一下：

• ID 格式不对。 如果你粘贴的是自定义短名(acme-training)而不是数字 ID(12345678)，LinkedIn 的预填要么静默失败，要么解析到错误的组织。请一定从管理员界面的 URL 中获取数字，而不是从主页的公开 URL 中获取。
• 主页可见性问题。 如果你的 LinkedIn 公司主页尚未发布或仍是草稿状态，即使 ID 正确，LinkedIn 也无法解析这个组织引用，认证就会显示为没有链接。请先发布主页，然后再设置 ID。

除此之外，没有其他需要维护的东西。这个按钮不是一个可能宕机的实时集成——它是 badges.ninja 在渲染时，根据公开、稳定的标识符构建出来的一个 URL。你不需要担心 LinkedIn 的 API 配额，不需要刷新令牌，也不需要监控 webhook。

和手动方式对比一下

如果没有预填按钮，想把你的凭证添加到 LinkedIn 的收件人就得手动操作：打开 LinkedIn，进入个人资料，点击添加个人资料板块 → 许可证和认证 → 添加，然后手动输入认证名称(还要希望它和你徽章的确切标题完全一致)，按名称搜索你的组织(还要希望能解析到正确的主页——LinkedIn 的搜索结果里经常出现名称相近的公司)，凭记忆选一个颁发日期，再粘贴一个得从邮件或下载的 PDF 里翻找出来的验证 URL。

这些步骤里的每一步，都是放弃这个任务的一次机会。组织名称填错了，凭证要么显示为没有链接的文字，要么关联到错误的公司。漏掉了凭证 URL，招聘者就没有任何东西可以点击验证。手动流程并非不可行——很多人现在仍然这么做——但它带来了摩擦，而摩擦恰恰会拉低分享率，本该是颁发机构免费广告的凭证，因此而受损。

预填按钮消除了每一个决策点。收件人不需要选择该填什么，只需要确认已经正确的内容。

为什么这不仅仅关乎收件人体验

每一份被添加到 LinkedIn 的凭证，都是颁发机构的一则持久的小型广告。它会出现在收件人人脉圈的信息流里，永久留在其资料页面上并带有你的徽标，还链接到一个公开的验证页面，任何人——招聘者、另一位潜在学员、合作机构——都可以点击确认它是真实的。这正是 Open Badge v2.0 设计的初衷：让凭证具备可移植性，并能被独立验证，而不是把成就证明困在一个只有收件人自己能看到的平台里。

设置了 LinkedIn 组织 ID 字段的颁发者，其分享率会持续显著高于让收件人自行手动操作的颁发者——原因并不是凭证本身更有分量，而是省去了五分钟繁琐的手动录入，把意愿转化成了实际行动。如果你的项目依赖校友可见度、雇主信号，或是口碑增长(比如训练营、认证机构、会议主办方)，这一个字段就是你能对颁发者设置做出的、性价比最高的改动之一。

关于徽章设计和 LinkedIn 预览效果的一点说明

LinkedIn 会在认证条目旁边显示你的徽章图像，因此值得确保用于面向 LinkedIn 的凭证的徽章，在被裁切到很小尺寸时仍然清晰可辨——无论是在个人资料视图还是信息流分享预览中，LinkedIn 显示的认证图标都相当小。如果你还没设计好自己的可视化徽章，可以先看看如何设计你的第一张可验证证书，再开始引导收件人去点击“添加到个人资料”按钮；一个轮廓清晰、机构品牌标识明显的徽章，一旦出现在别人的资料上，会获得更多点击和分享。

大规模设置

如果你正在为一整个批次颁发凭证——一个训练营的毕业班、一场会议的完整参会名单、一次季度合规培训的全面推广——LinkedIn 组织 ID 只需要按颁发者设置一次，而不是按收件人或按徽章逐一设置。把它和批量颁发结合起来，同一批次里的每个收件人都会自动获得同样的预填按钮。批量颁发的完整流程，请参见如何从 CSV 批量颁发 Open Badges——把它和这里的 LinkedIn 设置结合起来，一整个班级就能在同一个下午内，从“培训完成”走到“凭证已在 LinkedIn 上线”。

也值得想一想，这和 LinkedIn 自带的认证工具相比如何。LinkedIn 技能测评完全存在于 LinkedIn 内部——没有颁发机构的品牌标识，没有外部验证页面，如果收件人日后想在 LinkedIn 之外的场合证明这份凭证，也没有可移植性。而带有“添加到个人资料”按钮的 Open Badge，能让你两头兼得：既通过招聘者已经在用的“许可证和认证”这同一个入口，获得完整的 LinkedIn 可见度，又拥有一份基于标准、可独立验证、不受限于单一平台的凭证。关于什么时候该用哪一种(或者更常见的，两者搭配使用)，可以进一步阅读LinkedIn 技能测评对比 Open Badges。

如果你管理不止一个颁发者呢？

拥有多个颁发者资料的组织——比如一所大学各院系分别设有颁发者，或是一家代理机构为多个客户品牌颁发凭证——经常会问，LinkedIn 组织 ID 是否必须全部保持一致。答案是不需要。badges.ninja 上的每个颁发者都独立拥有自己的 LinkedIn 组织 ID，因此，一个自己运营着 LinkedIn 公司主页的院系，可以把收件人引导到该主页对应的凭证上；而没有自己主页的院系，既可以把这个字段留空(收件人就会走手动录入的路径)，也可以指向母组织的主页。并没有规定要求同一个账号下的所有颁发者必须共用同一个 LinkedIn 身份。

这也意味着，如果你以后重组架构，这套设置也能顺利延续下去。如果某个子品牌在沿用母组织 ID 颁发了一年之后，才建立起自己的 LinkedIn 公司主页，那么只需要更新那一个颁发者上的字段就够了——所有已经颁发的凭证，以及此后颁发的每一份凭证，都会在其验证页面下一次加载时自动采用新的组织 ID。不需要重新颁发、批量回填，也不需要迁移任何东西。

小结

1. 在你 LinkedIn 公司主页的管理员视图中，找到组织的数字 ID。
2. 把它粘贴到你在 badges.ninja 上的颁发者设置中。
3. 该颁发者名下的每一份凭证——不论是已颁发的还是未来颁发的——都会显示一个“添加到个人资料”按钮。
4. 收件人只需点击一次，确认预填好的对话框，凭证就会正确地关联到他们的资料上。

不需要开发时间，不需要 LinkedIn 应用审核，也不需要按徽章逐一配置。在颁发者层面设置一次，此后每一份新凭证都能从中受益。

准备好颁发你的第一份可验证凭证了吗？ 在 badges.ninja 免费开始——可视化设计器、公开验证页面、PDF 证书、Open Badge v2.0 输出。无需信用卡。