ドキュメントExperience Platformインテリジェントサービスガイド

Attribution AIのスコアのダウンロード

最終更新日： 2026年8月5日

作成対象：

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

このドキュメントは、アトリビューション AIのスコアをダウンロードするためのガイドとして機能します。

はじめに

アトリビューション AIを使用すると、Parquet ファイル形式でスコアをダウンロードできます。 このチュートリアルでは、入門 ガイドの「アトリビューション AI スコア」セクションを読んでダウンロードを完了している必要があります。

さらに、Attribution AIのスコアにアクセスするには、正常な実行ステータスのサービスインスタンスを使用可能にする必要があります。 新しいサービスインスタンスを作成するには、Attribution AI ユーザーガイド ​にアクセスしてください。 サービスインスタンスを作成したばかりで、まだトレーニングとスコア測定を行っている場合は、実行が終了するまで 24 時間お待ちください。

データセット IDの検索 dataset-id

アトリビューション AI インサイトのサービスインスタンス内で、右上のナビゲーションの​詳細アクション ドロップダウンをクリックし、スコアにアクセス​を選択します。

その他のアクション

新しいダイアログが表示され、スコアのダウンロードに関するドキュメントへのリンクと、現在のインスタンスのデータセット ID が示されます。 データセット ID をクリップボードにコピーして、次の手順に進みます。

データセット ID

バッチ ID を取得する retrieve-your-batch-id

前の手順のデータセット IDを使用して、バッチ IDを取得するためにCatalog APIを呼び出す必要があります。 このAPI呼び出しに追加のクエリパラメーターを使用して、組織に属するバッチのリストではなく、成功した最新のバッチを返します。 追加のバッチを返すには、limit クエリパラメーターの数を、返す必要のある金額に増やします。 使用可能なクエリパラメーターの種類について詳しくは、クエリパラメーターを使用したカタログデータのフィルタリングに関するガイドを参照してください。

API 形式

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
パラメーター
説明
{DATASET_ID}
アクセススコアダイアログで使用できるデータセット ID です。

リクエスト

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?&dataSet=5e8f81ce7a4ecb18a8d25b22&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答が成功すると、バッチ ID オブジェクトを含むペイロードが返されます。 この例では、返されるオブジェクトのKey値はバッチ ID 01E5QSWCAASFQ054FNBKYV6TIQです。 バッチ ID をコピーして、次の API 呼び出しで使用します。

NOTE
次の応答では、tags オブジェクトが読みやすいように変換されています。
{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5e8f81cf7a4ecb28a8d85b22"
            }
        ],
        "id": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "externalId": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "replay": {
            "predecessors": [
                "01E5N7EDQQP4JHJ93M7C3WM5SP"
            ],
            "reason": "Replacing for 2020-04-09",
            "predecessorListingType": "IMMEDIATE"
        },
        "inputFormat": {
            "format": "parquet"
        },
        "imsOrg": "412657965Y566A4A0A495D4A@AdobeOrg",
        "started": 1586715571808,
        "metrics": {
            "partitionCount": 1,
            "outputByteSize": 2380339,
            "inputFileCount": -1,
            "inputByteSize": 2381007,
            "outputRecordCount": 24340,
            "outputFileCount": 1,
            "inputRecordCount": 24340
        },
        "completed": 1586715582735,
        "created": 1586715571217,
        "createdClient": "acp_foundation_push",
        "createdUser": "sensei_exp_attributionai@AdobeID",
        "updatedUser": "acp_foundation_dataTracker@AdobeID",
        "updated": 1586715583582,
        "version": "1.0.5"
    }
}

バッチ ID を使用して次の API 呼び出しを取得する retrieve-the-next-api-call-with-your-batch-id

バッチ ID を取得したら、/batches に対して新しい GET リクエストを実行できます。 リクエストを実行すると、次の API リクエストとして使用するリンクが返されます。

API 形式

GET batches/{BATCH_ID}/files
パラメーター
説明
{BATCH_ID}
前の手順（バッチ ID の取得）で取得したバッチ ID です。

リクエスト

独自のバッチ ID を使用して、次のリクエストを実行します。

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/01E5QSWCAASFQ054FNBKYV6TIQ/files' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

リクエストが成功した場合は、_links オブジェクトを含むペイロードが返されます。 _links オブジェクト内には、新しい API 呼び出しが値として付加された href があります。 この値をコピーして、次の手順に進みます。

{
    "data": [
        {
            "dataSetFileId": "01E5QSWCAASFQ054FNBKYV6TIQ-1",
            "dataSetViewId": "5e8f81cf7a4ecb28a8d85b22",
            "version": "1.0.0",
            "created": "1586715582571",
            "updated": "1586715582571",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

ファイルを取得する retrieving-your-files

前の手順で取得した href 値を API 呼び出しとして使用して、新しい GET リクエストを実行し、ファイルディレクトリを取得します。

API 形式

GET files/{DATASETFILE_ID}
パラメーター
説明
{DATASETFILE_ID}
dataSetFile ID は、前の手順で取得した href 値にあります。 また、オブジェクトタイプ dataSetFileId 下の data 配列からもアクセスできます。

リクエスト

curl -X GET 'https://platform.adobe.io/data/foundation/export/files/01E5QSWCAASFQ054FNBKYV6TIQ-1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

レスポンスには、データ配列（単一のエントリが存在する可能性があります）、またはそのディレクトリに属するファイルのリストが含まれます。 次の例にはファイルのリストが含まれています。また、読みやすくするために簡略化されています。 このシナリオの場合、ファイルにアクセスするには各ファイルの URL をたどる必要があります。

{
    "data": [
        {
            "name": "part-00000-tid-5614147572541837832-908bd66a-d856-47fe-b7da-c8e7d22a4097-1370467-1.c000.snappy.parquet",
            "length": "2380211",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}
パラメーター
説明
_links.self.href
ディレクトリ内のファイルのダウンロードに使用する GET 要求の URL です。

data 配列内のファイルオブジェクトの href 値をコピーして、次の手順に進みます。

ファイルデータをダウンロードする

ファイルデータをダウンロードするには、前の手順（ファイルの取得）でコピーした "href" 値に対して GET リクエストを実行します。

NOTE
このリクエストをコマンドラインで直接行う場合は、リクエストヘッダーの後に出力を追加するように求められることがあります。 次のリクエストの例では --output {FILENAME.FILETYPE} を使用しています。

API 形式

GET files/{DATASETFILE_ID}?path={FILE_NAME}
パラメーター
説明
{DATASETFILE_ID}
dataSetFile ID は、前の手順で取得した href 値にあります。
{FILE_NAME}
ファイルの名前です。

リクエスト

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'file.parquet'
TIP
GET リクエストを行う前に、ファイルを保存する正しいディレクトリまたはフォルダーに存在することを確認してください。

応答

現在のディレクトリにある、要求したファイルがダウンロードされます。 この例では、ファイル名は「file.parquet」です。

端末

ダウンロードされたスコアはParquet形式で表示され、スコアを表示するにはSpark シェルまたはParquet リーダーが必要です。 生のスコア表示には、Apache Parquet ツール ​を使用できます。 寄木ツールは、Sparkを使用してデータを分析できます。

次の手順

このドキュメントでは、アトリビューション AI スコアのダウンロードに必要な手順の概要を説明しました。 スコア出力について詳しくは、属性AI入力および出力のドキュメントを参照してください。

Snowflakeを使用したスコアへのアクセス

IMPORTANT
Snowflakeを使用したスコアへのアクセスについて詳しくは、attributionai-support@adobe.comにお問い合わせください。

Snowflakeから集約されたアトリビューション AI スコアにアクセスできます。 現在、Snowflake のリーダーアカウントを設定して、その資格情報を受け取るには、アドビサポート（attributionai-support@adobe.com）に電子メールでお問い合わせいただく必要があります。

アドビサポートがリクエストを処理すると、Snowflake のリーダーアカウントの URL と、それに対応する資格情報が提供されます（以下を参照）。

  • Snowflake URL
  • ユーザー名
  • パスワード
NOTE
リーダーアカウントは、JDBC コネクタをサポートするsql クライアント、ワークシート、BI ソリューションを使用してデータをクエリするためのものです。

資格情報とURLを取得したら、モデルテーブル、タッチポイント日付またはコンバージョン日で集計されたモデルテーブルをクエリできます。

Snowflake でスキーマを探す

提供された資格情報を使用して、Snowflake にログインします。 左上のメインナビゲーションの「Worksheets」タブをクリックし、左パネルのデータベースディレクトリに移動します。

「Worksheets」のデータベースディレクトリに移動

次に、画面右上の「スキーマを選択」をクリックします。 表示されるポップオーバーで、適切なデータベースが選択されていることを確認します。 次に、「スキーマ」ドロップダウンをクリックし、リストからいずれかのスキーマを選択します。 選択したスキーマの下に表示されるスコアテーブルから直接クエリを実行できます。

スキーマの選択

PowerBI を Snowflake に接続する（オプション）

Snowflake の資格情報を使用して、PowerBI Desktop と Snowflake データベース間の接続を設定できます。

まず、「サーバー」ボックスに、Snowflake の URL を入力します。 次に、「Warehouse」に「XSMALL」と入力します。 ユーザー名とパスワードを入力します。

POWERBI の例

接続が確立されたら、Snowflake データベースを選択し、適切なスキーマを選択します。 これで、すべてのテーブルを読み込むことができます。

recommendation-more-help
experience-platform-help-intelligent-services