En esta sección se explican los protocolos compatibles con Epsilon Retail Media y se ofrecen directrices para asignar nombres a los archivos con el fin de agilizar las descargas automáticas desde el servidor. Para poder descargar de forma segura, envíe a su representante de Epsilon Retail Media los detalles necesarios —tipo de protocolo, host, puerto, ruta del archivo— y cualquier credencial de autenticación necesaria, como un nombre de usuario y una contraseña. Debe almacenar sus archivos de datos en el servidor para permitir la recuperación mediante protocolos estándar, como Google Cloud Storage (GCS), HTTPS y SFTP.
Protocolos compatibles
Estos son los protocolos compatibles que ofrecen métodos seguros para el almacenamiento y la transferencia de archivos, lo cual garantiza una comunicación segura con los sistemas de Epsilon Retail Media.
GCS (recomendado)
GCS es nuestro mecanismo preferido para el almacenamiento y la recuperación de archivos gracias a sus sólidas funciones de seguridad y a su perfecta integración con los sistemas de Epsilon Retail Media.
HTTPS
El protocolo HTTPS proporciona un método seguro para la transferencia de archivos al admitir la autenticación basada en contraseña. Esto garantiza una comunicación cifrada entre su servidor y Epsilon Retail Media.
Los archivos más grandes se sincronizan mejor mediante GCS
Los feeds de más de 100 000 productos se sincronizan mejor mediante la metodología de cubos para mejorar el rendimiento.
SFTP
Al utilizarse el protocolo de transferencia segura de archivos (SFTP), Epsilon Retail Media admite dos métodos de autenticación para descargar archivos de datos:
- Nombre de usuario y contraseña: Este método estándar utiliza credenciales para autenticar el acceso.
- Autenticación de clave pública: También puede utilizar la clave pública de Epsilon Retail Media. Para ello, asegúrese de que la clave pública indicada a continuación esté instalada en su servidor SFTP para facilitar la transferencia segura de archivos.
Fases
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ==
Producción
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCtpIUFoYu8OUesZGP9rffv6/hky1HbQCAhC8hNRmcWpdptzRYsKIZFPz9t2vb85dierTZqJstAEJkePHd25cZ8btIBacbAR49avCIXiBuVgvlJk1+Er2dyYqSzSeFhpzlZxi4CkGo/Nsx7yxPi5693fdVF3vr+/iencw1tdLJJXfT6j1YLBCREg+IziBCO6m9P0QQGEDXYvsOmIzl0CJ8enU7gjvnYL5ify1/aGpoXv9/XcCYJWXTQmvmISknOMdC4pBiuDqsE9CX27FLQQb1ZT5jNrqD5hFsEo0rWqLiCbb5qoxIdMSe/IbA+sewgpgTPNJXeCNLSSH/MHhj2IgiMZGDDDaVaqMZD7N2jeQdI6SQbgvXiLTTUL4gNyO5eN9oqoeJumeZMi0+MQ7kkfHDYGtKe3RMxL7heL650HL+eWDIybezyPdQmfyVew9KuN0uB+2X+2NxQs8ZLqow486XDfUDfo+rPuoIvkYy7Z8ox+gne+1iAk43TCekcDwxlc56R9muMtGLuzzg1x9s9MqsAg5JNWEPQ8giAwCQJwm7h3UcCY3TJCn0LUzYHc7Ycr11JfIXL47vYGH3C0XBYlbEU/8m4VhhexzgJi8G/reclY5pfjtwQGOiobsxLsWgGx6Qoz/qWqmGwQIg+qi7jvA7jnltUP+RTFZpmd18/dSxB+w==
Compresión y cifrado de datos
Antes de subir datos a su servidor para sincronizarlos, es posible que deba comprimir y cifrar los archivos. Cuando se utilizan tanto la compresión como el cifrado en los archivos de datos, Epsilon Retail Media asume que la compresión se realiza antes del cifrado.
- Para la compresión de datos, admitimos los formatos zip y gzip. Sin embargo, recomendamos gzip en lugar de zip por sus mejores ratios de compresión y su amplia compatibilidad. Los archivos comprimidos se descomprimen antes de procesarse.
- Para el cifrado de datos, los archivos se descifran al ser descargados. Utilice las claves públicas proporcionadas para cifrar los archivos antes de subirlos a su servidor, lo que garantiza que solo Epsilon Retail Media pueda acceder a los datos de forma segura.
Convención de nomenclatura de archivos
Para permitir que Epsilon Retail Media descargue y procese su archivo de datos, deberá proporcionar los detalles del protocolo, el host, el puerto y la ruta del archivo. Elija una hora del día que le resulte conveniente para garantizar que su archivo de datos esté listo en el servidor, ya que Epsilon Retail Media lo descargará cada día.
El método más sencillo para especificar un archivo de destino diario para las descargas de Epsilon Retail Media es utilizar un nombre de archivo explícito. Esto permite a Epsilon Retail Media recuperar directamente el archivo desde su servidor.
Para aquellos que utilizan protocolos FTP, FTPS o SFTP, también ofrecemos métodos adicionales para especificar archivos de destino mediante lo que llamamos modos de archivo de destino. Estas opciones incluyen:
- Rolling_earliest
- Rolling_earliest_24_hours
- Rolling_latest
- Rolling_latest_24_hours.
Seleccionar un modo de archivo de destino requiere que usted proporcione una plantilla basada en texto para los nombres de los archivos de datos. Esta plantilla incluye una cadena especial, {\*}
, que ayuda a Epsilon Retail Media a cotejar los nombres de archivo de su servidor y a seleccionar el archivo correcto cada día.
Por ejemplo, considere la plantilla ERMCatalogData_AU_{\*}.txt
. Esta plantilla requiere que los nombres de archivo empiecen por ERMCatalogData_AU
y terminen por .txt
. Utilizando esta plantilla, los siguientes nombres de archivo coincidirán:
ERMCatalogProduct_AU_20190315.txt
ERMCatalogProduct_AU_20190314.txt
ERMCatalogProduct_AU_20190312.txt
Para evitar la descarga de archivos de datos que aún estén en proceso de carga, Epsilon Retail Media solo descarga los archivos modificados por última vez más de un minuto antes de acceder al servidor.
Aunque es posible que varios archivos coincidan con la plantilla, Epsilon Retail Media solo procesará un archivo cada vez. La selección del archivo adecuado entre varios candidatos se rige por el modo de archivo de destino elegido, el cual se detalla a continuación.
Rolling_earliest
En este modo de archivo de destino, los archivos se filtran según la plantilla de nombre proporcionada. Una vez filtrados, los archivos se clasifican en orden ascendente por sus nombres y se selecciona el primer archivo de este orden para su descarga.
Por ejemplo, si la plantilla para nombres de archivo es ERMCatalogData_AU_{\*}.txt
y la lista filtrada de nombres de archivo incluye lo siguiente:
ERMCatalogProduct_AU_20190312.txt
ERMCatalogProduct_AU_20190313.txt
ERMCatalogProduct_AU_20190314.txt
En este modo, se elegirá el archivo ERMCatalogProduct_AU_20190312.txt
para su descarga.
Rolling_earliest_24_hours
En este modo de archivo de destino, los archivos se filtran inicialmente según la plantilla de nombre especificada. De la lista filtrada, solo se consideran los archivos modificados en las últimas 24 horas. A continuación, los archivos se clasifican en orden ascendente por sus nombres, y se selecciona el primer archivo de este orden para su descarga.
Por ejemplo, supongamos que la hora actual es 2019-03-15 10:30:07
, y la plantilla del nombre del archivo es ERMCatalogData_AU_{\*}.txt
. Si la lista filtrada de nombres de archivo incluye lo siguiente:
Nombre de archivo | Última modificación |
---|---|
ERMCatalogProduct_AU_20190312.txt | 13/03/19 15:35:11 |
ERMCatalogProduct_AU_20190313.txt | 13/03/19 15:35:08 |
ERMCatalogProduct_AU_20190314.txt | 14/03/19 15:35:10 |
ERMCatalogProduct_AU_20190315.txt | 15/03/19 10:05:07 |
En este modo, se elegirá el archivo ERMCatalogProduct_AU_20190314.txt
para su descarga.
Rolling_latest
En este modo de archivo de destino, los archivos se filtran según la plantilla de nombre especificada. Una vez filtrados, los archivos se clasifican en orden descendente por sus nombres. El primer archivo de esta lista ordenada se selecciona para su descarga.
Por ejemplo, si la plantilla para nombres de archivo es ERMCatalogData_AU_{\*}.txt
y la lista filtrada de nombres de archivos incluye lo siguiente:
ERMCatalogProduct_AU_20190314.txt
ERMCatalogProduct_AU_20190313.txt
ERMCatalogProduct_AU_20190312.txt
En este modo, se elegirá el archivo ERMCatalogProduct_AU_20190314.txt
para su descarga.
Este modo es similar a Rolling_earliest, pero aquí los archivos se ordenan en orden descendente en lugar de ascendente.
Rolling_latest_24_hours
En este modo de archivo de destino, los archivos se filtran inicialmente utilizando la plantilla de nombre especificada. De la lista filtrada, solo se consideran los archivos modificados en las últimas 24 horas. A continuación, los archivos se clasifican en orden descendente por sus nombres, y se selecciona el primer archivo en este orden para su descarga.
Por ejemplo, suponga que la hora actual es 2019-03-15 10:30:07
, y la plantilla del nombre del archivo es ERMCatalogData_AU_{\*}.txt
. Si la lista filtrada de nombres de archivos incluye:
Nombre de archivo | Última modificación |
---|---|
ERMCatalogProduct_AU_20190312.txt | 13/03/19 15:35:11 |
ERMCatalogProduct_AU_20190313.txt | 13/03/19 15:35:08 |
ERMCatalogProduct_AU_20190314.txt | 14/03/19 15:35:10 |
ERMCatalogProduct_AU_20190315.txt | 15/03/19 10:05:07 |
En este modo, se elegirá el archivo ERMCatalogProduct_AU_20190315.txt
para su descarga.
Este modo es similar a Rolling_earliest_24_hours, pero aquí los archivos se ordenan en orden descendente en lugar de ascendente.