本檔案提供開發、測試、預覽和儲存區段定義的教學課程,使用 Adobe Experience Platform Segmentation Service API.
有關如何使用使用者介面建立區段的資訊,請參閱 區段產生器指南.
本教學課程需要深入瞭解各種 Adobe Experience Platform 建立受眾區段所涉及的服務。 在開始本教學課程之前,請檢閱下列服務的檔案:
以下小節提供您需瞭解的其他資訊,才能成功對 Platform API。
本教學課程提供範例API呼叫,示範如何格式化您的請求。 這些包括路徑、必要的標頭,以及正確格式化的請求裝載。 此外,也提供API回應中傳回的範例JSON。 如需檔案中用於範例API呼叫的慣例相關資訊,請參閱以下章節: 如何讀取範例API呼叫 在 Experience Platform 疑難排解指南。
為了呼叫 Platform API,您必須先完成 驗證教學課程. 完成驗證教學課程後,會在所有標題中提供每個必要標題的值 Experience Platform API呼叫,如下所示:
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
中的所有資源 Experience Platform 隔離至特定的虛擬沙箱。 的所有要求 Platform API需要標頭,用於指定將在其中執行操作的沙箱名稱:
{SANDBOX_NAME}
如需中沙箱的詳細資訊 Platform,請參閱 沙箱概述檔案.
包含裝載(POST、PUT、PATCH)的所有請求都需要額外的標頭:
區段的第一個步驟是定義區段,以稱為區段定義的建構來表示。 區段定義是一個物件,可封裝寫入的查詢 Profile Query Language (PQL)。 此物件也稱為PQL述詞。 PQL述詞會根據與您提供至的任何記錄或時間序列資料相關的條件,定義區段的規則 Real-Time Customer Profile. 請參閱 PQL指南 有關寫入PQL查詢的詳細資訊。
您可以透過向以下專案發出POST請求,以建立新的區段定義: /segment/definitions
中的端點 Segmentation API。 下列範例概述如何格式化定義請求,包括成功定義區段所需的資訊。
如需如何定義區段的詳細說明,請參閱 區段定義開發人員指南.
當您開發區段定義時,可以使用中的預估和預覽工具 Real-Time Customer Profile 檢視摘要層級資訊,以協助確保您隔離預期的對象。 預估可提供區段定義的統計資訊,例如預計對象人數和信賴區間。 預覽提供符合區段定義之設定檔的編頁清單,可讓您比較結果與預期。
透過估計和預覽對象,您可以測試和最佳化PQL述詞,直到產生理想的結果,然後可以在更新的區段定義中使用它們。
要預覽或取得區段的預估值,有兩個必要步驟:
資料範例可用來評估區段及估計合格設定檔的數量。 每天早上(上午12點至凌晨2點之間,亦即UTC時間上午7點至上午9點)新資料都會載入記憶體,而所有分段查詢都會使用當天的範例資料來估算。 因此,新增的任何新欄位或收集的其他資料都將反映在第二天的估計值中。
樣本大小取決於設定檔存放區中的實體總數。 這些範例大小如下表所示:
設定檔存放區中的實體 | 樣本大小 |
---|---|
少於100萬 | 完整資料集 |
1到2000萬 | 100萬 |
超過2,000萬 | 佔總數的5% |
預估通常會在10-15秒內執行,從粗略的估計開始,並隨著閱讀更多記錄而調整。
您可以透過向以下專案發出POST請求來建立新的預覽作業: /preview
端點。
有關建立預覽工作的詳細指示,請參閱 預覽和估計端點指南.
預估和預覽程式會以非同步方式執行,因為不同的查詢可能需要不同的時間長度才能完成。 啟動查詢後,您可以使用API呼叫來擷取(GET)目前的估計狀態,或在其進行時預覽。
使用 Segmentation Service API,您可以透過預覽作業的ID來查詢其目前狀態。 如果狀態為「RESULT_READY」,則可以檢視結果。 若要查詢預覽工作的目前狀態,請閱讀以下章節: 擷取預覽作業區段 在預覽和預估端點指南中。 若要查詢預估工作的目前狀態,請閱讀以下章節: 擷取預估工作 在預覽和預估端點指南中。
開發、測試並儲存區段定義後,您就可以使用建立區段工作來建立受眾。 Segmentation Service API。 請參閱教學課程,位置如下: 評估及存取區段結果 以取得如何完成此作業的詳細步驟。