資料登陸區域目的地

概觀 overview

Data Landing Zone是由Adobe Experience Platform布建的雲端儲存空間介面，可授予您安全、雲端式的檔案儲存機制存取權，以將檔案匯出Experience Platform。 您有權存取每個沙箱一個Data Landing Zone容器，而且所有容器的資料量總計以您的Experience Platform產品和服務授權所提供的資料量為限。 Experience Platform及其應用程式（例如Customer Journey Analytics、Journey Orchestration、Intelligent Services和Real-Time Customer Data Platform）的所有客戶都已為每個沙箱布建一個Data Landing Zone容器。

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

使用Azure或Amazon Web Service雲端支援的客戶可使用Data Landing Zone目的地聯結器。 根據布建目的地的雲端，驗證機制會不同，有關目的地及其使用案例的所有其他專案都相同。 在向Azure Blob中布建的資料登陸區域驗證和向AWS布建的資料登陸區域驗證小節中，深入瞭解兩種不同的驗證機制。

{modal="regular"}

透過API或UI連線至您的Data Landing Zone儲存空間 connect-api-or-ui

支援的對象 supported-audiences

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

依受眾資料型別支援的受眾：

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

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

匯出資料集 export-datasets

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

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

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

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

驗證Azure Blob中布建的資料登陸區域 authenticate-dlz-azure

您可以透過Azure Storage Explorer或命令列介面讀取及寫入檔案到容器。

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

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

將您的Data Landing Zone容器連線至Azure Storage Explorer connect-container-to-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儲存空間。

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

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

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

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

API格式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

要求

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

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' \

回應

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

{
    "containerName": "dlz-destination",
    "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-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

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

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

API格式

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

要求

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

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' \

回應

下列回應會傳回您SASToken和SASUri的更新值。

{
    "containerName": "dlz-destination",
    "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-destination?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呼叫中所傳回），然後選取​下一步。

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

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

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

驗證AWS布建的資料登陸區域 authenticate-dlz-aws

執行以下作業，以取得您在AWS上布建之Data Landing Zone執行個體的認證。 然後，使用所選的使用者端連線至您的Data Landing Zone執行個體。

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

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

API格式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination'

要求

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

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

回應

下列回應會傳回您登陸區域的認證資訊，包括目前的awsAccessKeyId、awsSecretAccessKey和其他資訊。

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

連線到目標 connect

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

驗證目標 authenticate

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

填寫目標詳細資訊 destination-details

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

啟用警示 enable-alerts

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

當您完成提供目的地連線的詳細資訊時，請選取​Next。

啟動此目標的對象 activate

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

排程 scheduling

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

對應屬性和身分 map

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

驗證資料匯出成功 exported-data

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