Eventdaten mit Eventfrog: Einbettung, Import und API-Anbindungsmöglichkeiten
Mit dem iFrame zeigst du Events ohne Programmieren auf deiner Website. Mit der Public API holst du öffentliche Eventdaten in dein eigenes System. Mit der Organizer API liest du die Daten deiner eigenen Events aus oder erfasst Events direkt aus deinem System.
Übersicht:
Welche Lösung passt zu mir?
- Events auf deiner Website zeigen, ohne zu programmieren: iFrame
- Öffentliche Events von Eventfrog in deine Website, App oder Eventplattform übernehmen, auch Events anderer Veranstalter:innen: Public API
- Ticketverkäufe, Check-ins und Auszahlungen deiner Events in ein CRM, BI- oder Buchhaltungstool übertragen: Organizer API mit Leserecht
- Events in deinem eigenen System erfassen und automatisch auf Eventfrog anlegen: Organizer API mit Lese- und Schreibrecht
Du kannst die Lösungen kombinieren, zum Beispiel Events per Organizer API erfassen und per iFrame auf deiner Website zeigen. Das iFrame richtest du selbst im Cockpit ein. Für die beiden APIs brauchst du Programmierkenntnisse oder jemanden, der die Anbindung für dich umsetzt.
iFrame: Eventkalender auf deiner Website
Im Cockpit findest du in der Hauptnavigation den Punkt Eigener Kalender. Dort erstellst du einen Code, den du in den HTML-Code deiner Website einfügst. Auf deiner Website erscheint dann ein Eventkalender.
- Standardmässig zeigt der Kalender deine publizierten Events. Du kannst weitere hinzufügen, zum Beispiel Events anderer Veranstalter:innen, bestimmter Rubriken oder Locations, und einen Zeitraum festlegen.
- Die Akzent-Farbe passt du an deine Website an.
- Auf Wunsch bindest du zusätzlich ein Formular ein, mit dem Besucher:innen deiner Website eigene Events erfassen. Dafür brauchen sie ein eigenes Eventfrog-Konto.
Gib unter Deine Domain die Adresse deiner Website an, sonst funktioniert die Einbettung nicht. Einen API-Key brauchst du nicht.
So bettest du den Eventkalender ein
Public API: öffentliche Eventdaten abrufen
Die Public API liefert alle öffentlichen Events auf Eventfrog, dazu Eventgruppen, Rubriken und Locations. Du filterst zum Beispiel nach Veranstalter:in, Location, Rubrik, Land, Umkreis oder Zeitraum. Events erfassen oder ändern kannst du damit nicht.
Typische Einsätze:
- eigene Eventlisten mit eigener Gestaltung und eigenen Filtern
- Apps, Bildschirme oder Newsletter mit aktuellen Events
- regionale oder thematische Eventplattformen
Du brauchst einen API-Key vom Typ Public API: Read. Alle Details findest du in der Spezifikation der Public API.
Organizer API: Daten deiner Events lesen und Events erfassen
Die Organizer API gilt für die Events, die du erstellt hast, im Cockpit oder über einen API-Key deines Kontos. Je nach API-Key darfst du nur lesen oder auch schreiben.
Nur lesen
Mit einem API-Key vom Typ Organizer API: Read liest du die Daten deiner Events aus:
- Events, Eventgruppen und Ticketkategorien
- Ticketverkäufe mit den Angaben der Käufer:innen und den Antworten auf Personalisierungsfelder
- Check-ins, Sitzplätze und Eingänge
- Auszahlungen
So überträgst du zum Beispiel Kundendaten in ein CRM, Verkaufs- und Check-in-Zahlen in ein BI-Tool, Auszahlungen in die Buchhaltung oder Essensbestellungen aus Personalisierungsfeldern in ein Restaurantsystem.
Lesen und schreiben
Mit einem API-Key vom Typ Organizer API: Read/Write/Delete erstellst, änderst, kopierst und löschst du zusätzlich Events und Eventgruppen. So erfasst du Events nur einmal in deinem eigenen System, zum Beispiel im CMS deiner Location oder in deiner Tourplanung. Ändern sich Termine, überträgst du die Änderung automatisch.
So kommt ein Event aus deinem System auf Eventfrog:
- Dein System legt das Event über die API an. Es ist ein Entwurf und noch nicht öffentlich sichtbar.
- Verkaufst du Tickets, richtest du im Cockpit die Ticketkategorien und den Ticketverkauf ein. Über die API geht das nicht.
- Publiziere das Event im Cockpit mit Publizieren.
Alle Details findest du in der Spezifikation der Organizer API.
So erhältst du einen API-Key
Deine API-Keys verwaltest du unter Einstellungen › API-Keys. Klicke auf API-Key erstellen und wähle den Typ, den deine Lösung braucht. Bei Organizer-Keys bestätigst du das Erstellen zusätzlich.
Gib einen API-Key nur an Personen weiter, die deine Anbindung umsetzen. Mit einem Key vom Typ Organizer API: Read/Write/Delete lassen sich deine Events ändern und löschen. Brauchst du einen Key nicht mehr, zum Beispiel nach einem Wechsel der Agentur, deaktivierst du ihn in der Liste mit API-Key deaktivieren. Das lässt sich nicht rückgängig machen.
So erstellst und verwaltest du API-Keys
Häufige Fragen
Kann ich Events über die Organizer API publizieren?
Nein. Mit Schreibrecht erfasst und bearbeitest du Events, publizieren kannst du sie über die API nicht. Neu erstellte Events sind immer ein Entwurf und deshalb noch nicht öffentlich sichtbar. Publiziere sie anschliessend im Cockpit beim jeweiligen Event mit Publizieren.
Sehe ich mit der Organizer API auch Events anderer Veranstalter:innen?
Nein. Die Organizer API zeigt nur Events, die du erstellt hast. Öffentliche Events anderer Veranstalter:innen holst du mit der Public API.