Intercambio de datos por 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 que se usa para conectarse a nuestra solución de marketing por correo electrónico basada en el sistema de gestión de relaciones con los clientes (CRM).

Pasos para configurar « one-time »

Para configurar el feed de datos de marketing, tendrás que realizar un proceso de « one-time » (generación de claves) mediante SFTP y cifrado de archivos para generar claves públicas y privadas que permitan 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 por SFTP:

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

Deberías usar el formulario de asistencia que hay en nuestra Página de soluciones para socios Para pedirle estos datos a tu gestor de cuenta.

Paso 2: Crea tus claves

Utiliza el método que prefieras para generar las claves pública y privada necesarias para configurar el SFTP y el cifrado de archivos. te informo

Usando 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, escribe user@localhost: ssh-keygen -t rsa.
Nota: Si el comando falla, consulta con tu departamento de TI para asegurarte de que tienes los permisos suficientes para ejecutarlo.
Cuando te lo pidan, deja en blanco el campo de la frase de contraseña.
Guarda tus llaves en un lugar seguro.

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

Cómo usar un generador de claves

Descarga e instala un generador de claves.
Usa el generador para crear un par de claves RSA (pública y privada).
Copia la clave pública, que empieza por ssh-rsa. Esto es lo que vas a enviar a Expedia Group.
Guarda la clave privada en un lugar seguro. No lo borres: lo usarás en lugar de una contraseña cada vez que envíes el archivo cifrado.

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

Paso 3: Comparte tu clave con Expedia

Compartirás de forma segura tu clave pública SFTP con Expedia. Guardaremos esta clave de forma segura y crearemos una cuenta con la que podrás autenticarte en la conexión SFTP. Te daremos un nombre de usuario para que lo uses en el proceso de 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. Si esto te supone un problema, habla con tu gestor de cuentas.

Envíanos el nombre de tu organización y la dirección de correo electrónico desde la que vas a subir la clave SFTP pública a través de SharePoint. Tu responsable de lanzamiento de Expedia te facilitará la dirección de correo electrónico.
Crearemos una carpeta en SharePoint específica para tu organización y te enviaremos un enlace de acceso a la dirección de correo que nos has facilitado. También subiremos nuestra clave pública, que se usa para cifrar el archivo antes de subirlo.
En cuanto recibas ese correo electrónico de acceso, haz clic en el enlace para generar el código de acceso necesario. (Nota: Si no ves el código de acceso en tu bandeja de entrada en un plazo de 2 días laborables, no te olvides de mirar en la carpeta de correo no deseado.)
Subirás la clave pública que has generado a la carpeta que hemos creado y descargarás el archivo « gpg_encryption_public_key.asc » de esa carpeta.
Nos pondremos en contacto contigo cuando la cuenta SFTP esté lista para usar.

Formato y estructura del archivo

Para que la subida de los archivos de datos del CRM se haga correctamente, deben cumplir los siguientes criterios.

Para empezar, el formato del archivo debería ser « .csv ». Cuando cifres el archivo, cambiarás la extensión del archivo a .gpg.
Usa barras verticales (|), en lugar de comas, para separar los campos.
La convención de nomenclatura de archivos no debe incluir caracteres especiales, salvo los guiones bajos (_). El nombre del archivo debe empezar por « eps_crm_marketing », seguido del nombre de tu organización; los dominios « tpid », « eapid » y « site_id » que te haya facilitado tu gestor de cuentas; y la fecha de subida. Por ejemplo: eps_crm_marketing_<PartnerName>_<tpid>_<eapid>_<site_id>_YYYYMMDD.csv.
Los datos del archivo deben contener todas las columnas de la tabla que aparece a continuación, en el orden indicado, y deben incluir valores en todos los campos obligatorios.

Nombre de la 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 suscripción; la decisión del cliente de suscribirse (SÍ) o darse de baja (NO) del marketing por correo electrónico	Sí	Varchar	Sí
`mer_timestamp`	Fecha y hora en las que el cliente decidió darse de alta o darse de baja	2021-06-12 20:14:23.000000	Varchar	Sí
`lang_id`	El idioma del sitio; este valor no es « case-sensitive » >> Ver la tabla de detalles de la configuración regional	en_US en_FR	Varchar	Sí
`tpid`	ID del 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 del sitio de la plantilla facilitado por el gestor de cuentas de Expedia	5678	Número	Sí
`points_balance`	El saldo de puntos de fidelidad del cliente	100000	Número (13 dígitos como máximo)	—
`points_cash_value`	El valor en efectivo de los puntos de fidelidad del cliente	250	Varchar (máximo 10 caracteres)	—
`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 que se ha usado para la transacción	Tarjeta «YourBrand »	Texto (máximo 25 caracteres)	—
`loyalty_tier`	El nivel de fidelidad del cliente dentro de tu programa	Platinum	Texto (máximo 25 caracteres)	—
`attribute1` `attribute2` `attribute3`	3 campos que sirven para compartir información adicional sobre el cliente	Viajero habitual	Varchar (máximo 25 caracteres)	—

Ejemplo del contenido de un archivo CSV

El archivo .csv incluirá cada dato, separados por el carácter de barra vertical (|). Las barras sirven para separar las columnas, y cada campo es el encabezado de la columna para la información que hay debajo.

Conexión SFTP y subida de archivos

Antes de subir tus datos, deberías cifrar el archivo.

Cifrado

Usamos el cifrado PGP para proteger la información de carácter personal (PII). Usarás nuestra clave pública (que te daremos) para cifrar tu archivo « .csv ». Puedes usar las herramientas de cifrado que prefieras, pero nosotros solemos trabajar con las herramientas de cifrado de GPG.

Pídele a tu gestor de lanzamiento de Expedia la dirección de correo electrónico que debes usar como destino de importación para la clave pública de Expedia
No lo cifres con una contraseña; para eso usarás tu clave privada
Guarda el archivo cifrado con la extensión « .gpg »

Subir un archivo

El siguiente paso es subir tu archivo cifrado; puedes usar cualquier herramienta de conexión 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 suben tus archivos SFTP en función de las necesidades de tu empresa.