Comment synchroniser des fichiers de dépenses et d'impressions partenaires sans connecteur natif ?

Comment synchroniser des fichiers de dépenses et d'impressions partenaires sans connecteur natif ?

Objectif

Cette fiche décrit le mode de synchronisation à mettre en place lorsqu’un partenaire publicitaire ne dispose pas d’API exploitable, ou lorsqu’aucun connecteur natif n’est encore disponible dans la bibliothèque EPC (Eulerian Partner Connect).
Dans ce cas, Eulerian peut intégrer les données via des fichiers plats déposés sur un SFTP Eulerian, mis à disposition sur la propriété Eulerian du client.

Contexte

Les connecteurs natifs Eulerian correspondent à des synchronisations automatisées entre Eulerian et les plateformes publicitaires via API.
Lorsque ce mode d’intégration n’est pas possible, une alternative consiste à mettre en place un flux fichier déposé par le partenaire sur un espace SFTP dédié.
Eulerian récupère alors ces fichiers selon une fréquence définie et les exploite pour alimenter les données de dépenses et/ou impressions / clics partenaires.

Principe de fonctionnement

    Eulerian met à disposition un accès SFTP dédié au dépôt des fichiers.
    Le partenaire / client dépose un fichier au format attendu dans le répertoire convenu.
    Il est obligatoire de déposer un fichier par levier ciblé (exemple : un fichier pour le display, un second pour le social)
    Il est possible d'intégrer des campagnes de différents "supports" dans un même fichier (exemple : netflix, prime, disney+ dans un fichier Display)
    La synchronisation est réalisée sur les dimensions levier, support et campagnes. Les dimensions placement, creative et creativetype seront forcées sur un nom générique. Si vous souhaitez profiter de ces dimensions additionnelles, merci de le préciser dans votre demande adressée à l'équipe Customer Success d'Eulerian.
    Eulerian configure la synchronisation et récupère automatiquement le fichier selon la fréquence définie.
    Les données du fichier sont intégrées dans la propriété Eulerian du client.

Spécifications attendues

1. Mise à disposition côté Eulerian

  • Création d’un accès SFTP dédié au dépôt de fichiers ( ⁠⁠Comment accéder à mon FTP Eulerian ?⁠  )
  • Dépôt réalisé par le partenaire ou par son prestataire technique

2. Format du fichier

  • Type de fichier : CSV
  • Nom du fichier : NOMDULEVIER_NOMDUPARTENAIRE_%Y-%m-%d.csv
  • Séparateur de colonnes : ;
  • Présence d’une ligne d’en-tête : oui / non
  • Format des décimaux : point
  • Fuseau horaire de référence : [À compléter]
  • Encodage recommandé : UTF-8
  • Devise du budget : [À compléter]

3. Fréquence de synchronisation

La synchronisation peut être configurée selon l’un des rythmes suivants :
  • quotidien (recommandé)
  • hebdomadaire
  • mensuel
La fréquence doit être définie au moment du cadrage.

4. Template attendu

Le fichier doit respecter strictement l’ordre de colonnes suivant :
DATE;PUBLISHER;CAMPAGNE;CLIC_PARTENAIRE;IMP_PARTENAIRE;BUDGET

5. Description des colonnes

Colonne
Description
Format attendu
DATE
Date de reporting de la ligne
YYYY-MM-DD
PUBLISHER
Nom du support / publisher
Texte
CAMPAGNE
Nom ou identifiant de la campagne
Texte
CLIC_PARTENAIRE
Nombre de clics remontés par le partenaire
Numérique entier
IMP_PARTENAIRE
Nombre d’impressions remontées par le partenaire
Numérique entier
BUDGET
Dépense associée à la ligne
Numérique

Exemple de fichier

DATE;PUBLISHER;CAMPAGNE;CLIC_PARTENAIRE;IMP_PARTENAIRE;BUDGET
2026-02-01;NOM_PARTENAIRE;NOM_CAMPAGNE;0;0;23.31
2026-02-01;NOM_PARTENAIRE;NOM_CAMPAGNE;0;0;27.38

Règles de gestion recommandées

Pour garantir une intégration fiable, les éléments suivants doivent être définis en amont avec le partenaire :

Dépôt des fichiers

  • heure limite de dépôt du fichier : 10h00
  • fuseau horaire de référence pour le dépôt : [À compléter]
  • répertoire SFTP cible : "/incoming"
  • convention en cas de retard de dépôt : il est possible de rattraper les données manquantes en redéposant le fichier manquant. Une resynchronisation manuelle pourra être effectuée côté Eulerian.

Gestion de la fréquence

  • fréquence retenue : [À compléter]
  • jour de dépôt si hebdomadaire : [À compléter]
  • jour de dépôt si mensuel : [À compléter]
  • profondeur d’historique attendue au démarrage : [À compléter]

Points de vigilance

  • Le nom du fichier doit respecter exactement la convention attendue.
  • Le séparateur doit être ;.
  • L’ordre des colonnes doit être strictement respecté.
  • Le fichier doit être déposé selon la récurrence définie.
  • Toute divergence de format peut empêcher la prise en compte automatique du fichier.
  • Les règles de correction et de remplacement doivent être clarifiées avant la mise en production.

Checklist de mise en place

  • Accès SFTP créé côté Client Eulerian ( ⁠⁠Comment accéder à mon FTP Eulerian ?⁠  )
  • Répertoire de dépôt communiqué
  • Fréquence de synchronisation validée
  • Heure limite de dépôt validée
  • Template CSV validé avec le partenaire
  • Encodage et format décimal confirmés
  • Devise du budget confirmée
  • Règles de correction / redépôt définies
  • Historique initial éventuel cadré
  • Contacts techniques identifiés