以Attribution AI下載分數

上次更新： 2023-05-25

主題：
Attribution AI
檢視有關此主題的更多資訊

建立對象：
Developer

User

Admin

Leader

本檔案可作為下載Attribution AI分數的指南。

快速入門

Attribution AI可讓您以Parquet檔案格式下載分數。本教學課程要求您已閱讀並完成下載Attribution AI分數區段於快速入門指南。

此外，若要存取Attribution AI的分數，您必須有可取得成功執行狀態的服務執行個體。若要建立新的服務執行個體，請造訪 Attribution AI使用手冊. 如果您最近建立了服務執行個體，但仍在訓練和評分，請等待24小時讓執行個體完成執行。

尋找您的資料集ID

在您的服務執行個體中，按一下「」以取得Attribution AI分析 更多動作 右上方的下拉式清單，然後選取 存取分數.

更多動作

隨即顯示新對話方塊，其中包含下載分數檔案的連結，以及您目前執行個體的資料集ID。將資料集ID複製到剪貼簿，然後繼續下一個步驟。

資料集 ID

擷取您的批次識別碼

使用上一步的資料集ID，您需要呼叫目錄API以擷取批次ID。此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呼叫。

注意

下列回應具有 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呼叫

取得批次ID後，您就可以向發出新的GET請求 /batches. 該請求會傳回用作下一個API請求的連結。

API格式

GET batches/{BATCH_ID}/files

參數	說明
`{BATCH_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 物件是 href 以新的API呼叫作為其值。複製此值以繼續執行下一個步驟。

{
    "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
    }
}

擷取您的檔案

使用 href 您在上一個步驟中取得的值作為API呼叫，提出新的GET請求以擷取您的檔案目錄。

API格式

GET files/{DATASETFILE_ID}

參數	說明
`{DATASETFILE_ID}`	dataSetFile ID會傳回 `href` 值來自上一步. 您亦可在以下位置存取： `data` 物件型別下的陣列 `dataSetFileId`.

要求

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。

複製 href 中任何檔案物件的值 data 陣列，然後繼續下一步驟。

下載您的檔案資料

GET若要下載您的檔案資料，請向 "href" 您在上一步中複製的值正在擷取您的檔案.

注意

如果您直接在命令列中提出此請求，系統可能會提示您在該請求標頭後新增輸出。以下請求範例使用 --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'

秘訣

在發出GET請求之前，請確定您位於要儲存檔案的正確目錄或資料夾中。

回應

回應會將您要求的檔案下載到目前目錄中。在此範例中，檔案名稱為「file.parquet」。

終端機

下載的分數將為Parquet格式，並且需要 Spark-shell或Parquet讀取器來檢視分數。對於原始分數檢視，您可以使用 Apache Parquet工具. Parquet工具可透過以下方式分析資料 Spark.

後續步驟

本檔案概述下載Attribution AI分數所需的步驟。如需分數輸出的詳細資訊，請造訪 Attribution AI輸入和輸出說明檔案。

使用Snowflake存取分數

重要

如需使用Snowflake存取評分的詳細資訊，請聯絡attributionai-support@adobe.com 。

您可以透過Snowflake存取彙總的Attribution AI分數。目前，您需要透過電子郵件將Adobe支援傳送到attributionai-support@adobe.com ，以設定並接收讀者帳戶的認證以進行Snowflake。

在Adobe支援處理完您的請求後，系統就會提供一個URL給您Snowflake的讀者帳戶，並提供以下對應的憑證：

SNOWFLAKEURL
使用者名稱
密碼

注意

讀取器帳戶用於使用支援JDBC聯結器的SQL使用者端、工作表和BI解決方案來查詢資料。

取得認證和URL後，您就可以查詢模型表格，依接觸點日期或轉換日期彙總。

在Snowflake中尋找您的結構描述

使用提供的憑證登入Snowflake。按一下 工作表 索引標籤在主導覽列左上方，然後導覽至左側面板中的資料庫目錄。

工作表與導覽

接下來，按一下 選取結構描述 在畫面的右上角。在顯示的彈出視窗中，確認您已選取正確的資料庫。接下來，按一下 結構描述 下拉式清單，然後選取其中一個列出的結構描述。您可從選取的綱要下列出的分數表格中直接進行查詢。

尋找結構描述

將PowerBI連線至Snowflake （選擇性）

您的Snowflake認證可用來設定PowerBI Desktop與Snowflake資料庫之間的連線。

首先，在 伺服器 方塊中，輸入您的SnowflakeURL。下一個，在倉儲，輸入「XSMALL」。然後，輸入您的使用者名稱和密碼。

POWERBI範例

建立連線之後，請選取您的Snowflake資料庫，然後選取適當的結構描述。您現在可以載入所有表格。

以Attribution AI下載分數

快速入門

尋找您的資料集ID

擷取您的批次識別碼

使用您的批次ID擷取下一個API呼叫

擷取您的檔案

下載您的檔案資料

後續步驟

使用Snowflake存取分數

在Snowflake中尋找您的結構描述

將PowerBI連線至Snowflake （選擇性）

此頁面上的

檢視下一個：

學習

檔案

社群

支援

資源

Adobe帳戶

Adobe