# Segment (/zh/integrations/analytics/segment)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 336 · updated: 2026-09-23 -->
Related: [Analytics 集成](/zh/integrations/analytics/overview.md), [Adobe Analytics](/zh/integrations/analytics/adobe.md), [Amplitude](/zh/integrations/analytics/amplitude.md), [Clarity](/zh/integrations/analytics/clarity.md), [Clearbit](/zh/integrations/analytics/clearbit.md), [Fathom](/zh/integrations/analytics/fathom.md)

将你的 Segment write key 添加到 `docs.json` 文件，以将分析数据发送到 Segment。

<CodeGroup>
  <CodeBlockTabs defaultValue="docs.json 中的 Analytics 选项" groupId="-+docs-json-analytics-">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="docs.json 中的 Analytics 选项">
        docs.json 中的 Analytics 选项
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="示例">
        示例
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="docs.json 中的 Analytics 选项">
      ```json  
      "integrations": {
          "segment": {
              "key": "required",
              "cdnUrl": "optional"
          }
      }
      ```
    </CodeBlockTab>

    <CodeBlockTab value="示例">
      ```json  
      "integrations": {
          "segment": {
              "key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2",
              "cdnUrl": "https://cdn.example.com"
          }
      }
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

<div id="configuration-options">
  ## 配置选项 [#配置选项]
</div>

<ParamField path="key" type="string">
  你的 Segment write key。
</ParamField>

<ParamField path="cdnUrl" type="string">
  用于加载 Segment 脚本的自定义 CDN URL。如果你在 Segment 中配置了[自定义域名](https://segment.com/docs/connections/custom-domain/)，可以通过自己的子域名提供分析脚本，从而避免广告拦截器拦截 `cdn.segment.com`。必须是不含查询参数和片段的 HTTPS URL。默认为 `https://cdn.segment.com`。
</ParamField>
