資料登陸區域目的地

IMPORTANT
此檔案頁面參考Data Landing Zone 目的地。 來源目錄中也有Data Landing Zone 來源。 如需詳細資訊,請閱讀Data Landing Zone 來源檔案。

概觀 overview

Data Landing Zone 是一個由 Adobe Experience Platform 提供所需的 Azure Blob 儲存介面,可授權您存取安全、雲端式檔案儲存設施,並讓您將檔案匯出至平台之外。您有權存取每個沙箱的一個Data Landing Zone容器,而且所有容器的資料量總計以您的Platform產品和服務授權所提供的資料量為限。 Platform及其應用程式(例如Customer Journey Analytics、Journey Orchestration、Intelligent Services和Real-Time Customer Data Platform)的所有客戶都已為每個沙箱布建一個Data Landing Zone容器。 您可以透過Azure Storage Explorer或命令列介面讀取及寫入檔案到容器。

Data Landing Zone支援SAS式驗證,其資料受到標準Azure Blob存放裝置安全機制的保護。 SAS代表共用存取簽章

SAS式驗證可讓您透過公用網際網路連線,安全地存取Data Landing Zone容器。 您不需要變更網路即可存取Data Landing Zone容器,這表示您不需要為網路設定任何允許清單或跨區域設定。

Platform會對上傳至Data Landing Zone容器的所有檔案強制實施嚴格的七天存留時間(TTL)。 所有檔案會在七天後刪除。

透過API或UI連線至您的資料登陸區域儲存空間 connect-api-or-ui

  • 若要使用Platform使用者介面連線到您的資料登陸區域儲存位置,請閱讀以下章節: 連線到目的地啟用對象到此目的地
  • 若要以程式設計方式連線至您的資料登陸區域儲存位置,請使用「流程服務API」教學課程🔗,讀取將對象啟用至檔案型目的地。

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。

對象來源
支援
說明
Segmentation Service
✓ (A)
透過Experience Platform細分服務產生的對象。
自訂上傳
✓ (A)
對象從CSV檔案匯入至Experience Platform。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目
類型
附註
匯出類型
以設定檔為基礎
您正在匯出區段的所有成員,以及適用的結構描述欄位(例如您的PPID),如目的地啟用工作流程的選取設定檔屬性畫面中所選。
匯出頻率
批次
批次目的地會以三、六、八、十二或二十四小時的增量將檔案匯出至下游平台。 深入瞭解批次檔案型目的地

匯出資料集 export-datasets

此目的地支援資料集匯出。 如需如何設定資料集匯出的完整資訊,請閱讀教學課程:

  • 如何使用Platform使用者介面🔗匯出資料集。
  • 如何使用流程服務API🔗以程式設計方式匯出資料集。

匯出資料的檔案格式 file-format

匯出​ 對象資料 ​時,Platform會在您提供的儲存位置中建立.csvparquet.json檔案。 如需檔案的詳細資訊,請參閱對象啟動教學課程中的匯出支援的檔案格式一節。

匯出​ 資料集 ​時,Platform會在您提供的儲存位置中建立.parquet.json檔案。 如需檔案的詳細資訊,請參閱匯出資料集教學課程中的驗證資料集匯出成功區段。

先決條件 prerequisites

請注意,在使用Data Landing Zone目的地之前,必須滿足下列先決條件。

將您的Data Landing Zone容器連線至Azure Storage Explorer

您可以使用Azure Storage Explorer來管理Data Landing Zone容器的內容。 若要開始使用Data Landing Zone,您必須先擷取您的認證,在Azure Storage Explorer中輸入認證,並將您的Data Landing Zone容器連線至Azure Storage Explorer。

在Azure Storage Explorer UI中,選取左側導覽列中的連線圖示。 選取資源 ​視窗會出現,提供您連線的選項。 選取​ Blob container ​以連線至您的Data Landing Zone儲存空間。

在Azure UI中選取醒目提示的資源。

接著,選取​ 共用存取簽章URL (SAS) ​作為您的連線方法,然後選取​ 下一步

選取在Azure UI中反白顯示的連線方法。

選取您的連線方法後,您必須提供與Data Landing Zone容器相對應的​ 顯示名稱 ​和​ Blob容器SAS URL

recommendation-more-help

擷取您Data Landing Zone的認證 retrieve-dlz-credentials

您必須使用Platform API來擷取您的Data Landing Zone認證。 擷取您認證的API呼叫說明如下。 如需有關取得標頭所需值的資訊,請參閱Adobe Experience Platform API快速入門指南。

API格式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
查詢參數
說明
dlz_destination
dlz_destination型別允許API將登陸區域目的地容器與您可用的其他型別容器區分開來。

要求

以下請求範例會擷取現有登陸區域的認證。

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -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}' \
  -H 'Content-Type: application/json' \

回應

下列回應會傳回您登陸區域的認證資訊,包括目前的SASTokenSASUri,以及與您的登陸區域容器相對應的storageAccountName

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
屬性
說明
containerName
您的登陸區域的名稱。
SASToken
您登陸區域的共用存取權簽章Token。 此字串包含授權請求所需的所有資訊。
SASUri
登陸區域的共用存取簽章URI。 此字串是您正在接受驗證的登陸區域的URI及其對應的SAS權杖的組合,

更新Data Landing Zone認證 update-dlz-credentials

您也可以視需要重新整理您的認證。 您可以向Connectors API的/credentials端點發出POST要求,以更新您的SASToken

API格式

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
查詢參數
說明
dlz_destination
dlz_destination型別允許API將登陸區域目的地容器與您可用的其他型別容器區分開來。
refresh
refresh動作可讓您重設您的登陸區域認證,並自動產生新的SASToken

要求

以下請求會更新您的登陸區域認證。

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -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}' \
  -H 'Content-Type: application/json' \

回應

下列回應會傳回您SASTokenSASUri的更新值。

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

提供顯示名稱(containerName)和Data Landing Zone SAS URL (如上述API呼叫中所傳回),然後選取​ 下一步

輸入在Azure UI中反白顯示的連線資訊。

摘要」視窗會出現,提供您設定的總覽,包括Blob端點與許可權的相關資訊。 準備就緒後,選取​ 連線

顯示在Azure UI中的設定摘要。

成功連線會以您的Data Landing Zone容器更新您的Azure Storage Explorer UI。

在Azure UI中反白顯示的DLZ使用者容器摘要。

在您的Data Landing Zone容器連線至Azure Storage Explorer後,您現在可以開始將檔案從Experience Platform匯出至您的Data Landing Zone容器。 若要匯出檔案,您必須在Experience PlatformUI中建立與Data Landing Zone目的地的連線,如下節所述。

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要​ 檢視目的地 ​和​ 管理目的地 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在目標設定工作流程中,填寫以下兩個區段中列出的欄位。

驗證目標 authenticate

確定您已依照必要條件一節中的說明將Data Landing Zone容器連線至Azure Storage Explorer。 因為Data Landing Zone是Adobe布建的存放裝置,您不需要在Experience PlatformUI中執行任何進一步的步驟來驗證目的地。

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。

  • 名稱:填寫此目的地的偏好名稱。

  • 描述:選擇性。 例如,您可以提及要將此目的地用於哪個行銷活動。

  • 資料夾路徑:輸入目的地資料夾的路徑,此資料夾將裝載匯出的檔案。

  • 檔案型別:選取匯出檔案應使用的格式Experience Platform。 選取CSV選項時,您也可以設定檔案格式選項

  • 壓縮格式:選取Experience Platform應用於匯出檔案的壓縮型別。

  • 包含資訊清單檔案:如果您想要匯出包含資訊清單JSON檔案,其中包含有關匯出位置、匯出大小等資訊,請開啟此選項。 資訊清單的命名格式為manifest-<<destinationId>>-<<dataflowRunId>>.json。 檢視範例資訊清單檔案。 資訊清單檔案包含下列欄位:

    • flowRunId:產生匯出檔案的資料流執行
    • scheduledTime:檔案匯出的時間(UTC)。
    • exportResults.sinkPath:存放匯出檔案之存放位置中的路徑。
    • exportResults.name:匯出的檔案名稱。
    • size:匯出的檔案大小(位元組)。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後,請選取​ 下一步

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料,您需要​ 檢視目的地啟用目的地檢視設定檔 ​和​ 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​ 身分,您需要​ 檢視身分圖表 存取控制許可權
    選取工作流程中反白的身分名稱空間,以啟用目的地的對象。 {width="100" modal="regular"}

請參閱啟用對象資料至批次設定檔匯出目的地,以取得啟用對象至此目的地的指示。

正在排程

在​ 排程 ​步驟中,您可以為您的Data Landing Zone目的地設定匯出排程,也可以設定匯出檔案的名稱

對應屬性和身分 map

在​ 對應 ​步驟中,您可以選取要為設定檔匯出的屬性和身分欄位。 您也可以選取將匯出檔案中的標題變更為任何您想要的易記名稱。 如需詳細資訊,請參閱啟動批次目的地UI教學課程中的對應步驟

驗證資料匯出成功 exported-data

若要驗證是否已成功匯出資料,請檢查您的Data Landing Zone儲存空間,並確定匯出的檔案包含預期的設定檔母體。

7f4d1967-bf93-4dba-9789-bb6b505339d6