segmenting-datacloud

關於 segmenting-datacloud

這是 Salesforce Data Cloud “分段”階段所使用的技能，負責處理受眾與洞察相關的工作：包括建立併發布分段、管理計算型洞察、檢查分段的數量或成員情況，以及解決受眾相關的 SQL 問題。該技能透過 sf data360 segment 與 sf data360 calculated-insight 命令來實現功能，在需要建立分段、釋出工作流、統計成員數量或排查分段問題時會被呼叫。它將相關聯的其他工作明確分配到其他模組：DMO、對映以及身份解析任務由 harmonizing-datacloud 處理，下游啟用任務由 activating-datacloud 負責，只讀 SQL 與搜尋索引查詢由 retrieving-datacloud 處理，而標準資料模型或會話追蹤則由 observing-agentforce 負責。

在執行操作之前，該技能會收集必要的上下文資訊，比如目標組織的別名、統一的 DMO 或基礎實體名稱、使用者是要建立、釋出、檢查還是排查問題、相關資產是分段還是計算型洞察，以及預期的成功指標（成員數量、聚合值或釋出狀態）。其執行規則規定：將 Data Cloud 分段相關的 SQL 與 CRM 的 SOQL 區分開來，在修改相關資產之前會先執行 orchestrating-datacloud 技能中的共享就緒性分類器（diagnose-org.mjs，並加上 --phase segment 引數），優先使用可複用的 JSON 定義以實現重複建立時的一致性，當使用預設設定建立分段時出現不穩定情況，則使用 --api-version 64.0 引數，釋出或執行操作後要透過計數或 SQL 查詢進行驗證，不能直接假設操作已成功，而在需要可讀取的成員詳細資訊時，優先使用 SQL 連線而非直接查詢分段成員。

推薦的流程為：先對就緒狀態進行分類，檢查現有的分段與計算型洞察，根據 JSON 定義建立新的分段，明確執行釋出或執行操作，最後透過計數或 SQL 查詢進行驗證。其中需要特別注意的潛在問題包括：建立分段可能需要使用 64.0 版本的 API，分段成員查詢返回的是不可識別的 ID，即使命令很快返回結果，釋出或執行操作也可能觸發非同步處理，而出現空列表通常意味著該模組可以訪問但未配置，並非不可用。該技能會以規定的格式輸出分段任務、操作型別、目標組織、相關結果、驗證情況以及下一步操作建議。使用該技能需要外部社羣提供的 sf data360 CLI 外掛，以及已啟用 Data Cloud 功能的組織，並且相關共享的定義模板與參考資料可在 orchestrating-datacloud 技能中找到。

常見問題

該技能負責哪些工作，又會將哪些工作委託給其他模組？

它負責處理分段、計算型洞察、釋出工作流、成員數量統計以及分段相關的 SQL 問題排查。而 DMO、對映、身份解析工作由 harmonizing-datacloud 處理，啟用相關任務由 activating-datacloud 負責，只讀 SQL 與搜尋索引查詢由 retrieving-datacloud 處理，標準資料模型或會話追蹤則由 observing-agentforce 負責。

執行該技能需要什麼條件？

需要外部社羣提供的 sf data360 CLI 外掛，以及已啟用 Data Cloud 功能的組織。此外，在修改受眾相關資產之前，它還會先執行 orchestrating-datacloud 技能中的共享就緒性分類器（diagnose-org.mjs，並加上 --phase segment 引數）。

為什麼建立分段需要指定特定的 API 版本？

由於在預設設定下建立分段的功能可能存在不穩定情況，因此該技能建議在建立分段時使用 --api-version 64.0 引數，以此保證功能的穩定性。

如何獲取分段中可讀取的成員詳細資訊？

建議使用 SQL 連線來獲取資訊，而非直接使用 segment members 命令，因為後者返回的是不可識別的 ID。同時要記住，Data Cloud 分段相關的 SQL 與 CRM 的 SOQL 是不同的。

釋出或執行操作後如何確認任務是否成功？

不能直接假設操作已成功，而應該透過統計成員數量或執行 SQL 查詢來進行驗證，因為即使命令很快返回結果，釋出和執行操作也可能會觸發非同步處理流程。