数据登陆区目标

Last update: Thu Oct 17 2024 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 提供的一个 Azure Blob 存储接口，它准许您访问安全、基于云的文件存储设施以将文件导出到 Platform 之外。您有权访问每个沙盒一个Data Landing Zone容器，所有容器的总数据量以您的Platform产品和服务许可证提供的总数据为限。 Platform及其应用程序（如Customer Journey Analytics、Journey Orchestration、Intelligent Services和Real-Time Customer Data Platform）的所有客户都为每个沙盒配置了一个Data Landing Zone容器。您可以通过Azure Storage Explorer或命令行界面将文件读取和写入容器。

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

基于SAS的身份验证允许您通过公共Internet连接安全地访问Data Landing Zone容器。访问Data Landing Zone容器不需要更改网络，这意味着您不需要为网络配置任何允许列表或跨区域设置。

Platform对上传到Data Landing Zone容器的所有文件强制实施严格的七天生存时间(TTL)。所有文件都会在七天后删除。

通过API或UI连接到您的数据登陆区存储 connect-api-or-ui

要使用Platform用户界面连接到数据登陆区域存储位置，请阅读下面的连接到目标和将受众激活到此目标部分。
若要以编程方式连接到数据登陆区域存储位置，请阅读使用流服务API教程将受众激活到基于文件的目标。

支持的受众 supported-audiences

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

受众来源

支持

描述

Segmentation Service

✓ {\f13 }

通过Experience Platform分段服务生成的受众。

自定义上传

✓ {\f13 }

受众已将从CSV文件导入到Experience Platform中。

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

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

项目

类型

注释

导出类型

基于配置文件

您正在导出区段的所有成员，以及适用的架构字段（例如，PPID），如目标激活工作流的选择配置文件属性屏幕中所选。

导出频率

批次

批量目标以三、六、八、十二或二十四小时的增量将文件导出到下游平台。阅读有关基于批处理文件的目标的详细信息。

导出数据集 export-datasets

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

如何使用Platform用户界面🔗导出数据集。
如何使用流服务API🔗以编程方式导出数据集。

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

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

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

先决条件 prerequisites

请注意，在使用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

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

登陆区域的共享访问签名令牌。此字符串包含授权请求所需的所有信息。

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

Azure UI中突出显示的DLZ用户容器摘要。

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

连接到目标 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：导出文件的大小（字节）。