產生資料集重疊報告

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
輪廓

建立對象：

使用者

資料集重疊報表可公開對可定址對象（設定檔）貢獻最大的資料集，讓您檢視組織Profile存放區的構成。

除了提供您資料的深入分析，此報表還可協助您採取動作以最佳化授權使用，例如設定特定資料的有效期限限制。

本教學課程概述使用Real-Time Customer Profile API產生資料集重疊報告及解譯組織結果所需的步驟。

快速入門

若要使用Adobe Experience Platform API，您必須先完成驗證教學課程，以收集所需標題的值。若要深入瞭解Experience Platform API，請參閱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。

使用命令列產生資料集重疊報表

如果您熟悉使用命令列，則可以使用以下cURL請求，透過對/previewsamplestatus/report/dataset/overlap執行GET請求來產生資料集重疊報表。

要求

下列要求使用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 （確定）和資料集重疊報表。報表包含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

完成要求型別、標頭、值和路徑後，選取傳送以傳送API要求並產生報表。

回應

成功的請求會傳回HTTP狀態200 （確定）和資料集重疊報表。報表包含data物件，包含以逗號分隔的資料集清單及其各自的設定檔計數。如需如何讀取報告的詳細資訊，請參閱解譯資料集重疊報告資料一節。

解譯資料集重疊報表資料 interpret-the-report

產生的資料集重疊報表提供顯示報表日期和時間的時間戳記，以及包含以逗號分隔的清單資料集ID唯一組合的資料物件。以下章節提供有關報告元件的其他資訊。

報告時間戳記

reportTimestamp符合API請求中提供的日期，如果未提供日期，則為最近報表的時間戳記。

資料集識別碼清單

data物件包含唯一的資料集ID組合，這些資料集ID是以逗號分隔的清單，以及該資料集組合的個別設定檔計數。

NOTE

與資料集重疊報表每一列相關聯的所有設定檔計數總和，應等於貴組織中的設定檔總數。

若要解譯報表的結果，請考量下列範例：

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

此報表提供下列資訊：

有123個設定檔包含來自下列資料集的資料： 5d92921872831c163452edc8、5da7292579975918a851db57、5eb2cdc6fa3f9a18a7592a98。
有454,412個設定檔包含來自這兩個資料集的資料： 5d92921872831c163452edc8和5eb2cdc6fa3f9a18a7592a98。
有107個設定檔僅由資料集5eeda0032af7bb19162172a7中的資料組成。
組織內共有454,642個設定檔。

後續步驟

完成本教學課程後，您現在可以使用即時客戶設定檔API產生資料集重疊報表。若要進一步瞭解如何在API和Experience PlatformUI中使用設定檔資料，請先閱讀設定檔概述檔案。

recommendation-more-help

54550d5b-f1a1-4065-a394-eb0f23a2c38b