資料集重疊報告可查看組織的組成 Profile 通過公開對可定址的受眾(配置檔案)貢獻最大的資料集來儲存。
除了提供對資料的洞察力外,此報告還可以幫助您採取措施來優化許可證使用,例如設定某些資料的使用壽命限制。
本教程概括介紹了使用 Real-time Customer Profile API並解釋組織的結果。
要使用Adobe Experience PlatformAPI,必須先完成 驗證教程 以收集所需標題所需的值。 要瞭解有關Experience PlatformAPI的詳細資訊,請參閱 平台API文檔入門。
本教程中所有API調用的必需標頭包括:
Authorization: Bearer {ACCESS_TOKEN}
:的 Authorization
頭需要以單詞為前置詞的訪問令牌 Bearer
。 必須每24小時生成一個新訪問令牌值。x-api-key: {API_KEY}
:的 API Key
也稱為a Client ID
並且是只需生成一次的值。x-gw-ims-org-id: {ORG_ID}
:的 IMS Org
也稱為 Organization ID
只需要生成一次。完成身份驗證教程並收集所需標頭的值後,您就可以開始調用即時客戶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 |
指定要返回的報告的日期。 如果在該日期運行了多個報表,則返回該日期的最新報表。 如果指定日期不存在報告,則返回HTTP狀態404(未找到)錯誤。 如果未指定日期,則返回最近的報告。 格式:YYYY-MM-DD。 範例: date=2024-12-31 |
回應
成功的請求返回HTTP狀態200(OK)和資料集重疊報告。 報告包括 data
對象,包含以逗號分隔的資料集清單及其各自的配置檔案計數。 有關如何閱讀報告的詳細資訊,請參閱 解釋資料集重疊報告資料 在本教程的後面。
{
"data": {
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
},
"reportTimestamp": "2021-04-19T19:55:31.147"
}
Postman是API開發的協作平台,對API調用的可視化非常有用。 可以從 Postman網站 並提供了一個易於使用的UI,用於執行API調用。 以下螢幕截圖使用Postman介面。
要求
要使用Postman請求資料集重疊報告,請完成以下步驟:
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 |
指定要返回的報告的日期。 如果在該日期運行了多個報表,則返回該日期的最新報表。 如果指定日期不存在報告,則返回HTTP狀態404(未找到)錯誤。 如果未指定日期,則返回最近的報告。 格式:YYYY-MM-DD。 範例: date=2024-12-31 |
請求類型、標頭、值和路徑完成後,選擇 發送 發送API請求並生成報告。
回應
成功的請求返回HTTP狀態200(OK)和資料集重疊報告。 報告包括 data
對象,包含以逗號分隔的資料集清單及其各自的配置檔案計數。 有關如何閱讀報告的詳細資訊,請參閱 解釋資料集重疊報告資料。
生成的資料集重疊報告提供了顯示報告日期和時間的時間戳以及包含資料集ID的唯一組合作為逗號分隔清單的資料對象。 以下各節提供了有關報告各組成部分的補充資訊。
的 reportTimestamp
與API請求中提供的日期匹配,或者如果未提供日期,則與最近報告的時間戳匹配。
的 data
對象包括作為逗號分隔清單的資料集ID的唯一組合以及該資料集組合的相應配置檔案計數。
與資料集重疊報告的每一行關聯的所有配置檔案計數的總和應等於組織中配置檔案總數。
要解釋報告結果,請考慮以下示例:
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
此報表提供以下資訊:
5d92921872831c163452edc8
。 5da7292579975918a851db57
。 5eb2cdc6fa3f9a18a7592a98
。5d92921872831c163452edc8
和 5eb2cdc6fa3f9a18a7592a98
。5eeda0032af7bb19162172a7
。完成本教程後,您現在可以使用即時客戶配置檔案API生成資料集重疊報告。 要瞭解有關在API和Experience PlatformUI中使用配置檔案資料的更多資訊,請首先閱讀 概述文檔。