Passer au contenu principal
Vous pouvez importer des événements en masse en téléchargeant un fichier CSV. Vous pouvez créer votre CSV en utilisant des outils comme Google Sheets, Excel, ou tout éditeur de tableur.
L’écriture manuelle du CSV est possible mais non recommandée en raison du risque d’erreurs de formatage.

​
Champs requis

Chaque ligne d’événement doit inclure :
  • timestamp — Quand l’événement s’est produit, au format ISO 8601.
  • event_type — Le nom de l’événement. Cette valeur est flexible et utilisée ensuite lors de la configuration de vos produits.
  • customer_id
  • record/id — Un identifiant unique pour l’événement.
    Téléverser un autre événement avec le même record/id écrasera le précédent.

​
Champs personnalisés

Vous pouvez ajouter autant de champs personnalisés que nécessaire. Tous les champs personnalisés doivent commencer par le préfixe record/.
Par exemple, pour créer un champ nommé count, nommez la colonne record/count.

​
Téléverser votre fichier

Pour commencer, ouvrez l’Events Explorer dans Hyperline.
Cliquez sur Import events from CSV dans le coin supérieur droit pour ouvrir la modale de téléversement. Vous pouvez également télécharger un modèle CSV depuis la même modale.
Le modèle inclut la ligne d’en-tête correcte et un exemple d’événement pour vous aider à démarrer.
Après avoir sélectionné votre fichier, cliquez sur Import CSV file pour démarrer le téléversement.
Si le fichier ne contient aucune erreur, vos événements seront importés et prêts pour l’analyse.

​
Écrire manuellement le fichier CSV

Lors de la préparation de votre fichier CSV, assurez-vous qu’il respecte ces règles :
  • Utilisez des virgules comme séparateurs de champs.
  • Entourez les champs de guillemets doubles s’ils contiennent des virgules ou des sauts de ligne.
  • Incluez toujours une ligne d’en-tête pour décrire chaque colonne.
  • Utilisez le format ISO 8601 pour le champ timestamp.
  • Utilisez un format cohérent pour les champs imbriqués, tels que record/id ou record/amount.
  • Tous les champs standards sont requis. Les champs record/ sont optionnels et autant que nécessaire peuvent être déclarés.

​
Exemple

Voici un exemple de fichier CSV valide.
(record/type et record/is_live ne sont que des exemples — vous pouvez définir vos propres champs.) 
timestamp,event_type,record/id,record/type,record/is_live,customer_id
"2023-11-07T13:59:40.536Z",api_call,1245,"paid",true,"cus_foXtwuyW7NsCH-"
"2023-11-07T13:59:40.536Z",api_call,1152,"to_pay",true,"cus_foXtwuyW7NsCH-"
"2023-11-07T13:59:40.536Z",api_call,8625,"pending",false,"cus_foXtwuyW7NsCH-"
"2023-10-18T15:53:24.772Z",api_call,9752,"closed",true,"cus_foXtwuyW7NsCH-"
"2023-10-18T15:53:24.772Z",api_call,7052,"open",true,"cus_foXtwuyW7NsCH-"
Notes :
  • record/id est numérique et ne nécessite pas de guillemets.
  • Les champs de type chaîne (tels que record/type) doivent être entourés de guillemets.
  • Les champs booléens (tels que record/is_live) ne nécessitent pas de guillemets.