Croct 平台整合與遷移 是做什麼的？
此處的每個整合皆基於已運作的 Croct SDK。它們的用途包括：輸入資料（事件、個人資料屬性）、輸出 Croct 資料（Clarity），或是在平台的內容中渲染 Slot 內容（CMS、HubSpot 表單 ID）。遷移則是用 Slots 取代其他工具的標記或體驗。
選擇整合項目
| 平台 / 目標 | 整合功能 | 安裝方法 | 參考文件 |
|---|---|---|---|
| Storyblok | Optimize 應用程式將區塊連結至 Slots；SDK 在擷取故事時交換連結區塊（JS、PHP） | Storyblok 應用程式 + croct init 或 @croct/plug-storyblok / croct/plug-storyblok | storyblok.md |
| Sanity | 使用 Sanity 內容作為 fallback 的 Slot 擷取；無需 Croct 套件 | croct init + fetchContent | headless-cms.md |
| Strapi | 透過映射 Slot 將動態區域元件對應至 Slots | 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 表單 | 提交目標、個人資料豐富化、透過 Slot 提供的表單 ID 用於測試 | 圍繞 HubSpot 嵌入的程式碼 | analytics-and-crm.md |
| 6sense, Demandbase | 將豐富的 firmographics 屬性寫入個人資料 | Croct 腳本或 GTM | firmographics.md |
| Clearbit Reveal, ZoomInfo WebSights | 透過您新增的程式碼將公司屬性寫入個人資料 | GTM 自訂 HTML | firmographics.md |
| 從 Mutiny, Ninetailed 遷移 | 概念映射和逐步替換為 Slots、受眾、實驗 | croct init + 每個區域的 Slots | migrations.md |
僅閱讀與當前平台相關的參考文件。如果未列出該平台，則表示文件沒有專屬的整合方式：請告知使用者，並在自行嘗試前檢查 https://docs.croct.com/llms.txt。
跨領域規則
- SDK 優先。 每個整合都需要在頁面或伺服器上安裝 Croct SDK。沒有它，整合腳本將無法運作。請使用
croct init進行設定，或參閱croct-integrate-sdk技能。 - 優先使用
croct init來處理 Storyblok、Sanity、Strapi、Hydrogen 和遷移。它會偵測技術堆疊並連接 SDK（對於 Storyblok JS，它會將storyblokInit包裝在withCroct中）。僅在使用者要求，或 CLI 無法連接時（例如，在不支援框架的 PHP Storyblok 環境中），才使用手動步驟。 - CMS 內容始終作為備援。 將現有的 CMS 或硬編碼內容作為
fallback傳遞，以便在請求失敗或緩慢時仍能渲染當前頁面。對於 Sanity、Strapi 和 Ninetailed，請詢問使用者預設內容應存放於何處（Croct（建議）或 CMS，透過metadata.contentSource === 'slot'設定）。請參閱 headless-cms.md。 - Croct 元件鏡像 CMS 結構描述，使用相同的屬性名稱，因此 Slot 內容和 CMS 內容可在相同的渲染元件中互換使用。
- 在發佈任何體驗或實驗之前，先追蹤目標，否則早期資料會顯示曝光但無轉換。
- 企業資訊資料在首次頁面瀏覽時不可用。 設計帳戶為基礎的體驗時，應使其在後續頁面瀏覽時啟動；首次印象可使用廣告活動、參照連結網址或地理位置。
- CQL 中的自訂屬性需移除
custom.前綴：custom.firmographics.profile.industry應寫為user's firmographics's profile's industry。個人資料最多允許 10 個自訂屬性。對於超出這些範例的情況，請參閱croct-cql技能。 - Storyblok 特定事項： Optimize 需要 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 預覽版，或非商店前端子網域的結帳網域上運作（文件已說明此 Hydrogen 的注意事項）。
- 請勿對 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=<搜尋詞彙>