Données d’événements avec Eventfrog : intégration, import et connexions API
Que vous souhaitiez afficher un calendrier d’événements sur votre 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 votre objectif, de votre environnement technique et du niveau d’automatisation souhaité.
Dans cet article vous trouverez :
- 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 vos 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 vos propres données d’organisateur.
- Adapté à l’importation de vos propres événements dans des systèmes internes
- Typique pour des intégrations CRM CMS reporting ou BI
- Focus sur une synchronisation stable de vos données d’événements
L’ensemble de la spécification API est disponible ici : Eventfrog API Reference
Vue d’ensemble pour vous aider à choisir
|
Option |
Qu’est-ce que c’est ? |
Cas d’utilisation typique |
Compétences techniques |
Données dans votre 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 vos 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 votre site web
- vous ne disposez 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 votre 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 votre 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 vous pouvez récupérer des données d’événements par exemple pour :
- créer vos propres listes d’événements sur votre 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 vos 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 votre 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 votre 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 :
- vous souhaitez alimenter votre propre base de données d’événements ou votre 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 vos propres événements ventes ou données de participants
- Synchronisation régulière avec votre propre système y compris une logique delta pour les modifications
