本檔案可作為下載Attribution AI分數的指南。
Attribution AI可讓您以Parquet檔案格式下載分數。 本教學課程要求您已閱讀並完成下載Attribution AI分數區段於 快速入門 指南。
此外,若要存取Attribution AI的分數,您必須有可取得成功執行狀態的服務執行個體。 若要建立新的服務執行個體,請造訪 Attribution AI使用手冊. 如果您最近建立了服務執行個體,但仍在訓練和評分,請等待24小時讓執行個體完成執行。
在您的服務執行個體中,按一下「 」以取得Attribution AI分析 更多動作 右上方的下拉式清單,然後選取 存取分數.
隨即顯示新對話方塊,其中包含下載分數檔案的連結,以及您目前執行個體的資料集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後,您就可以向發出新的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存取評分的詳細資訊,請聯絡attributionai-support@adobe.com 。
您可以透過Snowflake存取彙總的Attribution AI分數。 目前,您需要透過電子郵件將Adobe支援傳送到attributionai-support@adobe.com ,以設定並接收讀者帳戶的認證以進行Snowflake。
在Adobe支援處理完您的請求後,系統就會提供一個URL給您Snowflake的讀者帳戶,並提供以下對應的憑證:
讀取器帳戶用於使用支援JDBC聯結器的SQL使用者端、工作表和BI解決方案來查詢資料。
取得認證和URL後,您就可以查詢模型表格,依接觸點日期或轉換日期彙總。
使用提供的憑證登入Snowflake。 按一下 工作表 索引標籤在主導覽列左上方,然後導覽至左側面板中的資料庫目錄。
接下來,按一下 選取結構描述 在畫面的右上角。 在顯示的彈出視窗中,確認您已選取正確的資料庫。 接下來,按一下 結構描述 下拉式清單,然後選取其中一個列出的結構描述。 您可從選取的綱要下列出的分數表格中直接進行查詢。
您的Snowflake認證可用來設定PowerBI Desktop與Snowflake資料庫之間的連線。
首先,在 伺服器 方塊中,輸入您的SnowflakeURL。 下一個,在 倉儲,輸入「XSMALL」。 然後,輸入您的使用者名稱和密碼。
建立連線之後,請選取您的Snowflake資料庫,然後選取適當的結構描述。 您現在可以載入所有表格。