> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/es/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Sincronizar datos mediante protocolos de archivo Esta sección explica los protocolos admitidos por Epsilon Retail Media y proporciona pautas para nombrar archivos para agilizar las descargas automáticas desde su servidor. Para descargas seguras, envíe a su Epsilon Retail Media representante los detalles necesarios (tipo de protocolo, host, puerto, ruta del archivo) y cualquier credencial de autenticación requerida, como un nombre de usuario y contraseña. Debe almacenar sus archivos de datos en el servidor para permitir la recuperación a través de protocolos estándar, como Google Cloud Storage (GCS), HTTPS y SFTP. ## Protocolos admitidos Estos son los protocolos admitidos que ofrecen métodos seguros para el almacenamiento y la transferencia de archivos, lo que 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 debido a sus robustas funciones de seguridad y su perfecta integración con 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 la comunicación cifrada entre su servidor y Epsilon Retail Media. {% hint style="warning" %} Los archivos más grandes se sincronizan mejor a través de GCS Los feeds de más de 100.000 productos se sincronizan mejor mediante la metodología de buckets para mejorar el rendimiento. {% endhint %} ### SFTP Al utilizar 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 con 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 proporcionada a continuación esté instalada en su servidor SFTP para facilitar la transferencia segura de archivos. #### Staging ``` 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 cargar datos a su servidor para la sincronización, 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 ocurre antes del cifrado. * Para la compresión de datos, admitimos los formatos zip y gzip. Sin embargo, recomendamos gzip sobre zip debido a sus mejores ratios de compresión y su amplio soporte. Los archivos comprimidos se descomprimen antes de su procesamiento. * Para el cifrado de datos, los archivos se descifran al descargarse. Utilice las claves públicas proporcionadas para cifrar los archivos antes de cargarlos a su servidor, asegurándose de 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, debe proporcionar los detalles del protocolo, host, puerto y ruta del archivo. Elija una hora diaria conveniente para asegurarse de que su archivo de datos esté listo en el servidor, ya que Epsilon Retail Media lo descargará cada día. El enfoque más directo para especificar un archivo objetivo diario para las descargas de Epsilon Retail Mediaes utilizar un nombre de archivo explícito. Esto permite a Epsilon Retail Media recuperar directamente el archivo de su servidor. Para quienes utilizan los protocolos FTP, FTPS o SFTP, también ofrecemos métodos adicionales para especificar archivos objetivo a través de lo que llamamos modos de archivo objetivo. Estas opciones incluyen: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. Al seleccionar un modo de archivo objetivo, debe proporcionar 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 coincidir con los nombres de archivos en su servidor y seleccionar el archivo correcto cada día. Por ejemplo, considere la plantilla `ERMCatalogData_AU_{\*}.txt`. Esta plantilla requiere que los nombres de archivo comiencen con `ERMCatalogData_AU` y terminen con `.txt`. Con esta plantilla, coincidirían los siguientes nombres de archivos: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Para evitar la descarga de archivos de datos que aún se están cargando, Epsilon Retail Media solo descarga archivos que se modificaron por última vez más de un minuto antes de acceder al servidor. Aunque varios archivos pueden coincidir con la plantilla, Epsilon Retail Media procesa solo un archivo a la vez. La selección del archivo adecuado entre varios candidatos se guía por el modo de archivo objetivo elegido, que se analiza en detalle a continuación. ### Rolling\_earliest En este modo de archivo objetivo, los archivos se filtran según la plantilla de nombre proporcionada. Una vez filtrados, los archivos se ordenan en orden ascendente por sus nombres, y se selecciona el primer archivo de este orden para su descarga. Por ejemplo, si la plantilla del nombre de archivo es `ERMCatalogData_AU_{\*}.txt` y la lista filtrada de nombres de archivos incluye lo siguiente: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` En este modo, el archivo `ERMCatalogProduct_AU_20190312.txt` se elige para la descarga. ### Rolling\_earliest\_24\_hours En este modo de archivo objetivo, 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. Luego, los archivos se ordenan en orden ascendente por nombre, 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 de nombre de archivo es `ERMCatalogData_AU_{\*}.txt`. Si la lista filtrada de nombres de archivos 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, el archivo `ERMCatalogProduct_AU_20190314.txt` se elige para la descarga. ### Rolling\_latest En este modo de archivo objetivo, los archivos se filtran según la plantilla de nombre especificada. Después de filtrar, los archivos se ordenan en orden descendente por sus nombres. El primer archivo de esta lista ordenada se selecciona para su descarga. Por ejemplo, si la plantilla del nombre de archivo es `ERMCatalogData_AU_{\*}.txt`, y la lista filtrada de nombres de archivo incluye lo siguiente: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` En este modo, el archivo `ERMCatalogProduct_AU_20190314.txt` se elige para la descarga. Este modo es similar a Rolling\_earliest, pero en lugar de ordenar los archivos en orden ascendente, se ordenan en orden descendente. ### Rolling\_latest\_24\_hours En este modo de archivo objetivo, 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. Luego, los archivos se ordenan en orden descendente por sus nombres, y se selecciona el primer archivo de este orden para su descarga. Por ejemplo, suponga que la hora actual es `2019-03-15 10:30:07`, y la plantilla de nombre de archivo es `ERMCatalogData_AU_{\*}.txt`. Si la lista filtrada de nombres de archivo 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, el archivo `ERMCatalogProduct_AU_20190315.txt` se elige para la descarga. Este modo es similar a Rolling\_earliest\_24\_hours, pero aquí los archivos se ordenan en orden descendente en lugar de ascendente. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/es/data-api/data-overview-1/syncing-data-via-file-protocols-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.