使用分段服務API建立區段

本檔案提供使用Adobe Experience Platform Segmentation Service API來開發、測試、預覽和儲存區段定義的教學課程。

如需如何使用使用者介面建立區段的詳細資訊，請參閱區段產生器指南。

快速入門

本教學課程需要對建立觀眾區隔時涉及的各種Adobe Experience Platform服務有深入的瞭解。在開始本教學課程之前，請先閱讀下列服務的檔案：

Real-time Customer Profile:根據來自多個來源的匯整資料，提供統一、即時的消費者個人檔案。
Adobe Experience Platform Segmentation Service:可讓您從即時客戶個人檔案資料建立受眾細分。
Experience Data Model (XDM):組織客戶體驗資 Platform 料的標準化架構。

以下各節提供您必須知道的其他資訊，才能成功呼叫Platform API。

讀取範例API呼叫

本教學課程提供範例API呼叫，以示範如何設定請求的格式。這些包括路徑、必要標題和正確格式化的請求負載。也提供API回應中傳回的範例JSON。如需範例API呼叫檔案中所用慣例的詳細資訊，請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。

收集必要標題的值

若要呼叫Platform API，您必須先完成驗證教學課程。完成驗證教學課程後，所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面：

授權：載體{ACCESS_TOKEN}
x-api-key:{API_KEY}
x-gw-ims-org-id:{IMS_ORG}

Experience Platform中的所有資源都隔離到特定的虛擬沙盒。對Platform API的所有請求都需要一個標題，該標題指定要在中執行操作的沙盒的名稱：

x-sandbox-name:{SANDBOX_NAME}

注意

如需Platform中沙盒的詳細資訊，請參閱沙盒概述檔案。

所有包含裝載(POST、PUT、PATCH)的請求都需要額外的標題：

內容類型：application/json

開發區段定義

分段的第一步是定義分段，在稱為分段定義的構造中表示。段定義是一個對象，用於封裝寫入Profile Query Language (PQL)中的查詢。此對象也稱為PQL謂語。 PQL謂語根據與您提供給Real-time Customer Profile的任何記錄或時間系列資料相關的條件定義段規則。有關編寫PQL查詢的詳細資訊，請參見 PQL指南。

您可以透過向Segmentation API中的/segment/definitions端點提出POST請求，建立新的區段定義。下列範例概述如何設定定義請求的格式，包括成功定義區段所需的資訊。

有關如何定義區段的詳細說明，請閱讀區段定義開發人員指南。

預估並預覽觀眾

當您開發區段定義時，可使用Real-time Customer Profile中的估計和預覽工具來檢視摘要層級資訊，以協助您隔離預期的觀眾。估計值提供區段定義的統計資訊，例如預計讀者大小和信賴區間。預覽提供區段定義的合格設定檔分頁清單，讓您比較結果與預期結果。

透過估計和預覽受眾，您可以測試和最佳化PQL謂語，直到產生可預期的結果，然後在更新的區段定義中使用。

預覽或取得區段估計需要兩個步驟：

建立預覽工作
使用預覽工作的ID檢視估計或預覽

如何產生估計

資料樣本可用來評估區段並估計符合資格的設定檔數目。每天早上（12AM-2AM PT，即7-9AM UTC），新資料會載入記憶體中，所有區段查詢都會使用當天的樣本資料來估計。因此，新增的欄位或收集的其他資料，都會反映在次日的估計值中。

範例大小取決於您描述檔商店中的實體總數。下表列出了這些樣本大小：

描述檔儲存中的實體	樣本大小
不到100萬	完整資料集
1000萬到2000萬	100萬
超過2000萬	總共5%

估計值一般會持續10-15秒，從粗略的估計開始，並隨著讀取更多記錄而調整。

建立預覽工作

您可以向/preview端點發出POST請求，以建立新的預覽作業。

有關建立預覽作業的詳細說明，請參閱預覽和估計端點指南。

檢視估計或預覽

由於不同的查詢可能需要不同的時間才能完成，因此會以非同步方式執行估計和預覽程式。一旦啟動查詢後，您就可以使用API呼叫來擷取(GET)估計或預覽的目前狀態。

使用Segmentation Service API，您可以透過預覽工作的ID來尋找其目前狀態。如果狀態為"RESULT_READY"，則可以查看結果。要查找預覽作業的當前狀態，請閱讀預覽和估計端點指南中有關檢索預覽作業部分的部分。要查找估計作業的當前狀態，請閱讀預覽和估計端點指南中有關檢索估計作業的部分。