データセットの重複レポートの生成

データセット重複レポートは、アドレス可能なオーディエンス(プロファイル)に最も貢献するデータセットを公開することで、組織の 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 とも呼ばれ、1 Client ID 回だけ生成する必要がある値です。
  • x-gw-ims-org-id: {IMS_ORG}:は IMS Org とも呼ばれ、1 回 Organization ID だけ生成する必要があります。

認証に関するチュートリアルを完了し、必要なヘッダーの値を収集したら、リアルタイム顧客 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: {IMS_ORG}' \
パラメーター 説明
date 返されるレポートの日付を指定します。 その日に複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、HTTP ステータス 404(Not Found) エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。 形式: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 を使用したデータセット重複レポートの生成

Postman は、API 開発の共同プラットフォームで、API 呼び出しの視覚化に役立ちます。 Postman の Web サイト から無料でダウンロードでき、API 呼び出しを実行するための使いやすい UI を提供します。 次のスクリーンショットは、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
    or
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
パラメーター 説明
date 返されるレポートの日付を指定します。 その日に複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、HTTP ステータス 404(Not Found) エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。
形式:YYYY-MM-DD です。例:date=2024-12-31

リクエストのタイプ、ヘッダー、値およびパスが完了したら、Send を選択して API リクエストを送信し、レポートを生成します。

応答

リクエストが成功すると、HTTP ステータス 200(OK) とデータセットの重複レポートが返されます。 このレポートには、データセットのコンマ区切りのリストとそれぞれのプロファイル数を含む data オブジェクトが含まれます。 レポートの読み取り方法について詳しくは、 データセット重複レポートデータの解釈 の節を参照してください。

データセットの重複レポートデータの解釈

生成されたデータセット重複レポートには、レポートの日時を示すタイムスタンプと、データセット ID の一意の組み合わせをコンマ区切りリストとして含むデータオブジェクトが表示されます。 次の節では、レポートのコンポーネントに関する追加情報を示します。

レポートのタイムスタンプ

reportTimestamp は、API リクエストで指定された日付と一致します。日付が指定されていない場合は、最新のレポートのタイムスタンプが表示されます。

データセット ID のリスト

data オブジェクトには、データセット ID の一意の組み合わせがコンマ区切りリストとして含まれ、データセットの組み合わせに対応するプロファイル数が表示されます。

メモ

データセットの重複レポートの各行に関連付けられているすべてのプロファイル数の合計は、組織内のプロファイルの合計数と同じにする必要があります。

レポートの結果を解釈するには、次の例を考えてみましょう。

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

このレポートには、次の情報が表示されます。

  • 次のデータセットからのデータで構成される 123 のプロファイルがあります。5d92921872831c163452edc85da7292579975918a851db575eb2cdc6fa3f9a18a7592a98
  • 次の 2 つのデータセットから得られるデータで構成される 454,412 件のプロファイルがあります。5d92921872831c163452edc85eb2cdc6fa3f9a18a7592a98
  • データセット 5eeda0032af7bb19162172a7 のデータのみから構成される 107 個のプロファイルがあります。
  • 組織には、合計 454,642 件のプロファイルがあります。

次の手順

このチュートリアルを完了すると、リアルタイム顧客プロファイル API を使用してデータセットの重複レポートを生成できます。 API とExperience PlatformUI の両方でプロファイルデータを使用する方法について詳しくは、まず プロファイルの概要に関するドキュメント を参照してください。

このページ