Show Menu
主題×

在Attribution AI中下載分數

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

快速入門

Attribution AI可讓您以鑲木地板檔案格式下載分數。 本教學課程要求您已閱讀並完成快速入門手冊中的「歸因AI 分數 」區段。
此外,若要存取Attribution AI的分數,您必須有成功執行狀態的服務例項可供使用。 若要建立新的服務例項,請造訪 Attribution AI使用指南 。 如果您最近建立了一個服務例項,但它仍在訓練和計分中,請允許24小時以完成執行。

Find your dataset ID

在您的「歸因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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應
成功的回應會傳回包含批次ID物件的裝載。 在此示例中,返回對象的鍵值是批處理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
請求
使用您自己的批次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: {IMS_ORG}' \
  -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}
資料集檔案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: {IMS_ORG}' \
  -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 然後繼續執行下一步。

下載您的檔案資料

若要下載檔案資料,請對您在上一步驟中復 "href" 制的檔案值提出GET 要求
如果您直接在命令列中提出此請求,可能會提示您在請求標題後新增輸出。 以下請求範例使用 --output {FILENAME.FILETYPE}
API格式
GET files/{DATASETFILE_ID}?path={FILE_NAME}

參數
說明
{DATASETFILE_ID}
資料集檔案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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'file.parquet'

在您提出GET請求前,請確定您位於要儲存檔案的正確目錄或資料夾中。
回應
回應會下載您在目前目錄中要求的檔案。 在此示例中,檔案名為"file.parce"。
下載的樂譜將採用鑲木格式,需要 Spark-shell或鑲木閱讀器才能檢視樂譜。 若要檢視原始分數,您可以使用 鑲木地板 。 拼花工具可以分析資料 Spark。

後續步驟

本檔案概述下載Attribution AI分數所需的步驟。 如需分數輸出的詳細資訊,請造訪屬 性AI輸入與輸出檔案

使用雪花存取分數

在Adobe支援處理您的要求後,您會收到Snowflake讀者帳戶的URL,以及下列相應的認證:
  • 雪花URL
  • 使用者名稱
  • 密碼
Reader帳戶是使用支援JDBC連接器的SQL客戶端、工作表和BI解決方案查詢資料。
一旦擁有認證和URL,您就可以查詢模型表格、依觸點日期或轉換日期進行匯總。

在雪花中尋找您的圖式

使用提供的憑據,登錄到Snowflake。 按一下左 上方主導覽中的 「工作表」標籤,然後導覽至左側面板中的資料庫目錄。
接著,按 一下畫面右上角的 「選取架構」。 在出現的快顯視窗中,確認您已選取正確的資料庫。 接著,按一下「 結構 」下拉式清單,並選取其中一個列出的結構。 您可以直接從所選方案下列出的分數表中查詢。

將PowerBI連接到雪花(可選)

您的Snowflake憑據可用於設定PowerBI案頭資料庫和Snowflake資料庫之間的連接。
首先,在「服 務器 」框下,鍵入Snowflake URL。 接著,在 Warehouse ​下,輸入"XSMALL"。 然後,輸入您的使用者名稱和密碼。
建立連線後,請選取您的Snowflake資料庫,然後選取適當的架構。 您現在可以載入所有表格。