Destino de zona de aterrizaje de datos
Información general overview
Data Landing Zone es una interfaz de almacenamiento de Azure Blob aprovisionada por Adobe Experience Platform, que le otorga acceso a una función de almacenamiento de archivos segura y basada en la nube para exportar archivos fuera de Platform. Tiene acceso a un contenedor Data Landing Zone por zona protegida, y el volumen total de datos en todos los contenedores se limita a los datos totales proporcionados con su licencia de productos y servicios de Platform. Todos los clientes de Platform y sus aplicaciones, como Customer Journey Analytics, Journey Orchestration, Intelligent Services y Real-Time Customer Data Platform, se han aprovisionado con un contenedor de Data Landing Zone por zona protegida. Puede leer y escribir archivos en el contenedor a través de Azure Storage Explorer o de la interfaz de línea de comandos.
Data Landing Zone admite la autenticación basada en SAS y sus datos están protegidos con mecanismos de seguridad de almacenamiento estándar de Azure Blob en reposo y en tránsito. SAS significa firma de acceso compartido.
La autenticación basada en SAS le permite tener acceso de forma segura a su contenedor de Data Landing Zone a través de una conexión pública a Internet. No se requieren cambios de red para tener acceso al contenedor de Data Landing Zone, lo que significa que no es necesario configurar listas de permitidos ni configuraciones entre regiones para la red.
Platform aplica un tiempo de vida (TTL) estricto de siete días a todos los archivos cargados en un contenedor de Data Landing Zone. Todos los archivos se eliminan a los siete días.
Conéctese a su almacenamiento de zona de aterrizaje de datos mediante la API o la interfaz de usuario connect-api-or-ui
- Para conectarse a su ubicación de almacenamiento de la zona de aterrizaje de datos mediante la interfaz de usuario de Platform, lea las secciones Conectarse al destino y Activar audiencias en este destino a continuación.
- Para conectarse a su ubicación de almacenamiento de Zona de aterrizaje de datos mediante programación, lea Activar audiencias en destinos basados en archivos mediante el tutorial de la API de Flow Service.
Audiencias compatibles supported-audiences
Esta sección describe qué tipos de audiencias puede exportar a este destino.
Tipo y frecuencia de exportación export-type-frequency
Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.
Exportar conjuntos de datos export-datasets
Este destino admite exportaciones de conjuntos de datos. Para obtener información completa sobre cómo configurar exportaciones de conjuntos de datos, lea los tutoriales:
Formato de archivo de los datos exportados file-format
Al exportar datos de audiencia, Platform crea un archivo de .csv, parquet o .json en la ubicación de almacenamiento proporcionada. Para obtener más información sobre los archivos, consulte la sección formatos de archivo compatibles con la exportación en el tutorial de activación de audiencia.
Al exportar conjuntos de datos, Platform crea un archivo de .parquet o .json en la ubicación de almacenamiento proporcionada. Para obtener más información sobre los archivos, consulte la sección verificar la exportación correcta del conjunto de datos en el tutorial exportar conjuntos de datos.
Requisitos previos prerequisites
Tenga en cuenta los siguientes requisitos previos que deben cumplirse para poder usar el destino Data Landing Zone.
Conectar su contenedor de Data Landing Zone a Azure Storage Explorer
Puede usar Azure Storage Explorer para administrar el contenido de su contenedor de Data Landing Zone. Para empezar a usar Data Landing Zone, primero debe recuperar las credenciales, introducirlas en Azure Storage Explorer y conectar el contenedor de Data Landing Zone a Azure Storage Explorer.
En la interfaz de usuario Azure Storage Explorer, seleccione el icono de conexión en la barra de navegación izquierda. Aparecerá la ventana Seleccionar recurso, que le proporcionará las opciones para conectarse a. Seleccione Blob container para conectarse a su almacenamiento de Data Landing Zone.
A continuación, seleccione URL de firma de acceso compartido (SAS) como método de conexión y, a continuación, seleccione Siguiente.
Después de seleccionar el método de conexión, debe proporcionar un nombre para mostrar y la URL de SAS de contenedor Blob que corresponda a su contenedor Data Landing Zone.
Recuperar las credenciales de su Data Landing Zone retrieve-dlz-credentials
Debe usar las API de Platform para recuperar sus credenciales de Data Landing Zone. A continuación, se describe la llamada de API para recuperar sus credenciales. Para obtener información sobre cómo obtener los valores requeridos para los encabezados, consulte la guía Introducción a las API de Adobe Experience Platform.
Formato de API
GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
dlz_destinationdlz_destination permite a la API distinguir un contenedor de destino de zona de aterrizaje de otros tipos de contenedores disponibles para usted.Solicitud
El siguiente ejemplo de solicitud recupera las credenciales de una zona de aterrizaje existente.
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' \
Respuesta
La siguiente respuesta devuelve la información de credenciales de la zona de aterrizaje, incluidos los SASToken y SASUri actuales, y el storageAccountName que corresponde al contenedor de la zona de aterrizaje.
{
"containerName": "dlz-user-container",
"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-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
containerNameSASTokenSASUriActualizar credenciales de Data Landing Zone update-dlz-credentials
También puede actualizar sus credenciales cuando lo desee. Puede actualizar su SASToken realizando una solicitud de POST al extremo /credentials de la API Connectors.
Formato de API
POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
dlz_destinationdlz_destination permite a la API distinguir un contenedor de destino de zona de aterrizaje de otros tipos de contenedores disponibles para usted.refreshrefresh le permite restablecer las credenciales de su zona de aterrizaje y generar automáticamente un nuevo SASToken.Solicitud
La siguiente solicitud actualiza las credenciales de la zona de aterrizaje.
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' \
Respuesta
La siguiente respuesta devuelve valores actualizados para su SASToken y SASUri.
{
"containerName": "dlz-user-container",
"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-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}
Proporcione su nombre para mostrar (containerName) y la URL SAS Data Landing Zone, tal como se devolvió en la llamada de API descrita anteriormente, y luego seleccione Siguiente.
Aparece la ventana Resumen, que le proporciona una descripción general de la configuración, incluida información sobre el extremo y los permisos de Blob. Cuando esté listo, seleccione Conectar.
Una conexión correcta actualiza la interfaz de usuario de Azure Storage Explorer con el contenedor de Data Landing Zone.
Con el contenedor Data Landing Zone conectado a Azure Storage Explorer, ahora puede empezar a exportar archivos del Experience Platform al contenedor Data Landing Zone. Para exportar archivos, debe establecer una conexión con el destino Data Landing Zone en la interfaz de usuario del Experience Platform, tal como se describe en la sección siguiente.
Conexión al destino connect
Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.
Autenticarse en el destino authenticate
Asegúrese de haber conectado su contenedor de Data Landing Zone a Azure Storage Explorer tal como se describe en la sección requisitos previos. Dado que Data Landing Zone es un almacenamiento aprovisionado por Adobe, no es necesario que realice ningún paso adicional en la interfaz de usuario del Experience Platform para autenticarse en el destino.
Rellenar detalles de destino destination-details
Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
-
Nombre: rellene el nombre preferido para este destino.
-
Descripción: Opcional. Por ejemplo, puede mencionar para qué campaña está usando este destino.
-
Ruta de carpeta: escriba la ruta de acceso a la carpeta de destino que alojará los archivos exportados.
-
Tipo de archivo: seleccione el formato que el Experience Platform debe usar para los archivos exportados. Al seleccionar la opción CSV, también puede configurar las opciones de formato de archivo.
-
Formato de compresión: seleccione el tipo de compresión que el Experience Platform debe usar para los archivos exportados.
-
Incluir archivo de manifiesto: Active esta opción si desea que las exportaciones incluyan un archivo JSON de manifiesto que contenga información sobre la ubicación de exportación, el tamaño de la exportación, etc. Se ha asignado un nombre al manifiesto con el formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Ver archivo de manifiesto de ejemplo. El archivo de manifiesto incluye los campos siguientes:flowRunId: la ejecución de flujo de datos que generó el archivo exportado.scheduledTime: la hora en UTC en que se exportó el archivo.exportResults.sinkPath: ruta de acceso de la ubicación de almacenamiento en la que se deposita el archivo exportado.exportResults.name: nombre del archivo exportado.size: tamaño del archivo exportado, en bytes.
Habilitar alertas enable-alerts
Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.
Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.
Activar públicos en este destino activate
- Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
- Para exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
Consulte Activar datos de audiencia en destinos de exportación de perfiles por lotes para obtener instrucciones sobre cómo activar audiencias en este destino.
Programación
En el paso Programación, puede configurar la programación de exportación para su destino Data Landing Zone y también configurar el nombre de los archivos exportados.
Asignar atributos e identidades map
En el paso Asignación, puede seleccionar qué campos de atributo e identidad desea exportar para sus perfiles. También puede seleccionar cambiar los encabezados del archivo exportado por cualquier nombre descriptivo que desee. Para obtener más información, vea el paso de asignación en el tutorial de la interfaz de usuario para activar destinos por lotes.
Validación de la exportación de datos correcta exported-data
Para comprobar si los datos se han exportado correctamente, compruebe el almacenamiento de Data Landing Zone y asegúrese de que los archivos exportados contienen las poblaciones de perfiles esperadas.