数据登陆区目标

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

支持的受众 supported-audiences

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

受众来源
支持
描述
Segmentation Service
✓ {\f13 }
通过Experience Platform分段服务生成的受众。
自定义上传
✓ {\f13 }
受众已将从CSV文件导入到Experience Platform中。

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

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

项目
类型
注释
导出类型
基于配置文件
您正在导出区段的所有成员,以及适用的架构字段(例如,PPID),如目标激活工作流的选择配置文件属性屏幕中所选。
导出频率
批次
批量目标以三、六、八、十二或二十四小时的增量将文件导出到下游平台。 阅读有关基于批处理文件的目标的详细信息。

导出数据集 export-datasets

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

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

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

导出​ 受众数据 ​时,Platform会在您提供的存储位置创建一个.csvparquet.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' \

响应

以下响应返回登陆区域的凭据信息,包括当前的SASTokenSASUri以及与登陆区域容器对应的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' \

响应

以下响应返回您的SASTokenSASUri的更新值。

{
    "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调用中所返回),然后选择​ 下一步

输入在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:导出文件的大小(字节)。

启用警报 enable-alerts

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

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

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据,您需要​ 查看目标激活目标查看配置文件 ​和​ 查看区段 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

  • 要导出​ 标识,您需要​ 查看标识图形 访问控制权限

    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

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

计划中

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

映射属性和身份 map

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

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

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

7f4d1967-bf93-4dba-9789-bb6b505339d6