產生資料集重疊報告
資料集重疊報表可讓您檢視組織內 Profile 透過公開對可定址對象(設定檔)貢獻最大的資料集進行儲存。
除了提供您資料的深入分析,此報表還可協助您採取動作以最佳化授權使用,例如設定特定資料的有效期限限制。
本教學課程概述使用產生資料集重疊報告所需的步驟。 Real-Time Customer Profile API和解讀貴組織的結果。
快速入門
若要使用Adobe Experience Platform API,您必須先完成 驗證教學課程 以收集所需標題的值。 若要進一步瞭解Experience PlatformAPI,請參閱 Platform API快速入門檔案.
本教學課程中所有API呼叫的必要標題為:
Authorization: Bearer {ACCESS_TOKEN}
:此Authorization
標頭需要前置詞語的存取權杖Bearer
. 新的存取權杖值必須每24小時產生一次。x-api-key: {API_KEY}
:此API Key
也稱為Client ID
而是一個只需產生一次的值。x-gw-ims-org-id: {ORG_ID}
:組織ID只需產生一次。
完成驗證教學課程並收集所需標題的值後,您就可以開始對Real-Time Customer API發出呼叫了。
使用命令列產生資料集重疊報告
如果您熟悉如何使用命令列,您可以透過對執行GET請求,使用以下cURL請求來產生資料集重疊報表 /previewsamplestatus/report/dataset/overlap
.
要求
以下請求使用 date
引數以傳回指定日期的最新報告。
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
date
date=2024-12-31
回應
成功的請求會傳回HTTP狀態200 (確定)和資料集重疊報表。 報表包含 data
物件,包含以逗號分隔的資料集清單及其各自的設定檔計數。 如需如何閱讀報告的詳細資訊,請參閱以下章節: 解譯資料集重疊報表資料 在本教學課程的稍後章節中說明。
{
"data": {
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
},
"reportTimestamp": "2021-04-19T19:55:31.147"
}
使用Postman產生資料集重疊報表
Postman是API開發的合作平台,對API呼叫的視覺化相當實用。 您可從以下網址免費下載: Postman網站 和提供易於使用的UI來執行API呼叫。 下列熒幕擷取畫面會使用Postman介面。
要求
若要使用Postman請求資料集重疊報表,請完成以下步驟:
-
使用下拉式清單,選取GET作為請求型別。
-
在「 」中輸入所需的標頭
KEY
欄:Authorization
x-api-key
x-gw-ims-org-id
-
將驗證期間產生的值輸入到
VALUE
欄,取代大括弧({{ }}
)以及大括弧內的任何內容。 -
輸入請求路徑,無論是否使用選填
date
引數:https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
或https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
date
格式:YYYY-MM-DD。 範例:
date=2024-12-31
完成請求型別、標頭、值和路徑後,選取 傳送 傳送API要求並產生報表。
回應
成功的請求會傳回HTTP狀態200 (確定)和資料集重疊報表。 報表包含 data
物件,包含以逗號分隔的資料集清單及其各自的設定檔計數。 如需如何閱讀報告的詳細資訊,請參閱以下章節: 解譯資料集重疊報表資料.
解釋資料集重疊報表資料 interpret-the-report
產生的資料集重疊報表提供顯示報表日期和時間的時間戳記,以及資料物件,其中包含以逗號分隔的清單資料集ID的唯一組合。 以下小節提供有關報表元件的其他資訊。
報告時間戳記
此 reportTimestamp
符合API請求中提供的日期,如果沒有提供日期,則為最近報表的時間戳記。
資料集識別碼清單
此 data
物件包括資料集ID的不重複組合,以逗號分隔清單,以及該資料集組合的個別設定檔計數。
若要解譯報表的結果,請考量下列範例:
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
此報表提供下列資訊:
- 有123個設定檔包含來自以下資料集的資料:
5d92921872831c163452edc8
,5da7292579975918a851db57
,5eb2cdc6fa3f9a18a7592a98
. - 共有454,412個設定檔包含來自這兩個資料集的資料:
5d92921872831c163452edc8
和5eb2cdc6fa3f9a18a7592a98
. - 有107個設定檔僅由資料集中的資料組成
5eeda0032af7bb19162172a7
. - 組織內共有454,642個設定檔。
後續步驟
完成本教學課程後,您現在可以使用即時客戶設定檔API產生資料集重疊報表。 若要進一步瞭解如何在API和Experience Platform UI中使用設定檔資料,請從閱讀 設定檔概述檔案.