使用區段服務API建立區段

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

有關如何使用使用者介面建立區段的資訊，請參閱 區段產生器指南.

快速入門

本教學課程需要深入瞭解各種 Adobe Experience Platform 建立受眾區段所涉及的服務。 在開始本教學課程之前，請檢閱下列服務的檔案：

以下小節提供您需瞭解的其他資訊，才能成功對 Platform API。

讀取範例API呼叫

本教學課程提供範例API呼叫，示範如何格式化您的請求。 這些包括路徑、必要的標頭，以及正確格式化的請求裝載。 此外，也提供API回應中傳回的範例JSON。 如需檔案中用於範例API呼叫的慣例相關資訊，請參閱以下章節： 如何讀取範例API呼叫 在 Experience Platform 疑難排解指南。

收集必要標題的值

為了呼叫 Platform API，您必須先完成 驗證教學課程. 完成驗證教學課程後，會在所有標題中提供每個必要標題的值 Experience Platform API呼叫，如下所示：

  • 授權：持有人 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

中的所有資源 Experience Platform 隔離至特定的虛擬沙箱。 的所有要求 Platform API需要標頭，用於指定將在其中執行操作的沙箱名稱：

  • x-sandbox-name: {SANDBOX_NAME}
注意

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

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

  • Content-Type： application/json

開發區段定義

區段的第一個步驟是定義區段，以稱為區段定義的建構來表示。 區段定義是一個物件，可封裝寫入的查詢 Profile Query Language (PQL)。 此物件也稱為PQL述詞。 PQL述詞會根據與您提供至的任何記錄或時間序列資料相關的條件，定義區段的規則 Real-Time Customer Profile. 請參閱 PQL指南 有關寫入PQL查詢的詳細資訊。

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

如需如何定義區段的詳細說明，請參閱 區段定義開發人員指南.

預估和預覽對象

當您開發區段定義時，可以使用中的預估和預覽工具 Real-Time Customer Profile 檢視摘要層級資訊，以協助確保您隔離預期的對象。 預估可提供區段定義的統計資訊，例如預計對象人數和信賴區間。 預覽提供符合區段定義之設定檔的編頁清單，可讓您比較結果與預期。

透過估計和預覽對象，您可以測試和最佳化PQL述詞，直到產生理想的結果，然後可以在更新的區段定義中使用它們。

要預覽或取得區段的預估值，有兩個必要步驟：

  1. 建立預覽工作
  2. 檢視預估或預覽 使用預覽作業的ID

如何產生預估值

資料範例可用來評估區段及估計合格設定檔的數量。 每天早上（上午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。 請參閱教學課程，位置如下： 評估及存取區段結果 以取得如何完成此作業的詳細步驟。

本頁內容