OneTrace.pro Centre d’aide

Import de fichiers et sources de données

Si vos clients figurent déjà dans un autre système (CRM, logiciel de gestion, tableur), inutile d'attendre qu'ils reviennent sur le site : importez un fichier. Le chargement ponctuel de profils depuis un CSV ou un fichier Excel se fait avec l'import, et le chargement régulier de profils et d'événements depuis un fichier par URL, S3, Google Sheets ou votre entrepôt de données se fait avec les sources de données.

Les deux outils sont accessibles au « Propriétaire », à l'« Administrateur » et au « Gestionnaire ».

Importer des profils depuis un CSV ou Excel

Ouvrez Données → Import de profils dans le menu, ou cliquez sur Import de profils en haut de la page Profils.

Exigences relatives au fichier

  • Un CSV ou un fichier Excel (.xlsx, .xls — la première feuille) avec les en-têtes de colonnes sur la première ligne.
  • Séparateur : virgule, point-virgule ou tabulation, détecté automatiquement.
  • Taille : CSV jusqu'à 20 Mo, Excel jusqu'à 10 Mo.
  • Au moins une colonne d'identifiant : id du client dans votre système, e-mail, téléphone.
  • Dans Excel, les cellules au format date sont chargées sous la forme 2026-10-28 18:42:00 et les formules avec leur valeur. Les fichiers Excel 95 et les fichiers protégés par mot de passe ne conviennent pas : enregistrez-les en .xlsx ou en CSV.

Exemple :

email;phone;first_name;city;customer_id;bonus
[email protected];+33 6 12 34 56 78;Claire;Lyon;1001;350

Importer le fichier

  1. Cliquez sur Choisir un fichier et sélectionnez le fichier.
  2. Le tableau affiche les colonnes du fichier, des exemples de valeurs et le champ Destination. Pour chaque colonne, indiquez :
    • Identifiant : User ID, E-mail, Téléphone ou ID anonyme : le profil est retrouvé ou créé à partir de cette valeur. Chaque type ne peut être choisi qu'une fois.
    • Attribut : une propriété du profil ; saisissez à côté une clé en caractères latins, par exemple city ou bonus_balance.
    • Ignorer : la colonne n'est pas importée.
  3. Cliquez sur Lancer l'import.

OneTrace.pro propose automatiquement une destination d'après les en-têtes : email et e-mail pour l'e-mail, phone et mobile pour le téléphone, customer_id et user_id pour le User ID ; les en-têtes russes et ukrainiens courants (prénom, nom, ville, pays) deviennent les attributs first_name, last_name, city, country. Les autres en-têtes deviennent des clés d'attributs en minuscules, sans accents (« Prénom » devient prenom). Vérifiez ces suggestions avant de lancer l'import.

Import de profils : association des colonnes du fichier

Déroulement de l'import

L'import s'exécute en arrière-plan : la page affiche une barre de progression, le statut et le compteur « N traitées sur M, erreurs : K ». Vous pouvez fermer la page, l'import continue. Les lignes en erreur sont listées avec leur numéro. Une fois l'import terminé, le bouton Ouvrir les profils mène à la liste des profils.

À droite, le bloc Historique présente les 20 derniers imports : fichier, auteur et date, statut (« Téléversé », « En file d'attente », « En cours de traitement », « Terminé », « Échec ») et résultat.

Page d'import avec l'historique des chargements

Traitement des lignes

  • Si un profil avec cet identifiant existe déjà, il est mis à jour : les nouveaux attributs sont ajoutés, ceux qui existent déjà sont remplacés. Si une ligne contient les identifiants de deux profils différents, ceux-ci sont fusionnés : voir Profils.
  • Les cellules vides sont ignorées et n'effacent pas les valeurs déjà connues.
  • Les nombres et true/false sont enregistrés comme nombres et valeurs booléennes.
  • L'e-mail et le téléphone du fichier deviennent à la fois des identifiants et des attributs du profil.
  • Le téléphone est débarrassé des espaces, parenthèses et tirets. Indiquez-le avec l'indicatif du pays : +7 999 123-45-67. Un numéro comme 8 999… sera enregistré avec un mauvais indicatif.
  • Une ligne sans aucun identifiant valide est ignorée et signalée comme erreur.

L'import crée un événement $identify pour chaque ligne : les modifications d'attributs peuvent donc lancer des parcours déclenchés par un changement d'attribut. Si vous ne le souhaitez pas, mettez ces parcours en pause pendant l'import.

Sources de données

Une source est un import régulier selon une planification. Elle convient lorsque votre CRM ou votre entrepôt publie chaque nuit un export à jour : OneTrace.pro le récupère automatiquement et met à jour les profils ou ajoute des événements.

Préparation

Créez d'abord une connexion dans la section Intégrations (rôle « Administrateur » ou « Propriétaire » requis) :

  • Fichier par URL : un fichier à une adresse HTTP(S). Si le fichier est protégé, indiquez un en-tête d'autorisation, par exemple Bearer et un jeton.
  • Fichier depuis S3 : un bucket AWS, Yandex Object Storage, MinIO ou d'un autre stockage compatible.
  • Feuille Google : via la clé d'un compte de service Google. Donnez à ce compte un accès en lecture à la feuille.
  • PostgreSQL, ClickHouse, BigQuery ou Snowflake : une table ou une requête dans votre entrepôt de données, voir Entrepôt de données.

Formats de fichiers : CSV, JSON (tableau d'objets, jusqu'à 50 Mo) et JSON Lines.

Créer une source

  1. Ouvrez Données → Sources de données et cliquez sur Nouvelle source.
  2. Saisissez un Nom et choisissez une Connexion.
  3. Renseignez les paramètres de la connexion : URL du fichier et Format, Chemin du fichier dans le bucket, ou ID de la feuille de calcul et Plage (par exemple Feuille1!A:F).
  4. Cliquez sur Charger les colonnes : OneTrace.pro lit les premières lignes.
  5. Dans le champ Importer comme, choisissez Profils (chaque ligne met à jour les attributs) ou Événements (chaque ligne est un événement).
  6. Choisissez la Planification : de toutes les 15 minutes à une fois par jour.
  7. Dans le tableau Colonnes, indiquez la destination de chaque colonne, comme pour l'import CSV.
  8. Cliquez sur Enregistrer.

Paramètres d'une source de données avec l'association des colonnes

Pour les événements, le tableau des colonnes propose en plus Nom de l'événement, Propriété de l'événement et Heure de l'événement. La colonne d'heure est obligatoire. Indiquez un nom d'événement commun à toutes les lignes dans le champ Nom de l'événement (par exemple order_completed) ou choisissez la colonne qui le contient.

Pour les tickets de caisse des magasins, le modèle Tickets en magasin propose un fichier d'exemple : il renseigne l'événement d'achat, la propriété d'achat en magasin et les suggestions de colonnes (téléphone, carte de fidélité, magasin, numéro du ticket, montant et produits). Voir Magasins et ventes en magasin.

Fonctionnement d'une source

La fiche de la source affiche le statut (« Actif », « En pause », « Échec »), la planification, l'heure de la dernière exécution et le résultat : lignes, acceptées, ignorées, en échec.

  • Lancer maintenant : exécution hors planification. Ce bouton sort aussi la source de la pause ou de l'état d'échec.
  • Mettre en pause / Reprendre : arrêter et reprendre les exécutions planifiées.
  • Historique : liste des exécutions avec l'heure de début, le déclencheur (« Planifié » ou « Manuel »), le statut et les premières erreurs de lignes avec leur numéro.

Sources de données : fiches avec statut et résultat des exécutions

À savoir

  • Si le fichier n'a pas changé depuis la dernière fois, l'exécution se termine avec le statut « Inchangé » et les lignes ne sont pas lues.
  • Une même ligne répétée dans les 24 heures ne crée pas de doublon.
  • Pour les événements, l'heure du dernier événement chargé est mémorisée : les exécutions suivantes ignorent les lignes qui ne sont pas plus récentes. Un fichier d'historique peut donc simplement être complété.
  • Une source en échec est retentée selon la planification ; le texte de l'erreur est affiché sur la fiche.
  • Les événements chargés sont décomptés du quota mensuel du forfait.
  • La suppression d'une source conserve les données déjà chargées.

Entrepôt de données

Si vos profils et vos commandes sont déjà réunis dans votre entrepôt (PostgreSQL, ClickHouse, BigQuery ou Snowflake), la source les lit directement à cet endroit. Chaque exécution ne récupère que les lignes modifiées depuis la dernière fois : même une grande table n'a donc pas besoin d'être exportée dans un fichier. Les modifications arrivent dans les profils et les événements, qui déclenchent les parcours et le recalcul des segments. Pour le sens inverse, voir Export vers les entrepôts de données.

La lecture depuis les entrepôts de données est disponible avec le forfait « Entreprise », voir Forfaits.

Connexion

Créez une connexion dans la section Intégrations, dans le groupe Sources de données. Les champs sont les mêmes que pour l'export vers cet entrepôt, mais il vaut mieux créer un utilisateur distinct en lecture seule :

  • PostgreSQL : l'hôte, le port, la base de données et un utilisateur avec le droit SELECT sur les tables nécessaires.
  • ClickHouse : l'adresse de l'interface HTTP et un utilisateur avec un droit de lecture.
  • BigQuery : la clé d'un compte de service avec les rôles BigQuery Data Viewer et BigQuery Job User, le projet et l'emplacement des données.
  • Snowflake : le compte, un utilisateur avec une paire de clés, un rôle avec le droit SELECT et le warehouse de calcul. Aucun bucket S3 n'est nécessaire pour la lecture.

L'entrepôt doit être accessible depuis internet : OneTrace.pro ne se connecte pas aux adresses de réseaux internes.

Paramètres de la source

Créez une source comme décrit plus haut et choisissez la connexion à l'entrepôt. Ses paramètres :

  • Données à lire : Table (par exemple public.customers ou shop_dwh.customers) ou Requête personnalisée, c'est-à-dire une seule commande SELECT ou WITH, sans ;. OneTrace.pro ajoute à la requête une condition, un ordre et une limite de lignes : elle ne permet donc pas de modifier les données.
  • Colonne de curseur : l'heure de modification de la ligne, par exemple updated_at. Chaque exécution lit les lignes dont cette heure est postérieure à celle de la fois précédente. Les lignes sans cette heure ne sont pas lues.
  • Clé de ligne : une colonne unique, par exemple id ou customer_id. Elle distingue les lignes qui ont la même heure de modification.
  • Colonne d’indicateur de suppression : facultative, par exemple is_deleted. Voir Suppression.

Source depuis un entrepôt BigQuery : table, curseur, clé de ligne et colonnes

La suite est identique à celle d'un fichier : Charger les colonnes, destination des colonnes, profils ou événements, planification.

Lecture des modifications

  • La première exécution lit toute la table, les suivantes uniquement les lignes modifiées après la dernière lue.
  • Une exécution lit au plus 1 million de lignes. S'il y en a davantage, l'exécution suivante démarre aussitôt, sans attendre la planification. Le premier chargement d'une grande table se fait ainsi en plusieurs exécutions successives.
  • Si une exécution est interrompue, les mêmes lignes sont relues : les profils sont simplement mis à jour une nouvelle fois, et les événements répétés ne sont pas dupliqués.
  • Changer la table, la requête, la colonne de curseur ou la clé relance la lecture depuis le début.
  • C'est votre entrepôt qui doit mettre à jour la colonne d'heure de modification : OneTrace.pro ne relit pas une ligne dont l'heure n'a pas avancé.
  • La requête s'exécute en lecture seule et avec une limite de temps : 10 minutes dans PostgreSQL, ClickHouse et Snowflake, 15 minutes dans BigQuery.

Suppression

Si, dans une ligne d'une source de profils, la Colonne d’indicateur de suppression vaut true ou 1, OneTrace.pro supprime le profil qui a les identifiants de cette ligne, comme pour une demande RGPD : avec son historique, les profils fusionnés et les données dans les exports. La suppression est consignée dans le journal d'audit, et le résultat de l'exécution indique combien de profils ont été supprimés. Dans une source d'événements, les lignes marquées sont simplement ignorées.

Pour une migration ponctuelle depuis Mindbox ou d'autres plateformes avec l'historique, un outil dédié existe : voir Migration depuis d'autres plateformes.