数据登陆区目标

将数据文件从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会在7天后自动删除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文件。 有关这些文件的更多信息，请参阅Audience Activation教程中的导出的支持文件格式部分。

导出​ 数据集 ​时，Experience 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 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用户界面。

在将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 Storage Explorer中所述。 由于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会在7天后自动从Data Landing Zone容器中删除导出的文件。 您也可以在七天之前手动从容器中删除文件。 手动删除可用于在Azure和AWS中配置的Data Landing Zone容器。