> 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/fr/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Synchroniser les données via des protocoles de fichiers Cette section explique les protocoles pris en charge par Epsilon Retail Media et fournit des directives pour nommer les fichiers afin de simplifier les téléchargements automatiques depuis votre serveur. Pour des téléchargements sécurisés, envoyez à votre Epsilon Retail Media représentant les détails nécessaires (type de protocole, hôte, port, chemin d'accès au fichier) et toutes les informations d'authentification requises, telles qu'un nom d'utilisateur et un mot de passe. Vous devez stocker vos fichiers de données sur le serveur pour permettre leur récupération via des protocoles standard, tels que Google Cloud Storage (GCS), HTTPS et SFTP. ## Protocoles pris en charge Voici les protocoles pris en charge qui offrent des méthodes sécurisées de stockage et de transfert de fichiers, garantissant une communication sûre avec les Epsilon Retail Media systèmes. ### GCS (recommandé) GCS est notre mécanisme préféré pour le stockage et la récupération de fichiers en raison de ses fonctionnalités de sécurité renforcées et de son intégration fluide avec Epsilon Retail Media systèmes. ### HTTPS Le protocole HTTPS fournit une méthode sécurisée pour le transfert de fichiers en prenant en charge l'authentification par mot de passe. Cela garantit une communication chiffrée entre votre serveur et Epsilon Retail Media. {% hint style="warning" %} Les fichiers volumineux sont mieux synchronisés via GCS Les flux de plus de 100 000 produits sont mieux synchronisés par la méthodologie des buckets afin d'améliorer les performances. {% endhint %} ### SFTP Lors de l'utilisation du protocole de transfert de fichiers sécurisé (SFTP), Epsilon Retail Media prend en charge deux méthodes d'authentification pour le téléchargement de fichiers de données : * **Nom d'utilisateur et mot de passe** : cette méthode standard utilise des identifiants pour authentifier l'accès. * **Authentification par clé publique** : vous pouvez également utiliser Epsilon Retail Mediala clé publique de . Pour cela, assurez-vous que la clé publique fournie ci-dessous est installée sur votre serveur SFTP afin de faciliter les transferts de fichiers sécurisés. #### 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== ``` #### Production ``` 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== ``` ## Compression et chiffrement des données Avant de télécharger des données sur votre serveur pour la synchronisation, vous devrez peut-être compresser et chiffrer les fichiers. Lorsque la compression et le chiffrement sont tous deux utilisés sur les fichiers de données, Epsilon Retail Media suppose que la compression a lieu avant le chiffrement. * Pour la compression des données, nous prenons en charge les formats zip et gzip. Cependant, nous recommandons gzip plutôt que zip en raison de ses meilleurs ratios de compression et de sa prise en charge étendue. Les fichiers compressés sont décompressés avant d'être traités. * Pour le chiffrement des données, les fichiers sont déchiffrés lors du téléchargement. Utilisez les clés publiques fournies pour chiffrer les fichiers avant de les charger sur votre serveur, afin de garantir que seul Epsilon Retail Media puisse accéder aux données en toute sécurité. ## Convention de nommage des fichiers Pour permettre à Epsilon Retail Media de télécharger et de traiter votre fichier de données, vous devez fournir le protocole, l'hôte, le port et le chemin d'accès au fichier. Choisissez une heure quotidienne pratique pour vous assurer que votre fichier de données est prêt sur le serveur, car Epsilon Retail Media le téléchargera chaque jour. L'approche la plus simple pour spécifier un fichier cible quotidien pour Epsilon Retail Mediales téléchargements de est d'utiliser un nom de fichier explicite. Cela permet à Epsilon Retail Media de récupérer directement le fichier depuis votre serveur. Pour ceux qui utilisent les protocoles FTP, FTPS ou SFTP, nous proposons également des méthodes supplémentaires pour spécifier les fichiers cibles via ce que nous appelons des modes de fichier cible. Ces options comprennent : * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. La sélection d'un mode de fichier cible vous oblige à fournir un modèle textuel pour les noms de fichiers de données. Ce modèle inclut une chaîne spéciale, `{\*}`, qui aide Epsilon Retail Media à faire correspondre les noms de fichiers sur votre serveur et à sélectionner le bon fichier chaque jour. Par exemple, considérez le modèle `ERMCatalogData_AU_{\*}.txt`. Ce modèle exige que les noms de fichiers commencent par `ERMCatalogData_AU` et se terminent par `.txt`. En utilisant ce modèle, les noms de fichiers suivants correspondraient : `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Pour éviter de télécharger des fichiers de données en cours de chargement, Epsilon Retail Media télécharge uniquement les fichiers qui ont été modifiés pour la dernière fois plus d'une minute avant l'accès au serveur. Même si plusieurs fichiers peuvent correspondre au modèle, Epsilon Retail Media ne traite qu'un seul fichier à la fois. La sélection du fichier approprié parmi plusieurs candidats est guidée par le mode de fichier cible choisi, qui est détaillé ci-dessous. ### Rolling\_earliest Dans ce mode de fichier cible, les fichiers sont filtrés en fonction du modèle de nom fourni. Une fois filtrés, les fichiers sont triés par ordre croissant de leurs noms, et le premier fichier dans cet ordre est sélectionné pour le téléchargement. Par exemple, si le modèle de nom de fichier est `ERMCatalogData_AU_{\*}.txt` et que la liste filtrée des noms de fichiers inclut les éléments suivants : `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` Dans ce mode, le fichier `ERMCatalogProduct_AU_20190312.txt` est choisi pour le téléchargement. ### Rolling\_earliest\_24\_hours Dans ce mode de fichier cible, les fichiers sont d'abord filtrés en fonction du modèle de nom spécifié. À partir de la liste filtrée, seuls les fichiers modifiés au cours des dernières 24 heures sont pris en compte. Les fichiers sont ensuite triés par ordre croissant selon leur nom, et le premier fichier dans cet ordre est sélectionné pour le téléchargement. Par exemple, supposons que l'heure actuelle soit `2019-03-15 10:30:07`, et que le modèle de nom de fichier soit `ERMCatalogData_AU_{\*}.txt`. Si la liste filtrée des noms de fichiers comprend les éléments suivants : | Nom de fichier | Dernière modification | | ----------------------------------- | --------------------- | | 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 | Dans ce mode, le fichier `ERMCatalogProduct_AU_20190314.txt` est choisi pour le téléchargement. ### Rolling\_latest Dans ce mode de fichier cible, les fichiers sont filtrés en fonction du modèle de nom spécifié. Après le filtrage, les fichiers sont triés par ordre décroissant selon leurs noms. Le premier fichier de cette liste triée est sélectionné pour le téléchargement. Par exemple, si le modèle de nom de fichier est `ERMCatalogData_AU_{\*}.txt`, et que la liste filtrée des noms de fichiers inclut les éléments suivants : `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` Dans ce mode, le fichier `ERMCatalogProduct_AU_20190314.txt` est choisi pour le téléchargement. Ce mode est similaire à Rolling\_earliest, mais au lieu de trier les fichiers par ordre croissant, ils sont triés par ordre décroissant. ### Rolling\_latest\_24\_hours Dans ce mode de fichier cible, les fichiers sont initialement filtrés à l'aide du modèle de nom spécifié. À partir de la liste filtrée, seuls les fichiers modifiés au cours des dernières 24 heures sont pris en compte. Les fichiers sont ensuite triés par ordre décroissant selon leurs noms, et le premier fichier de cette liste triée est sélectionné pour le téléchargement. Par exemple, supposons que l'heure actuelle soit `2019-03-15 10:30:07`, et que le modèle de nom de fichier soit `ERMCatalogData_AU_{\*}.txt`. Si la liste filtrée des noms de fichiers comprend : | Nom de fichier | Dernière modification | | ----------------------------------- | --------------------- | | 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 | Dans ce mode, le fichier `ERMCatalogProduct_AU_20190315.txt` est choisi pour le téléchargement. Ce mode est similaire à Rolling\_earliest\_24\_hours, mais ici les fichiers sont triés par ordre décroissant plutôt que croissant. --- # 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/fr/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.