本檔案提供評估區段和使用存取區段結果的教學課程 Segmentation API.
本教學課程需要妥善了解 Adobe Experience Platform 與建立受眾區隔相關的服務。 開始本教學課程之前,請先檢閱下列服務的檔案:
本教學課程也要求您完成 驗證教學課程 以便成功呼叫 Platform API。 完成驗證教學課程會提供所有 Experience Platform API呼叫,如下所示:
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
中的所有資源 Experience Platform 與特定虛擬沙箱隔離。 請求 Platform API需要標頭,以指定要在中執行操作的沙箱名稱:
{SANDBOX_NAME}
如需中沙箱的詳細資訊,請參閱 Platform,請參閱 沙箱概述檔案.
所有POST、PUT和PATCH請求都需要額外的標題:
開發、測試並儲存區段定義後,您就可以透過排程評估或隨需評估來評估區段。
計畫評估 (也稱為「排程分段」)可讓您建立在特定時間執行匯出作業的循環排程,但 隨選評估 包括建立區段工作以立即建立對象。 各步驟的步驟如下所述。
如果您尚未完成 使用區段API建立區段 教學課程或使用 區段產生器,請先完成此操作,再繼續本教學課程。
透過排程的評估,您的IMS組織可以建立循環排程以自動執行匯出作業。
可針對最多五(5)個合併原則的沙箱啟用排程評估 XDM Individual Profile. 如果貴組織有五個以上的合併政策 XDM Individual Profile 在單一沙箱環境中,您將無法使用排程的評估。
向 /config/schedules
端點,您可以建立排程,並包含應觸發排程的特定時間。
有關使用此端點的更多詳細資訊,請參見 schedules endpoint guide(計畫端點指南)
依預設,排程在建立時非作用中,除非 state
屬性設為 active
在建立(POST)請求內文中。 您可以啟用排程(設定 state
to active
),向 /config/schedules
端點,並在路徑中納入排程的ID。
有關使用此端點的更多詳細資訊,請參見 schedules endpoint guide(計畫端點指南)
您可以透過向 /config/schedules
端點,並在路徑中納入排程的ID。
有關使用此端點的更多詳細資訊,請參見 schedules endpoint guide(計畫端點指南)
隨需評估可讓您建立區段工作,以便隨時產生受眾區段。 與排程評估不同,這只會在要求時發生,且不會重複執行。
區段工作是非同步程式,可依需求建立受眾區段。 它會參考區段定義,以及任何控制如何 Real-Time Customer Profile 合併您的設定檔片段的重疊屬性。 區段工作成功完成後,您可以收集區段的各種資訊,例如處理期間可能發生的任何錯誤,以及對象的最終大小。 每當您要重新整理目前符合區段定義資格的對象時,都需要執行區段工作。
您可以透過向 /segment/jobs
端點 Real-Time Customer Profile API。
有關使用此端點的更多詳細資訊,請參見 區段作業端點指南
您可以使用 id
,以便執行查閱請求(GET)以檢視工作的目前狀態。
有關使用此端點的更多詳細資訊,請參見 區段作業端點指南
區段作業成功執行時, segmentMembership
區段中包含之每個設定檔的對應都會更新。 segmentMembership
也會儲存擷取至的任何預先評估對象區段 Platform,允許與其他解決方案(例如 Adobe Audience Manager.
下列範例顯示 segmentMembership
屬性如同每個個別設定檔記錄:
{
"segmentMembership": {
"UPS": {
"04a81716-43d6-4e7a-a49c-f1d8b3129ba9": {
"timestamp": "2018-04-26T15:52:25+00:00",
"status": "existing"
},
"53cba6b2-a23b-454a-8069-fc41308f1c0f": {
"lastQualificationTime": "2018-04-26T15:52:25+00:00",
"status": "realized"
}
},
"Email": {
"abcd@adobe.com": {
"lastQualificationTime": "2017-09-26T15:52:25+00:00",
"status": "exited"
}
}
}
}
屬性 | 說明 |
---|---|
lastQualificationTime |
建立區段成員資格斷言以及設定檔輸入或退出區段時的時間戳記。 |
status |
目前請求中區段參與率的狀態。 必須等於下列其中一個已知值:
|
任何位於 exited
狀態超過30天,根據 lastQualificationTime
,將會遭刪除。
您可透過下列兩種方式之一存取區段作業的結果:您可以存取個別設定檔,或將整個對象匯出至資料集。
以下各節將更詳細地介紹這些選項。
如果您知道要存取的特定設定檔,可以使用 Real-Time Customer Profile API。 存取個別設定檔的完整步驟可在 使用設定檔API存取即時客戶設定檔資料 教學課程。
分段作業成功完成後( status
屬性為「SUCCEEDED」),您可以將對象匯出至資料集,以便存取資料集並據以處理。
匯出對象需要下列步驟:
匯出對象時,必須先建立目標資料集。 請務必正確設定資料集,以確保匯出成功。
其中一項主要考量事項為資料集所依據的結構(schemaRef.id
(在以下的API範例請求中)。 若要匯出區段,資料集必須以 XDM Individual Profile Union Schema (https://ns.adobe.com/xdm/context/profile__union
)。 聯合結構是系統產生的唯讀結構,會匯總共用相同類別之結構的欄位(在此例中是XDM個別設定檔類別)。 如需聯合檢視結構的詳細資訊,請參閱 Schema Registry開發人員指南的「Real-Time Customer Profile」部分.
建立必要資料集的方式有兩種:
如果您已有相容的資料集且知道其ID,可以直接繼續進行 產生對象設定檔.
API格式
POST /dataSets
要求
下列請求會建立新資料集,提供裝載中的設定參數。
curl -X POST \
https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "Segment Export",
"schemaRef": {
"id": "https://ns.adobe.com/xdm/context/profile__union",
"contentType": "application/vnd.adobe.xed+json;version=1"
}
}'
屬性 | 說明 |
---|---|
name |
資料集的描述性名稱。 |
schemaRef.id |
與資料集關聯的聯合檢視(結構)ID。 |
回應
成功的回應會傳回一個陣列,內含新建立資料集的唯讀、系統產生的唯一ID。 若要成功匯出受眾成員,需要正確設定的資料集ID。
[
"@/datasets/5b020a27e7040801dedba61b"
]
在您擁有持續存在聯合的資料集後,您可以建立匯出工作,對 /export/jobs
端點 Real-Time Customer Profile API,並提供您要匯出之區段的資料集ID和區段資訊。
有關使用此端點的更多詳細資訊,請參見 匯出作業端點指南
作為匯出作業程式,您可以向 /export/jobs
端點和包含 id
的URL。 一旦 status
欄位返回值「SUCCEEDED」。
有關使用此端點的更多詳細資訊,請參見 匯出作業端點指南
匯出成功後,您的資料即可在 Data Lake in Experience Platform. 然後,您就可以使用 Data Access API 若要存取資料,請使用 batchId
與匯出相關聯。 根據區段的大小,資料可能是區塊,而批次可能包含數個檔案。
如需如何使用的逐步指示 Data Access 若要存取和下載批次檔案,請遵循 資料存取教學課程.
您也可以使用 Adobe Experience Platform Query Service. 使用UI或RESTful API, Query Service 可讓您對 Data Lake.
如需如何查詢受眾資料的詳細資訊,請參閱 Query Service.