文件Experience PlatformIntelligent Services 指南

以Attribution AI下載分數

Last update: Thu May 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • User

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

快速入門

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

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

尋找您的資料集ID dataset-id

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

更多動作

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

資料集 ID

擷取您的批次識別碼 retrieve-your-batch-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呼叫。

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後，您就可以向發出新的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
    }
}

擷取您的檔案 retrieving-your-files

使用 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" 您在上一步中複製的值 正在擷取您的檔案.

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-shell或Parquet讀取器來檢視分數。 對於原始分數檢視，您可以使用 Apache Parquet工具. Parquet工具可透過以下方式分析資料 Spark.

後續步驟

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

使用Snowflake存取分數

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

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

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

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

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

在Snowflake中尋找您的結構描述

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

工作表與導覽

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

尋找結構描述

將PowerBI連線至Snowflake （選擇性）

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

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

POWERBI範例

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

recommendation-more-help
8959a20a-a58f-4057-9f82-870706c576e9