Conexión SFTP
Registro de cambios de destino changelog
Con la versión de Experience Platform de julio de 2023, el destino SFTP proporciona nuevas funciones, como se indica a continuación:
- Compatibilidad con la exportación de conjuntos de datos.
- Opciones de nomenclatura de archivos adicionales.
- Posibilidad de establecer encabezados de archivo personalizados en los archivos exportados a través del paso de asignación mejorado.
- Capacidad para personalizar el formato de los archivos de datos CSV exportados.
Información general overview
Cree una conexión saliente activa a su servidor SFTP para exportar periódicamente archivos de datos delimitados de Adobe Experience Platform.
Conectarse al SFTP mediante la API o la IU connect-api-or-ui
- Para conectarse a su ubicación de almacenamiento SFTP mediante la interfaz de usuario de Experience Platform, lea las secciones Conectarse al destino y Activar audiencias en este destino a continuación.
- Para conectarse a su ubicación de almacenamiento SFTP 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, Experience 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, Experience 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 de conexión del servidor SFTP sftp-connection-requirements
Para garantizar el éxito de las exportaciones de datos, debe configurar el servidor SFTP de destino para permitir un número suficiente de conexiones simultáneas. Si el servidor SFTP limita el número de conexiones simultáneas, pueden producirse errores en los trabajos de exportación, especialmente al exportar varias audiencias o conjuntos de datos al mismo tiempo.
Recomendación
Para obtener un rendimiento óptimo, el servidor SFTP debe permitir al menos una conexión simultánea para cada audiencia o conjunto de datos que se exporte. Como mínimo, el servidor debe admitir al menos el 30 % del número total de audiencias o conjuntos de datos programados para la exportación al mismo tiempo.
Ejemplo
Si programa exportaciones para 100 audiencias o conjuntos de datos simultáneamente, su servidor SFTP debe permitir al menos 30 conexiones simultáneas.
La configuración correcta de los límites de conexión del servidor SFTP ayuda a evitar errores en las exportaciones y garantiza una entrega de datos fiable desde Adobe Experience Platform.
Conectar con el 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.
Información de autenticación authentication-information
Si selecciona el tipo de autenticación SFTP with password para conectarse a su ubicación SFTP:
-
Domain: la dirección de su ubicación de almacenamiento SFTP;
-
Username: el nombre de usuario para iniciar sesión en la ubicación de almacenamiento SFTP;
-
Port: el puerto que usa su ubicación de almacenamiento SFTP;
-
Password: contraseña para iniciar sesión en la ubicación de almacenamiento SFTP.
-
Encryption key: de forma opcional, puede adjuntar la clave pública con formato RSA para agregar cifrado a los archivos exportados. Vea un ejemplo de una clave de cifrado con formato correcto en la siguiente imagen.
Si selecciona el tipo de autenticación SFTP with SSH key para conectarse a su ubicación SFTP:
-
Domain: indique la dirección IP o el nombre de dominio de su cuenta SFTP
-
Port: el puerto que usa su ubicación de almacenamiento SFTP;
-
Username: el nombre de usuario para iniciar sesión en la ubicación de almacenamiento SFTP;
-
SSH Key: la clave SSH privada utilizada para iniciar sesión en la ubicación de almacenamiento SFTP. La clave privada debe ser una cadena codificada en Base64 con formato RSA y no debe estar protegida con contraseña.
-
Encryption key: de forma opcional, puede adjuntar la clave pública con formato RSA para agregar cifrado a los archivos exportados. Vea un ejemplo de una clave de cifrado con formato correcto en la siguiente imagen.
Detalles del destino destination-details
Después de establecer la conexión de autenticación con la ubicación SFTP, proporcione la siguiente información para el destino:
-
Name: escriba un nombre que le ayude a identificar este destino en la interfaz de usuario de Experience Platform;
-
Description: escriba una descripción para este destino;
-
Folder path: escriba la ruta de acceso a la carpeta de la ubicación SFTP donde se exportarán los archivos.
-
File type: seleccione el formato que Experience Platform debe usar para los archivos exportados. Al seleccionar la opción CSV, también puede configurar las opciones de formato de archivo.
-
Compression format: seleccione el tipo de compresión que Experience Platform debe utilizar para los archivos exportados.
-
Include manifest file: 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. 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.
Activar públicos en este destino activate
- Para activar los datos, necesita los permisos de control de acceso View Destinations, Activate Destinations, View Profiles y View Segments 5}. 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 View Identity Graph permiso de control de acceso.
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.
Validación de la exportación de datos correcta exported-data
Para comprobar si los datos se han exportado correctamente, compruebe el almacenamiento SFTP y asegúrese de que los archivos exportados contienen las poblaciones de perfiles esperadas.
LISTA DE PERMITIDOS de direcciones IP ip-address-allow-list
Consulte el artículo lista de permitidos de direcciones IP si necesita agregar direcciones IP de Adobe a una lista de permitidos.