本檔案提供使用Adobe Experience Platform Segmentation Service API來開發、測試、預覽和儲存區段定義的教學課程。
如需如何使用使用者介面建立區段的詳細資訊,請參閱區段產生器指南。
本教學課程需要對建立觀眾區隔時涉及的各種Adobe Experience Platform服務有深入的瞭解。 在開始本教學課程之前,請先閱讀下列服務的檔案:
以下各節提供您必須知道的其他資訊,才能成功呼叫Platform API。
本教學課程提供範例API呼叫,以示範如何設定請求的格式。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。
若要呼叫Platform API,您必須先完成驗證教學課程。 完成驗證教學課程後,所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面:
{ACCESS_TOKEN}
{API_KEY}
{IMS_ORG}
Experience Platform中的所有資源都隔離到特定的虛擬沙盒。 對Platform API的所有請求都需要一個標題,該標題指定要在中執行操作的沙盒的名稱:
{SANDBOX_NAME}
如需Platform中沙盒的詳細資訊,請參閱沙盒概述檔案。
所有包含裝載(POST、PUT、PATCH)的請求都需要額外的標題:
分段的第一步是定義分段,在稱為分段定義的構造中表示。 段定義是一個對象,用於封裝寫入Profile Query Language (PQL)中的查詢。 此對象也稱為PQL謂語。 PQL謂語根據與您提供給Real-time Customer Profile的任何記錄或時間系列資料相關的條件定義段規則。 有關編寫PQL查詢的詳細資訊,請參見 PQL指南。
您可以向Segmentation API中的/segment/definitions
端點發出POST請求,以建立新的區段定義。 下列範例概述如何設定定義請求的格式,包括成功定義區段所需的資訊。
有關如何定義區段的詳細說明,請閱讀區段定義開發人員指南。
當您開發區段定義時,可使用Real-time Customer Profile中的估計和預覽工具來檢視摘要層級資訊,以協助您隔離預期的觀眾。 估計值提供區段定義的統計資訊,例如預計讀者大小和信賴區間。 預覽提供區段定義的合格設定檔分頁清單,讓您比較結果與預期結果。
透過估計和預覽受眾,您可以測試和最佳化PQL謂語,直到產生可預期的結果,然後在更新的區段定義中使用。
預覽或取得區段估計需要兩個步驟:
資料樣本可用來評估區段並估計符合資格的設定檔數目。 每天早上(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建立區段工作以建立觀眾。 有關如何完成此操作的詳細步驟,請參閱評估和訪問段結果的教程。