使用分段服務API建立區段

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

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

快速入門

本教學課程需要對建立觀眾區隔時涉及的各種Adobe Experience 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謂語,直到產生可預期的結果,然後在更新的區段定義中使用。

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

  1. 建立預覽工作
  2. 使用預 覽工作的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",則可以查看結果。 要查找預覽作業的當前狀態,請閱讀預覽和估計端點指南中有關檢索預覽作業部分的部分。 要查找估計作業的當前狀態,請閱讀預覽和估計端點指南中有關檢索估計作業的部分。

後續步驟

在您開發、測試和儲存區段定義後,就可以使用Segmentation Service API建立區段工作以建立觀眾。 有關如何完成此操作的詳細步驟,請參閱評估和訪問段結果的教程。

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now