Données d’événements avec Eventfrog : intégration, import et connexions API
Que tu souhaites afficher un calendrier d’événements sur ton propre site web importer des données dans un système existant ou créer des événements directement via une interface Eventfrog propose plusieurs façons d’utiliser les données d’événements. Le choix dépend de ton objectif, de ton environnement technique et du niveau d’automatisation souhaité.
Dans cet article tu trouveras :
- un aperçu complet de toutes les options
- des recommandations claires selon les cas d’utilisation
- des détails sur iFrame, Public API et Organizer API
Aperçu :
Les 3 options en un coup d’œil
1) iFrame
Brève description : Intégration prête à l’emploi d’un calendrier ou d’une liste d’événements sur un site web externe.
- Adapté à la simple présentation d’événements
- Aucune intégration technique dans tes propres systèmes
- Mise en œuvre très simple
2) Public API
Brève description : API publique en lecture pour interroger des événements, des groupes d’événements des catégories et des lieux.
- Adapté aux affichages personnalisés sur site web, application, newsletter ou écrans
- Contrôle total sur l’affichage, le filtrage et le traitement des données
- Lecture seule, aucune création ni modification d’événements
3) Organizer API (read)
Brève description : Interface permettant la lecture structurée de tes propres données d’organisateur.
- Adapté à l’importation de tes propres événements dans des systèmes internes
- Typique pour des intégrations CRM CMS reporting ou BI
- Focus sur une synchronisation stable de tes données d’événements
L’ensemble de la spécification API est disponible ici : Eventfrog API Reference
Vue d’ensemble pour t’aider à choisir
|
Option |
Qu’est-ce que c’est ? |
Cas d’utilisation typique |
Compétences techniques |
Données dans ton propre système ? |
Personnalisation design/UX |
|---|---|---|---|---|---|
|
iFrame |
Intégration prête à l’emploi d’un calendrier ou d’une liste |
Je souhaite afficher et gérer des événements sur mon propre site web |
Faible |
Non |
Moyenne |
|
Public API |
API publique pour lire des événements, des lieux et des catégories |
Je souhaite alimenter une base de données d’événements ou mon propre CMS et rendre les données visibles à l’extérieur Je gère une plateforme d’événements régionale, suprarégionale, géographiquement ou par catégorie, où je présente des événements |
Moyenne |
Oui |
Élevée |
|
Organizer API read |
Interface organisateur en lecture généralement pour tes propres données |
Je souhaite alimenter ma propre base de données d’événements ou mon CMS Je souhaite transmettre des abonnés à la newsletter selon les paramètres de personnalisation vers un outil comme MailChimp Je souhaite alimenter un outil BI comme Power BI avec des données démographiques des acheteurs, des ventes et des check-in Je souhaite transférer des données clients vers un CRM comme HubSpot, Salesforce, Pipedrive ou similaire Je souhaite rapprocher les paiements entrants dans un outil financier ou comptable séparé Je souhaite suivre des commandes de repas selon les paramètres de personnalisation ou les ventes par catégorie pour un événement et les transférer vers un système de restauration |
Moyenne à élevée |
Oui |
Élevée |
Détails des options
Option 1 : Afficher les données d’événements sur mon site web (iFrame)
L’iFrame est idéal si :
- les événements doivent être visibles rapidement sur ton site web
- tu ne disposes pas d’une équipe de développement ou de temps de développement
- il est acceptable que l’affichage soit en grande partie « prédéfini »
Avantages
- mise en ligne rapide
- aucune gestion des données nécessaire dans ton propre système
- maintenance minimale
Configuration typique
- Récupérer le code d’intégration (iFrame) dans le cockpit Eventfrog sous « Calendrier personnel »
- Insérer le code dans ton site web / CMS
- En option : définir des paramètres / filtres (par exemple uniquement certaines catégories organisateurs ou lieux)
Option 2 : Importer les données d’événements dans mes systèmes (Public API)
Avec la Public API tu peux récupérer des données d’événements par exemple pour :
- créer tes propres listes d’événements sur ton site web avec filtres et tri personnalisés
- importer des événements dans un outil interne comme une solution éditoriale ou marketing
- générer des flux pour écrans newsletters ou partenaires
- enrichir les événements avec tes propres données comme des tags campagnes ou logiques UTM
Configuration typique
- Appeler l’API par exemple pour des événements sur une période ou dans une région
- Mapper les données
- Les enregistrer dans ton propre système ou les afficher directement
- Mettre à jour régulièrement
Option 3 : Lire des événements et des données via API (Organizer API – Read)
Qu’est-ce que c’est ?
L’Organizer API (Read) est l’interface de lecture pour les organisateurs afin de transférer leurs propres données d’événements de ventes et d’acheteurs de manière structurée vers des systèmes externes. Elle convient dès que des données doivent être transférées automatiquement vers ton propre système CMS ou outil tiers puis traitées.
Quand l’Organizer API (Read) est-elle le meilleur choix ?
Cette solution est idéale si :
- tu souhaites alimenter ta propre base de données d’événements ou ton CMS
- les événements doivent être automatiquement synchronisés dans un système existant
- des abonnés à la newsletter selon les paramètres de personnalisation doivent être transférés vers des outils comme Mailchimp
- des outils BI comme Power BI doivent être alimentés avec des données de ventes de check-in ou démographiques
- des données clients doivent être transférées vers un CRM comme HubSpot Salesforce ou Pipedrive
- les paiements entrants doivent être rapprochés avec un outil financier ou comptable séparé
- des données supplémentaires comme des commandes de repas issues de champs de personnalisation ou de ventes par catégorie doivent être transférées vers des systèmes de restauration ou de gestion d’événements
En résumé : dès que des données structurées et actuelles doivent être traitées automatiquement.
Configuration typique
- Authentification dans le contexte organisateur
- Récupération de tes propres événements ventes ou données de participants
- Synchronisation régulière avec ton propre système y compris une logique delta pour les modifications
