資料登陸區域目的地

從Adobe CX Enterprise應用程式匯出資料檔案至您的Data Landing Zone雲端儲存位置。

支援的Adobe CX Enterprise個應用程式 supported-applications

此目的地可用於下列Adobe CX Enterprise個應用程式：

Data Landing Zone 運作方式 overview

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

Experience Platform會在七天後自動刪除Data Landing Zone容器中的所有檔案。 您也可以在七天之前手動刪除匯出的檔案。

Data Landing Zone目的地聯結器適用於在Azure或Amazon Web Services (AWS)上執行的Experience Platform。 驗證機制取決於提供目的地的雲端。 關於目的地及其使用案例的所有其他資訊都相同。 在向Azure Blob中布建的資料登陸區域進行驗證和向AWS布建的資料登陸區域進行驗證小節中，深入瞭解這兩種驗證機制。

{modal="regular"}

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

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。 受支援的對象會因您將Adobe CX Enterprise應用程式啟用至此目的地而有所不同。

Real-Time CDP supported-audiences-rtcdp

當您從Real-Time CDP啟動時，支援下列對象：

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

Real-Time CDP Collaboration supported-audiences-collaboration

在Real-Time CDP Collaboration中，您可以從Adobe Experience Platform或其他雲端來源來源對象。 Real-Time CDP Collaboration中的對象由個相符金鑰組成。 您可以在Collaboration中將這些對象用於資料共同作業或付費媒體活動。

匯出型別和頻率 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中，開啟連線對話方塊。 選取資源​視窗會出現，列出您可以連線的資源。 選取​ Blob container ​以連線至您的Data Landing Zone儲存空間。

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

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

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

如本節所述，使用Experience Platform API來擷取您的Data Landing Zone認證。 如需有關取得標頭所需值的資訊，請參閱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，請對Connectors API的/credentials端點提出POST要求。

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端點與許可權的相關資訊。 準備就緒後，選取​連線。

成功連線會以您的Data Landing Zone容器更新您的Azure Storage Explorer 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認證。 如需有關取得標頭所需值的資訊，請參閱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中布建，請確定您已將Data Landing Zone容器連線至Azure Storage Explorer，如將您的資料登陸區域容器連線至Azure儲存總管中所述。 因為Data Landing Zone是Adobe布建的存放裝置，您不需要在Experience Platform UI中執行任何進一步的步驟，即可對目的地進行驗證。

填寫目標詳細資訊 destination-details

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

啟用警示 enable-alerts

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

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

啟動此目標的對象 activate

您可以從Real-Time CDP或從Real-Time CDP Collaboration專案啟用此目的地的對象。

從Real-Time CDP啟用對象 activate-rtcdp

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

排程 scheduling

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

對應屬性和身分 map

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

從Real-Time CDP Collaboration啟用對象 activate-collaboration

如需從Real-Time CDP Collaboration專案啟用對象到此目的地的指示，請參閱Real-Time CDP Collaboration目的地概觀。

驗證資料匯出成功 exported-data

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

刪除匯出的檔案 delete-exported-files

Experience Platform會在七天後自動從您的Data Landing Zone容器中刪除匯出的檔案。 您也可以在七天之前，手動將檔案從容器中刪除。 在Azure和AWS中布建的Data Landing Zone容器都可以手動刪除。