資料登陸區域目的地

Last update: Fri Jan 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
目標

建立對象：

管理員
使用者

IMPORTANT

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

概觀 overview

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

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

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

圖表顯示根據雲端支援，資料登陸區域目的地的實作方式有何不同。由雲端支援進行的 {modal="regular"}

透過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會在您提供的儲存位置中建立.csv、parquet或.json檔案。如需檔案的詳細資訊，請參閱對象啟動教學課程中的匯出支援的檔案格式一節。

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

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

AVAILABILITY

本節適用於在Microsoft Azure上執行的Experience Platform實作。若要深入瞭解支援的Experience Platform基礎結構，請參閱Experience Platform多雲端總覽。

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

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

若要透過公用網際網路連線保護您的資料，請使用SAS式驗證來安全地存取您的Data Landing Zone容器。您不需要變更網路即可存取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' \

回應

下列回應會傳回您登陸區域的認證資訊，包括目前的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"
}

屬性

說明

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

回應

下列回應會傳回您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"
}

style

shade-box

提供顯示名稱(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目的地的連線，如下節所述。

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

AVAILABILITY

本節適用於在Amazon Web Services (AWS)上執行的Experience Platform實作。在AWS上執行的Experience Platform目前可供有限數量的客戶使用。若要深入瞭解支援的Experience Platform基礎結構，請參閱Experience Platform多雲端總覽。

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

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

API格式

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

查詢參數

說明

dlz_destination

新增dlz_destination查詢引數，以指定您要擷取Data Landing Zone 目的地 型別的容器認證。若要連線並擷取資料登陸區域來源的認證，請檢視來原始檔。

要求

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

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
}

屬性

說明

credentials

此物件包含Experience Platform用來將檔案匯出至您布建的資料登陸區域位置的awsAccessKeyId、awsSecretAccessKey和awsSessionToken。

dlzPath

此物件包含存放匯出檔案的Adobe布建AWS位置中的路徑。

dlzProvider

指出這是Amazon S3布建的資料登陸區域。

expiryTime

指示credentials物件中的認證何時到期。若要重新整理認證，請再次執行請求。

style

shade-box

連線到目標 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：匯出的檔案大小（位元組）。