データセットの重複レポートの生成
データセット重複レポートは、到達可能なオーディエンス（プロファイル）に最も貢献するデータセットを公開することで、組織のProfile ストアの構成を可視化します。
このレポートは、データに関するインサイトを提供するだけでなく、特定のデータの有効期間の制限の設定など、ライセンスの使用方法を最適化するためのアクションを実行するのに役立ちます。
このチュートリアルでは、Real-Time Customer Profile APIを使用してデータセット重複レポートを生成し、組織の結果を解釈するために必要な手順の概要を説明します。
はじめに
Adobe Experience Platform APIを使用するには、まず認証チュートリアル を完了して、必要なヘッダーに必要な値を収集する必要があります。 Experience Platform APIについて詳しくは、Experience Platform APIの概要ドキュメント を参照してください。
このチュートリアルのすべてのAPI呼び出しに必要なヘッダーは次のとおりです。
Authorization: Bearer {ACCESS_TOKEN}:Authorizationヘッダーには、Bearerという単語の先頭にアクセストークンが必要です。 24時間ごとに新しいアクセストークン値を生成する必要があります。x-api-key: {API_KEY}:API KeyはClient IDとも呼ばれ、1回だけ生成する必要がある値です。x-gw-ims-org-id: {ORG_ID}：組織IDは1回のみ生成する必要があります。
認証チュートリアルを完了し、必要なヘッダーの値を収集したら、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}' \
datedate=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を使用してデータセット重複レポートを生成する
Postmanは、API開発のためのコラボレーションプラットフォームで、API呼び出しの可視化に役立ちます。 これはPostman web サイト から無料でダウンロードでき、API呼び出しを実行するための使いやすいUIを提供します。 次のスクリーンショットは、Postman インターフェイスを使用しています。
リクエスト
Postmanを使用してデータセットの重複レポートをリクエストするには、次の手順を実行します。
-
ドロップダウンを使用して、リクエストタイプとして「GET」を選択します。
-
KEY列に必要なヘッダーを入力します。Authorizationx-api-keyx-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 （OK）とデータセット重複レポートが返されます。 レポートには、data オブジェクトが含まれており、データセットとそれぞれのプロファイル数のコンマ区切りリストが含まれています。 レポートの読み方について詳しくは、 データセット重複レポートデータの解釈の節を参照してください。
データセット重複レポートデータの解釈 interpret-the-report
生成されたデータセット重複レポートには、レポートの日時を示すタイムスタンプと、データセット IDの一意の組み合わせをコンマ区切りリストとして含むデータオブジェクトが表示されます。 次の節では、レポートの構成要素に関する追加情報を提供します。
レポートタイムスタンプ
reportTimestampは、API リクエストで指定された日付と一致するか、日付が指定されていない場合は、最新のレポートのタイムスタンプと一致します。
データセット IDのリスト
data オブジェクトには、データセット IDの一意の組み合わせがコンマ区切りのリストとして含まれ、そのデータセットの組み合わせの各プロファイル数が含まれます。
レポートの結果を解釈するには、次の例を考えてみましょう。
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
本レポートでは、次の情報を提供します。
- 次のデータセットからのデータで構成されるプロファイルは123個あります：
5d92921872831c163452edc8、5da7292579975918a851db57、5eb2cdc6fa3f9a18a7592a98。 - 次の2つのデータセットからのデータで構成される454,412個のプロファイルがあります：
5d92921872831c163452edc8と5eb2cdc6fa3f9a18a7592a98。 - データセット
5eeda0032af7bb19162172a7のデータのみで構成されるプロファイルは107個あります。 - 組織内には合計454,642のプロファイルがあります。
次の手順
このチュートリアルを完了すると、Real-Time Customer Profile APIを使用してデータセット重複レポートを生成できるようになりました。 APIとExperience Platform UIの両方でプロファイルデータを使用する方法について詳しくは、最初に プロファイルの概要ドキュメント を参照してください。