数据登陆区目标

概述 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

支持的受众 supported-audiences

此部分介绍哪些类型的受众可以导出到此目标。

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息，请参阅下表。

导出数据集 export-datasets

此目标支持数据集导出。 有关如何设置数据集导出的完整信息，请阅读教程：

导出数据的文件格式 file-format

导出​ 受众数据 ​时，Platform会在您提供的存储位置创建一个.csv、parquet或.json文件。 有关这些文件的更多信息，请参阅Audience Activation教程中的导出的支持文件格式部分。

导出​ 数据集 ​时，Platform会在您提供的存储位置创建一个.parquet或.json文件。 有关这些文件的更多信息，请参阅导出数据集教程中的验证成功的数据集导出部分。

对Azure Blob中配置的数据登陆区进行身份验证 authenticate-dlz-azure

您可以通过Azure Storage Explorer或命令行界面将文件读取和写入容器。

Data Landing Zone支持基于SAS的身份验证，其数据受标准Azure Blob存储安全机制的静态和传输保护。 SAS代表共享访问签名。

要通过公共Internet连接保护您的数据，请使用基于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存储。

接下来，选择​ 共享访问签名URL (SAS) ​作为连接方法，然后选择​ 下一步。

选择连接方法后，必须提供与Data Landing Zone容器对应的​ 显示名称 ​和​ Blob容器SAS URL。

检索Data Landing Zone的凭据 retrieve-dlz-credentials

您必须使用平台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

您还可以在需要时刷新凭据。 您可以通过向Connectors API的/credentials端点发出POST请求来更新SASToken。

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用户界面。

在将Data Landing Zone容器连接到Azure Storage Explorer后，您现在可以开始将文件从Experience Platform导出到Data Landing Zone容器。 要导出文件，必须在Experience PlatformUI中建立与Data Landing Zone目标的连接，如以下部分所述。

对AWS设置的数据登陆区进行身份验证 authenticate-dlz-aws

执行以下操作以获取在AWS上配置的Data Landing Zone实例的凭据。 然后，使用选择的客户端连接到Data Landing Zone实例。

检索Data Landing Zone的凭据 retrieve-dlz-credentials-aws

您必须使用平台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 PlatformUI中执行任何进一步的步骤即可向目标进行身份验证。

填写目标详细信息 destination-details

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

启用警报 enable-alerts

您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。

完成提供目标连接的详细信息后，选择​ 下一步。

激活此目标的受众 activate

有关将受众激活到此目标的说明，请参阅将受众数据激活到批量配置文件导出目标。

计划中

在​ 计划 ​步骤中，您可以为Data Landing Zone目标设置导出计划，还可以配置导出文件的名称。

映射属性和身份 map

在​ 映射 ​步骤中，您可以为配置文件选择要导出的属性和标识字段。 您还可以选择将导出文件中的标头更改为所需的任何友好名称。 有关详细信息，请查看激活批处理目标UI教程中的映射步骤。

验证数据导出是否成功 exported-data

要验证是否已成功导出数据，请检查您的Data Landing Zone存储并确保导出的文件包含预期的配置文件人口。