Protocoles de synchronisation des données par fichier

Cette section explique les protocoles pris en charge par Epsilon Retail Media et fournit des directives pour nommer les fichiers afin de faciliter les téléchargements automatiques depuis votre serveur. Pour des téléchargements sécurisés, veuillez envoyer à votre représentant Epsilon Retail Media les informations nécessaires (type de protocole, hôte, port, chemin d'accès au fichier), ainsi que les informations d'authentification nécessaires, 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 pour le stockage et le transfert de fichiers, garantissant une communication sécurisée avec les systèmes d'Epsilon Retail Media.

GCS (recommandé)

GCS est notre mécanisme privilégié 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 optimale avec les systèmes d'Epsilon Retail Media.

HTTPS

Le protocole HTTPS offre une méthode sécurisée pour le transfert de fichiers en prenant en charge l'authentification par mot de passe. La communication est ainsi chiffrée entre votre serveur et Epsilon Retail Media.

🚧

Les fichiers plus volumineux sont mieux synchronisés via GCS.

Les flux de plus de 100 000 produits sont mieux synchronisés par la méthodologie du regroupement pour améliorer les performances.

SFTP

Lorsque vous utilisez le Secure File Transfer Protocol (SFTP), Epsilon Retail Media prend en charge deux méthodes d'authentification pour télécharger des 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 la clé publique d'Epsilon Retail Media. Pour ce faire, veuillez vous assurer que la clé publique indiquée 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 les synchroniser, vous devrez peut-être compresser et chiffrer les fichiers. Lorsque les fichiers de données sont à la fois compressés et chiffrés, Epsilon Retail Media suppose que la compression est antérieure au chiffrement.

  • Pour la compression des données, nous prenons en charge les formats zip et gzip. Cependant, nous vous recommandons d'utiliser ce dernier en raison de ses meilleurs taux de compression et de son support étendu. 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 télécharger sur votre serveur, afin que seul Epsilon Retail Media puisse accéder aux données en toute sécurité.

Convention d'affectation des noms de fichiers

Pour permettre à Epsilon Retail Media de télécharger et traiter votre fichier de données, vous devez indiquer le protocole, l'hôte, le port et le chemin d'accès au fichier. Choisissez un horaire qui vous convient pour vous assurer que votre fichier de données est prêt sur le serveur, car Epsilon Retail Media le téléchargera quotidiennement.

Le plus simple pour spécifier un fichier cible quotidien pour les téléchargements d'Epsilon Retail Media est d'utiliser un nom de fichier explicite. Epsilon Retail Media pourra ainsi récupérer directement le fichier depuis votre serveur.

Pour ceux qui utilisent les protocoles FTP, FTPS ou SFTP, nous proposons également d'autres méthodes pour spécifier les fichiers cibles en fonction de ce que nous appelons les « modes de fichiers cibles ». Voici la procédure :

  • Rolling_earliest
  • Rolling_earliest_24_hours
  • Rolling_latest
  • Rolling_latest_24_hours.

Pour sélectionner un mode de fichier cible, vous devez fournir un modèle textuel pour les noms des 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 fichier correct 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 afficheraient des correspondances :

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 d'importation, Epsilon Retail Media télécharge uniquement les fichiers dont la dernière modification remonte à plus d'une minute avant l'accès au serveur.

Bien que plusieurs fichiers puissent correspondre au modèle, Epsilon Retail Media ne traite qu'un seul fichier à la fois. La sélection du fichier adapté parmi plusieurs candidats dépend du mode de fichier cible choisi, comme expliqué ci-dessous.

Rolling_earliest

Dans ce mode de fichier cible, les fichiers sont filtrés en fonction du modèle de nom fourni. Les fichiers sont ensuite triés par ordre alphabétique et le premier fichier est sélectionné pour le téléchargement.

Par exemple, si le modèle de nom de fichier est ERMCatalogData_AU_{\*}.txt et la liste filtrée des noms de fichiers comprend 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 sélectionné pour le téléchargement.

Rolling_earliest_24_hours

Dans ce mode de fichier cible, les fichiers sont d'abord filtrés selon le modèle de nom précisé. Dans la liste filtrée, seuls les fichiers modifiés au cours des dernières 24 heures sont pris en compte. Ils sont ensuite triés par ordre alphabétique et le premier fichier de cette liste est sélectionné pour le téléchargement.

Par exemple, supposons que l'heure actuelle est 2019-03-15 10:30:07, et le modèle de nom de fichier est ERMCatalogData_AU_{\*}.txt. Si la liste filtrée des noms de fichiers inclut les éléments suivants :

Nom du fichierDernière modification
ERMCatalogProduct_AU_20190312.txt13/03/19 15:35:11
ERMCatalogProduct_AU_20190313.txt13/03/19 15:35:08
ERMCatalogProduct_AU_20190314.txt14/03/19 15:35:10
ERMCatalogProduct_AU_20190315.txt15/03/19 10:05:07

Dans ce mode, le fichier ERMCatalogProduct_AU_20190314.txt est sélectionné 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 précisé. Les fichiers sont ensuite triés par ordre alphabétique décroissant. Le premier fichier de cette liste est sélectionné pour le téléchargement.

Par exemple, si le modèle de nom de fichier est ERMCatalogData_AU_{\*}.txt, et la liste filtrée des noms de fichiers comprend 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 sélectionné pour le téléchargement.

Ce mode est similaire à Rolling_earliest, mais au lieu de trier les fichiers par ordre alphabétique, ils sont triés dans le sens inverse.

Rolling_latest_24_hours

Dans ce mode de fichier cible, les fichiers sont initialement filtrés à l'aide du modèle de nom précisé. À 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 alphabétique décroissant et le premier fichier est sélectionné pour le téléchargement.

Par exemple, supposons que l'heure actuelle soit 2019-03-15 10:30:07, et le modèle de nom de fichier est ERMCatalogData_AU_{\*}.txt. Si la liste filtrée des noms de fichiers inclut :

Nom du fichierDernière modification
ERMCatalogProduct_AU_20190312.txt13/03/19 15:35:11
ERMCatalogProduct_AU_20190313.txt13/03/19 15:35:08
ERMCatalogProduct_AU_20190314.txt14/03/19 15:35:10
ERMCatalogProduct_AU_20190315.txt15/03/19 10:05:07

Dans ce mode, le fichier ERMCatalogProduct_AU_20190315.txt est sélectionné pour le téléchargement.

Ce mode est similaire à Rolling_earliest_24_hours, mais ici les fichiers sont triés par ordre alphabétique décroissant.