Intercambio de datos SFTP

Nuestra solución SFTP (protocolo seguro de transferencia de archivos) es una solución zero-touch, segura end-to-end. Automatiza el envío del archivo de datos utilizado para conectar con nuestra solución de correo electrónico de marketing de gestión de relaciones con los clientes (CRM).

Pasos para configurar one-time

Para configurar la alimentación de datos de marketing, realizarás un proceso de cifrado de archivos y SFTP en one-time para generar claves públicas y privadas para la transferencia segura de archivos a Expedia.

Paso 1: Solicita los identificadores de tu sitio web

Necesitarás tres valores de identificador de sitio para configurar el intercambio de archivos SFTP:

ID del sitio: Un identificador único para el sitio de tu plantilla.
tpid: El identificador del producto de viaje, que, junto con el eapid, define un punto de venta en el sistema Expedia.
eapid: El identificador del socio afiliado a Expedia, que, junto con el tpid, define un punto de venta en el sistema Expedia.

Debes utilizar el formulario de asistencia de nuestro sitio Partner Solutions para solicitar estos valores a tu gestor de cuenta.

Paso 2: Crea tus claves

Utiliza el método que prefieras para generar la clave pública y privada para SFTP y la configuración de la encriptación de archivos.

Utilizando el terminal (MacOS X) o la línea de comandos (Windows)

En el terminal de Mac o en la línea de comandos de Windows, introduce user@localhost: ssh-keygen -t rsa.
Nota: Si el comando falla, consulta con tu departamento informático para asegurarte de que tienes permisos suficientes para ejecutarlo.
Cuando se te solicite, deja vacía la petición de frase de contraseña.
Guarda tus llaves en un lugar seguro.

Asegúrate de guardar las llaves en un lugar seguro. Si pierdes tu clave privada, tendrás que reiniciar el SFTP.

Utilizar un generador de claves

1. Descarga e instala un generador de claves.
Utiliza el generador para crear un par de claves RSA pública/privada.
Copia la clave pública, que empieza por ssh-rsa. Esto es lo que enviarás a Expedia Group.
Guarda la clave privada en un lugar seguro. No lo borres: lo utilizarás en lugar de la contraseña cada vez que envíes el archivo encriptado.

Asegúrate de guardar tu clave privada en un lugar seguro. Si pierdes la clave, tendrás que reiniciar el SFTP.

Paso 3: Comparte tu clave con Expedia

Compartirás de forma segura tu clave pública SFTP con Expedia. Almacenaremos esta clave de forma segura y crearemos una cuenta desde la que podrás autenticar la conexión SFTP. Te daremos un nombre de usuario para que lo utilices en el proceso file-sharing.

Importante

Expedia utiliza SharePoint como repositorio seguro de claves. Si tu organización bloquea el acceso a SharePoint, también puedes enviar la clave pública por correo electrónico seguro. Habla con tu gestor de cuenta si esto te supone un problema.

Envíanos el nombre de tu organización y la dirección de correo electrónico desde la que subirás la clave SFTP pública a través de #.SharePoint. Tu gestor de lanzamientos de Expedia te facilitará la dirección de correo electrónico.
Crearemos una carpeta en SharePoint específica para tu organización y enviaremos un enlace de acceso a la dirección de correo electrónico que nos hayas facilitado. También subiremos nuestra clave pública que se utiliza para encriptar el archivo antes de subirlo.
Una vez que recibas ese correo electrónico de acceso, harás clic en el enlace para generar el código de acceso necesario. (Nota: Asegúrate de comprobar tu carpeta de correo no deseado si el código de acceso no aparece en tu bandeja de entrada en el plazo de 2 días laborables).
Subirás la clave pública que has generado a la carpeta que hemos creado y descargarás el gpg_encryption_public_key.ascde la carpeta.
Nos pondremos en contacto contigo cuando la cuenta SFTP esté lista para su uso.

Formato y estructura del archivo

Para cargar correctamente los archivos de datos CRM, deben cumplir los siguientes criterios.

Para empezar, el formato del archivo debe ser .csv. Cuando encriptes el archivo, cambiarás la extensión del archivo a .gpg.
Utiliza tubos (|), no comas, para delimitar los campos.
La convención para nombrar los archivos no debe incluir caracteres especiales que no sean guiones bajos (_). El nombre del archivo debe empezar por eps_crm_marketing, seguido del nombre de tu organización; los tpid, eapid, y site_idcompartidos por el administrador de tu cuenta; y la fecha de subida. Por ejemplo: eps_crm_marketing_<PartnerName>_<tpid>_<eapid>_<site_id>_YYYYMMDD.csv.
Los datos del fichero deben tener todas las columnas de la tabla siguiente, en orden, y deben incluir valores en todos los campos obligatorios.

Nombre de columna	Definición	Valor de muestra	Tipo	Campo obligatorio
`first_name`	Nombre del cliente	Chris	Varchar	—
`last_name`	Apellido del cliente	Smith	Varchar	—
`email`	Correo electrónico para un cliente	chris.smith@hotmail.com	Varchar	Sí
`mer_flag`	Marketing-eligible indicador de registro; la decisión del cliente de aceptar (SÍ) o rechazar (NO) el marketing por correo electrónico	Sí	Varchar	Sí
`mer_timestamp`	Fecha y hora en que el cliente decidió aceptar o rechazar el servicio	2021-06-12 20:14:23.000000	Varchar	Sí
`lang_id`	El idioma del sitio (consulta la tabla Locale details); este valor no es case-sensitive	en_US en_FR	Varchar	Sí
`tpid`	ID de producto de viaje facilitado por tu gestor de cuenta de Expedia	0000	Número	Sí
`eapid`	Expedia ID de socio afiliado facilitado por el gestor de cuentas de Expedia	1234	Número	Sí
`site_id`	Identificador único para el sitio de la plantilla proporcionado por el administrador de la cuenta Expedia	5678	Número	Sí
`points_balance`	El saldo de puntos de fidelidad del cliente	100000	Número (13 dígitos máx.)	—
`points_cash_value`	El valor en metálico de los puntos de fidelidad del cliente	250	Varchar (10 caracteres máx.)	—
`cash_value_currency`	La moneda en la que se valoran los puntos de fidelidad	USD	Texto (máximo 3 caracteres)	—
`credit_card_type`	El tipo de tarjeta de crédito utilizada para la transacción	YourBrand tarjeta	Texto (máx. 25 caracteres)	—
`loyalty_tier`	El nivel de fidelidad del cliente dentro de tu programa	Platinum	Texto (máx. 25 caracteres)	—
`attribute1` `attribute2` `attribute3`	3 campos utilizados para compartir información adicional sobre el cliente	Viajero frecuente	Varchar (25 caracteres máx.)	—

Ejemplo de contenido de un archivo CSV

El archivo .csv incluirá cada elemento de la información, separado por caracteres de tubería (|). Los tubos actúan como divisores de columnas, y cada campo es la cabecera de la columna para la información que hay debajo.

Conexión y carga SFTP

Antes de subir tus datos, debes encriptar el archivo.

Cifrado

Utilizamos encriptación PGP para proteger la información personal identificable (IPI). Utilizarás nuestra clave pública (que te proporcionaremos) para encriptar tu archivo .csv. Puedes utilizar las herramientas de encriptación que prefieras, pero nosotros solemos trabajar con herramientas de encriptación GPG.

Pide a tu gestor de lanzamientos de Expedia la dirección de correo electrónico que debe utilizarse como destino de importación de la clave pública Expedia
No encriptes con una contraseña; para ello utilizarás tu clave privada
Guarda el archivo encriptado con una extensión .gpg

Carga de archivos

El siguiente paso es subir tu archivo encriptado: puedes utilizar cualquier herramienta de conectividad SFTP. Asegúrate de seleccionar SFTP como protocolo, e introduce estos datos:

Servidor: s-b1b59c1d2afa43cba.server.transfer.us-west-2.amazonaws.com
Puerto: 22
Nombre de usuario: <partnername-username> (por ejemplo, BestTravel-CRMteam o BestTravel-Asmith)
Clave privada SSH: la clave privada que has generado

Puedes automatizar la frecuencia con la que se cargan tus archivos SFTP en función de las necesidades empresariales de tu organización.