Croct平台集成与迁移
此处的每个集成都建立在有效的Croct SDK之上。它们要么输入数据（事件、用户画像属性），要么输出Croct数据（Clarity），要么在平台内容中渲染槽位内容（CMS、HubSpot表单ID）。迁移则用槽位替换其他工具的标识或体验。
选择集成方式
| 平台/目标 | 集成功能 | 安装方法 | 参考文档 |
|---|---|---|---|
| Storyblok | 优化应用将块链接到槽位；SDK在故事获取期间交换链接块（JS、PHP） | Storyblok应用 + croct init 或 @croct/plug-storyblok / croct/plug-storyblok | storyblok.md |
| Sanity | 使用Sanity内容作为fallback进行槽位获取；无Croct包 | croct init + fetchContent | headless-cms.md |
| Strapi | 通过映射槽位将动态区域组件映射到槽位 | croct init + fetchContent | headless-cms.md |
| Shopify Hydrogen | 自动商店前台事件、客户识别；SDK使用位于croct-integrate-sdk技能中 | croct init（Hydrogen SDK） | ecommerce.md |
| Shopify 结账/订单（Liquid或Hydrogen） | 自定义像素跟踪checkoutStarted、orderPlaced，以及自定义事件 | 商店前台插件 + Shopify自定义像素 | ecommerce.md |
| Shopify Liquid主题 | 用于内容的JavaScript SDK；用于事件的GTM集成；用于结账的像素 | 脚本标签 | ecommerce.md |
| VTEX Store Framework（VTEX IO） | 将商店事件转发为目标和电商事件；丰富用户画像 | vtex.js脚本或GTM | ecommerce.md |
| Google Tag Manager / GA4数据层 | 将推荐的数据层事件转发为目标和电商事件 | google-tag-manager.js脚本或GTM | analytics-and-crm.md |
| Microsoft Clarity | 使用Croct体验、受众、实验变体标记Clarity会话 | clarity.js脚本或GTM | analytics-and-crm.md |
| HubSpot表单 | 提交目标、用户画像丰富、从槽位提供表单ID以进行测试 | HubSpot嵌入周围的代码 | analytics-and-crm.md |
| 6sense、Demandbase | 将丰富的firmographics属性写入用户画像 | Croct脚本或GTM | firmographics.md |
| Clearbit Reveal、ZoomInfo WebSights | 通过您添加的代码将公司属性写入用户画像 | GTM自定义HTML | firmographics.md |
| 从Mutiny、Ninetailed迁移 | 概念映射和逐步替换为槽位、受众、实验 | croct init + 按区域槽位 | migrations.md |
仅阅读当前平台的参考文档。如果平台未列出，则说明文档没有专用集成：请先说明，并在即兴操作前检查https://docs.croct.com/llms.txt。
跨领域规则
- SDK优先。 每个集成都需要页面上或服务器上的Croct SDK。没有SDK，集成脚本无法工作。使用
croct init进行设置，或参见croct-integrate-sdk技能。 - 优先使用
croct init用于Storyblok、Sanity、Strapi、Hydrogen和迁移。它会检测技术栈并连接SDK（对于Storyblok JS，会用withCroct包装storyblokInit）。仅当用户要求或CLI无法连接时（例如，在不支持的框架上使用PHP Storyblok），才使用手动步骤。 - CMS内容始终是回退。 将现有的CMS或硬编码内容作为
fallback传递，以便失败或缓慢的请求仍能渲染当前页面。对于Sanity、Strapi和Ninetailed，询问用户默认内容应放在哪里（Croct（推荐）还是通过metadata.contentSource === 'slot'保留在CMS中）。参见headless-cms.md。 - Croct组件镜像CMS模式，使用相同的属性名称，因此槽位内容和CMS内容在相同的渲染组件中可互换。
- 在发布任何体验或实验之前跟踪目标，否则早期数据会显示曝光但无转化。
- 企业特征数据在首次页面浏览时不可用。 设计基于账户的体验以在后续页面浏览时激活；首次印象使用活动、引荐来源或位置。
- CQL中的自定义属性省略
custom.前缀：custom.firmographics.profile.industry变为user's firmographics's profile's industry。用户画像最多允许10个自定义属性。超出这些示例的任何内容，请参见croct-cql技能。 - Storyblok特定： 优化需要Scale计划和Storyblok供应商批准（通过Croct支持）。表格和引用字段无法个性化。
CDN集成脚本
所有脚本从https://cdn.croct.io/plug-integration/加载：
| 脚本 | 加载位置 | 加载时机 |
|---|---|---|
google-tag-manager.js | <head> 或 <body>，或GTM | 任何时间；重放数据层 |
clarity.js | <head> 或 <body>，或GTM | 任何时间；等待Clarity |
vtex.js | <head> 或 <body>，或GTM | 尽可能早；较早的事件会丢失 |
6sense.js、demandbase.js | <head> 或 <body>，或GTM | 等待提供商识别访客 |
shopify-pixel.js | Liquid layout/theme.liquid 中 </head> 之前，带 defer | 任何时间；加载时向SDK注册 |
shopify-pixel-tracker.js | 在Shopify自定义像素内部导入 | 不适用 |
GTM标签配方（转述给用户）
对于上述“通过GTM”提供的任何脚本：标签 > 新建；命名（例如，“将数据层事件发送到Croct”）；标签类型自定义HTML；粘贴 <script src="..."> 标签；触发器 初始化 - 所有页面；保存，然后提交以发布容器。
工作流程
- 从表格中确定平台和目标；打开其参考文档。
- 确认其中列出的前提条件（账户、SDK、提供商标签、计划）。
- 进行代码更改。将仪表盘步骤（Storyblok应用、Shopify管理后台、GTM、Croct管理应用）留给用户作为简洁的清单；代理无法执行这些步骤。
- 向用户提供参考文档中的验证步骤。
询问并停止
- 如果仓库未明确说明，询问网站使用的是哪个SDK或框架。
- 对于CMS集成和Ninetailed：询问默认内容是应放在Croct还是CMS中。
- 对于Shopify像素：询问它应对所有访客运行，还是仅在分析同意后运行。这是用户的法律决定。
- 对于企业特征：询问他们许可了哪个提供商。不要添加他们没有的提供商标签。
禁止事项
- 不要为6sense或Demandbase发明属性名称；使用参考文档中的表格。
- 不要尝试使用SDK跟踪Shopify结账；结账时不运行商店前台脚本。使用像素。
- 在Hydrogen上，不要期望Shopify像素在localhost、Oxygen预览或不是商店前台子域的结账域名上工作（文档说明了此注意事项）。
- 不要对FastStore使用VTEX脚本；使用GTM集成。
- 不要从Mutiny或Ninetailed导入受众；文档说明它们已在CQL中重写。
- 不要迁移文档中没有迁移指南的工具（仅存在Mutiny和Ninetailed）；先说明并检查
https://docs.croct.com/llms.txt。
实时文档
- 索引：
https://docs.croct.com/llms.txt - 任何页面的Markdown格式：附加
.md，例如https://docs.croct.com/immersion/integrations/ecommerce/vtex.md - 搜索：
https://docs.croct.com/api/search.md?term=<terms>