分析与会话回放服务商
用一个 docs.json 配置块接入 13 个分析、回放和身份服务商。
Jamdesk 会直接从 docs.json 为 13 个额外的分析、会话回放和身份识别服务商加载脚本。在 integrations 下添加服务商配置块，Jamdesk 就会在已发布文档网站的每个页面注入其脚本。
Jamdesk 只会在每个值符合严格格式时加载脚本。格式错误的值（多余字符、前缀错误或长度错误）会被静默跳过，且永远不会渲染——不会显示错误页面，也不会生成损坏的脚本标签。如果服务商未加载，请从其仪表板重新复制值，并根据下方格式进行检查。
从仪表板配置
配置这些服务商最快的方法是：Dashboard → Integrations。选择一个服务商卡片，粘贴其密钥，Jamdesk 会为你提交 docs.json 配置块并触发重新构建（仅限已连接 GitHub 的项目）。以下部分适用于直接编辑 docs.json，或仅使用 CLI 的项目。
PostHog
产品分析、会话回放和功能标志。
**格式：**项目 API 密钥以 phc_ 开头，后跟 8-64 个字母或数字。可选的 API 主机必须是 https:// URL。
在 PostHog 中，前往 Settings → Project → Project API key 查找密钥。
{
"integrations": {
"posthog": {
"apiKey": "phc_Kj8fPqZx92RmNbTeYcWs",
"apiHost": "https://us.i.posthog.com"
}
}
}apiHost 为可选项，默认为 https://us.i.posthog.com。如果使用欧盟云主机或反向代理 URL，请将其设置为相应地址。
Mixpanel
事件分析和漏斗分析。
**格式：**项目令牌必须正好包含 32 个小写十六进制字符（0-9、a-f）。
在 Mixpanel 中，前往 Project Settings → Access Keys → Project Token 查找令牌。
{
"integrations": {
"mixpanel": {
"projectToken": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}
}
}Amplitude
产品分析和行为群组。
**格式：**API 密钥必须正好包含 32 个小写十六进制字符（0-9、a-f）。
在 Amplitude 中，前往 Settings → Projects → your project → API Key 查找密钥。
{
"integrations": {
"amplitude": {
"apiKey": "f6e5d4c3b2a1908877665544332211ff"
}
}
}Hotjar
热图和会话录制。
**格式：**网站 ID 为 1-12 位数字。代码段版本为 1-4 位数字（通常为 6）。
在 Hotjar 中，前往 Sites & Organizations → your site 查找这两个值。
{
"integrations": {
"hotjar": {
"hjid": "3482910",
"hjsv": "6"
}
}
}Hotjar 会记录访问者会话。如果 GDPR、CCPA 或类似法规适用于你的读者，请将其置于 Cookie Consent 之后。
Microsoft Clarity
免费的热图和会话录制。
**格式：**项目 ID 为 4-32 个字母或数字。
在 Clarity 中，前往 Settings → Overview → Project ID 查找项目 ID。
{
"integrations": {
"clarity": {
"projectId": "qbxk2paw9m"
}
}
}Clarity 会记录访问者会话。如果 GDPR、CCPA 或类似法规适用于你的读者，请将其置于 Cookie Consent 之后。
Fathom
以隐私为先、无 Cookie 的分析。
**格式：**网站 ID 为 4-16 个字母或数字。
在 Fathom 中，前往 Settings → Sites → your site 查找网站 ID。
{
"integrations": {
"fathom": {
"siteId": "ABCD1234"
}
}
}Pirsch
无 Cookie、注重隐私的分析。
**格式：**识别码为 4-64 个字母或数字。
在 Pirsch 中，前往 Settings → Developer → Identification Code 查找识别码。
{
"integrations": {
"pirsch": {
"id": "Jd8fK2pQmZx9AeRt"
}
}
}Heap
自动捕获事件，无需手动插桩。
**格式：**应用 ID 为 6-20 位数字。
在 Heap 中，前往 Account → Manage → Projects 查找应用 ID。
{
"integrations": {
"heap": {
"appId": "1234567890"
}
}
}LogRocket
结合控制台和网络日志的会话回放。
**格式：**应用 ID 由两个以斜杠分隔的 slug 段组成——org-slug/app-slug——每段包含 2-64 个小写字母、数字或连字符。
在 LogRocket 中，前往 Settings → Project Setup 查找应用 ID。
{
"integrations": {
"logrocket": {
"appId": "acme-inc/docs-site"
}
}
}LogRocket 会记录访问者会话，包括控制台和网络活动。如果 GDPR、CCPA 或类似法规适用于你的读者，请将其置于 Cookie Consent 之后。
Segment
从一个来源将文档事件路由到所有下游工具。
**格式：**写入密钥为 10-64 个字母或数字（不能包含连字符或下划线）。
在 Segment 中，前往 Connections → Sources → your JS source → Settings → API Keys 查找写入密钥。
{
"integrations": {
"segment": {
"key": "hcQ8wK9pXeR2mNq7"
}
}
}Clearbit
识别并丰富匿名访问者信息。
**格式：**公共 API 密钥以 pk_ 开头，后跟 6-64 个字母或数字。
{
"integrations": {
"clearbit": {
"publicApiKey": "pk_4f8a2e1c9b6d"
}
}
}Hightouch
将文档事件直接发送到数据仓库。
**格式：**写入密钥为 8-128 个字符（字母、数字、:、.、_、-）。可选的 API 主机为 4-64 个字符（字母、数字、.、-）。
{
"integrations": {
"hightouch": {
"writeKey": "wk_prod_4f8a2e1c9b6d",
"apiHost": "us-east-1.hightouch-events.com"
}
}
}apiHost 为可选项——仅在使用自托管或特定区域的 Hightouch 事件端点时需要设置。
Koala
识别高意向访问者，用于销售和营销。
**格式：**公共 API 密钥以 pk_ 开头，后跟 6-64 个字母或数字。
{
"integrations": {
"koala": {
"publicApiKey": "pk_7e3a9c1f6b2d"
}
}
}同意控制
上述全部 13 个服务商都支持 integrations.cookies。设置该项后，所有服务商的脚本都会等到同意横幅记录批准后才加载——完整设置请参阅 Cookie Consent。未设置时，每个脚本都会在页面加载时为所有访问者加载。