Destino de zona de aterrizaje de datos

Última actualización: 2023-11-04
  • Creado para:
  • Developer
    User
    Admin
    Leader
IMPORTANTE

Esta página de documentación hace referencia a Data Landing Zone destino. También hay un Data Landing Zone origen en el catálogo de fuentes. Para obtener más información, lea la Data Landing Zone origen documentación.

Información general

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 uno Data Landing Zone contenedor por zona protegida y el volumen total de datos en todos los contenedores se limita a los datos totales proporcionados con la licencia de productos y servicios de Platform. Todos los clientes de Platform y sus servicios de aplicaciones como Customer Journey Analytics, Journey Orchestration, Intelligent Services, y Real-Time Customer Data Platform se han aprovisionado con uno Data Landing Zone contenedor por zona protegida. Puede leer y escribir archivos en el contenedor mediante Azure Storage Explorer o su interfaz de línea de comandos.

Data Landing Zone admite la autenticación basada en SAS y sus datos están protegidos con Azure Blob mecanismos de seguridad de almacenamiento en reposo y en tránsito. La autenticación basada en SAS le permite acceder de forma segura a su Data Landing Zone a través de una conexión pública a internet. No se requieren cambios de red para acceder a su Data Landing Zone contenedor, lo que significa que no es necesario configurar listas de permitidos ni configuraciones entre regiones para la red.

Platform aplica un estricto tiempo de vida de siete días (TTL) a todos los archivos cargados en una Data Landing Zone contenedor. Todos los archivos se eliminan a los siete días.

Conéctese a su Zona de aterrizaje de datos mediante API o IU

Audiencias compatibles

Esta sección describe qué tipo de audiencias puede exportar a este destino.

Origen de audiencia Admitido Descripción
Segmentation Service Audiencias generadas mediante el Experience Platform Servicio de segmentación.
Cargas personalizadas Audiencias importado en el Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Elemento Tipo Notas
Tipo de exportación Basado en perfiles Está exportando todos los miembros de un segmento, junto con los campos de esquema aplicables (por ejemplo, su PPID), tal como se elige en la pantalla Seleccionar atributos de perfil del flujo de trabajo de activación de destino.
Frecuencia de exportación Lote Los destinos por lotes exportan archivos a plataformas descendentes en incrementos de tres, seis, ocho, doce o veinticuatro horas. Más información sobre destinos basados en archivos por lotes.

Requisitos previos

Tenga en cuenta los siguientes requisitos previos que deben cumplirse para poder utilizar la variable Data Landing Zone destino.

Conecte su Data Landing Zone contenedor a Azure Storage Explorer

Puede utilizar Azure Storage Explorer para administrar el contenido de su Data Landing Zone contenedor. Para empezar a utilizar Data Landing Zone, primero debe recuperar las credenciales e introducirlas en Azure Storage Explorery conecte su Data Landing Zone contenedor a Azure Storage Explorer.

En el Azure Storage Explorer IU, seleccione el icono de conexión en la barra de navegación izquierda. El Seleccionar medio aparece una ventana de, que le proporciona opciones para conectarse a. Seleccionar Blob container para conectarse a su Data Landing Zone almacenamiento.

select-resource

A continuación, seleccione URL de firma de acceso compartido (SAS) como método de conexión y, a continuación, seleccione Siguiente.

select-connection-method

Después de seleccionar el método de conexión, debe proporcionar un nombre para mostrar y el BlobURL de SAS de contenedor que se corresponde con su Data Landing Zone contenedor.

Recupere las credenciales de su Data Landing Zone

Debe utilizar las API de Platform para recuperar los Data Landing Zone credenciales. A continuación, se describe la llamada de API para recuperar sus credenciales. Para obtener información sobre la obtención de los valores necesarios para los encabezados, consulte la Introducción a las API de Adobe Experience Platform guía.

Formato de API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
Parámetros de consulta Descripción
dlz_destination El dlz_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, incluida la actual SASToken y SASUri, 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"
}
Propiedad Descripción
containerName El nombre de su zona de aterrizaje.
SASToken El token de firma de acceso compartido para su zona de aterrizaje. Esta cadena contiene toda la información necesaria para autorizar una solicitud.
SASUri El URI de firma de acceso compartido para su zona de aterrizaje. Esta cadena es una combinación del URI de la zona de aterrizaje para la que se está autenticando y su token SAS correspondiente,

Actualizar Data Landing Zone credenciales

También puede actualizar sus credenciales cuando lo desee. Puede actualizar su SASToken realizando una petición de POST a la /credentials punto final del Connectors API.

Formato de API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Parámetros de consulta Descripción
dlz_destination El dlz_destination permite a la API distinguir un contenedor de destino de zona de aterrizaje de otros tipos de contenedores disponibles para usted.
refresh El refresh Esta acción le permite restablecer las credenciales de su zona de aterrizaje y generar automáticamente una nueva 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 Data Landing Zone URL de SAS, tal como se devuelve en la llamada de API descrita anteriormente, y luego seleccione Siguiente.

enter-connection-info

El Resumen aparece una ventana que le proporciona información general sobre su configuración, incluida la información sobre su Blob punto de conexión y permisos. Cuando esté listo, seleccione Connect.

summary

Una conexión correcta actualiza su Azure Storage Explorer Interfaz de usuario con su Data Landing Zone contenedor.

dlz-user-container

Con su Data Landing Zone contenedor conectado a Azure Storage Explorer, ahora puede empezar a exportar archivos de Experience Platform a su Data Landing Zone contenedor. Para exportar archivos, debe establecer una conexión con el Data Landing Zone en la interfaz de usuario de Experience Platform, tal como se describe en la sección siguiente.

Conexión al destino

IMPORTANTE

Para conectarse al destino, necesita el Administrar destinos permiso de control de acceso. Lea el información general de control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Para conectarse a este destino, siga los pasos descritos en la sección 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

Asegúrese de haber conectado su Data Landing Zone contenedor a Azure Storage Explorer como se describe en la requisitos previos sección. Porque Data Landing Zone es un almacenamiento aprovisionado por Adobe, no es necesario realizar ningún paso adicional en la interfaz de usuario de Experience Platform para autenticarse en el destino.

Rellenar detalles de destino

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: complete el nombre preferido para este destino.
  • Descripción: Opcional. Por ejemplo, puede mencionar para qué campaña está usando este destino.
  • Ruta de carpeta: introduzca la ruta a la carpeta de destino que alojará los archivos exportados.
  • Tipo de archivo: seleccione el Experience Platform de formato que debe utilizar para los archivos exportados. Al seleccionar la variable CSV , también puede hacer lo siguiente configurar las opciones de formato de archivo.
  • Formato de compresión: seleccione el tipo de compresión que el Experience Platform debe utilizar 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 exportación, etc. El nombre del manifiesto se asigna mediante el formato manifest-<<destinationId>>-<<dataflowRunId>>.json. Ver una archivo de manifiesto de muestra. 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 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

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 de suscripción a alertas de destinos mediante la IU.

Cuando haya terminado de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino

IMPORTANTE

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 Programación paso, puede configuración de la programación de exportación para su Data Landing Zone y también puede hacer lo siguiente configurar el nombre de los archivos exportados.

Asignar atributos e identidades

En el Asignación paso, puede seleccionar qué campos de atributo e identidad desea exportar para los perfiles. También puede seleccionar cambiar los encabezados del archivo exportado por cualquier nombre descriptivo que desee. Para obtener más información, consulte paso de asignación en el tutorial de la interfaz de usuario activar destinos por lotes.

Exportar conjuntos de datos

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:

Validación de la exportación de datos correcta

Para comprobar si los datos se han exportado correctamente, compruebe su Data Landing Zone y asegúrese de que los archivos exportados contienen las poblaciones de perfiles esperadas.

En esta página