Verstehen von Webhooks, APIs und JavaScript-Rückrufen
Integration von Drimify: Ein Leitfaden zu APIs, Webhooks und JavaScript Callbacks
Wenn Sie mit Drimify interaktive Erlebnisse gestalten, müssen Daten oft in Ihren bestehenden Technologie-Stack fließen – zum Beispiel, um automatisch einen neuen Lead zu Ihrem CRM hinzuzufügen oder ein benutzerdefiniertes Ereignis auf Ihrer Website auszulösen, sobald ein Nutzer ein Spiel beendet.
Um dies zu erreichen, bietet Drimify drei Integrationsmethoden: APIs, Webhooks und JavaScript Callbacks. So wählen Sie die richtige Methode für die Bedürfnisse Ihres Unternehmens aus.
1. API: Der "On-Demand" Datenabruf
Eine API (Application Programming Interface) ermöglicht es Ihrem System, jederzeit spezifische Informationen von Drimify abzurufen.
- Wie es funktioniert: Ihr Server sendet eine Anfrage an Drimify, um spezifische Daten zu erhalten (z.B. "Gib mir alle Einträge der letzten 24 Stunden"). Drimify sendet dann die angeforderten Daten zurück.
- Ideal für: Report-Erstellung, Synchronisierung großer Datenmengen in Ihr Dashboard oder zur Überprüfung der Teilnehmerzahlen am Ende einer Kampagne.
- Wichtiger Punkt: Ihr System startet die Kommunikation.
2. Webhook: Die "Echtzeit" Übermittlung
Ein Webhook ist eine Benachrichtigung, die automatisch von Drimify zu Ihrem Server gesendet wird, sobald ein bestimmtes Ereignis eintritt.
- Wie es funktioniert: Sie definieren einen "Trigger" (z.B. wenn ein Nutzer ein Registrierungsformular absendet oder ein Erlebnis abschließt). Sobald dieses Ereignis eintritt, schiebt Drimify die Kontaktdaten oder Informationen des Nutzers direkt zu Ihrer CRM- oder Datenbank-URL.
- Ideal für: Automatisierung in Echtzeit, wie das sofortige Versenden einer "Willkommen"-E-Mail oder das Aktualisieren des Profils eines Leads in Ihrem CRM.
- Wichtiger Punkt: Drimify beginnt die Kommunikation automatisch, basierend auf einem vordefinierten Ereignis.
3. JavaScript Callback: Die "In-Browser" Reaktion
Ein JavaScript Callback verwaltet die Kommunikation zwischen dem Drimify-Widget und der Webseite oder App, in die es eingebettet ist. Im Gegensatz zu APIs oder Webhooks passiert dies lokal im Browser des Nutzers.
- Wie es funktioniert: Ihre Website "lauscht" auf Aktionen, die innerhalb des Drimify iframes stattfinden. Wenn ein Nutzer einen bestimmten Meilenstein erreicht, sendet das Spiel ein Signal an Ihre übergeordnete Seite (z.B.
onComplete). - Ideal für: Sofortige visuelle Änderungen auf Ihrer Seite, wie das Ausblenden des Spiels, um einen versteckten Download-Link anzuzeigen oder den Nutzer auf eine spezielle landingpage weiterzuleiten.
- Wichtiger Punkt: Es verbindet das Erlebnis in Echtzeit mit dem Frontend Ihrer Website.
Vergleich & Anwendungsfälle
Feature | API | Webhook | JavaScript Callback |
Richtung | Ihr System → Drimify | Drimify → Ihr System | Drimify → Ihre Website/App |
Umgebung | Server-zu-Server | Server-zu-Server | Browser/Client-seitig |
Übliche Nutzung | Synchronisierung großer Datenmengen | CRM & E-Mail-Automatisierung | Dynamische UI-Änderungen |
Beispiel | Wöchentlicher Bericht abrufen | Neuen Lead an HubSpot senden | "Preis einlösen" Button anzeigen |
Verstehen Sie den Unterschied zwischen "Backend" und "Frontend"
Um die richtige Methode zu wählen, fragen Sie sich: "Wohin müssen die Daten gehen?"
- Zu Ihrer Datenbank oder Ihrem CRM (Backend): Verwenden Sie Webhooks. So senden Sie die E-Mail-Adresse oder Kontaktdaten eines Leads sicher von Drimify zu Ihren internen Systemen (wie HubSpot, Salesforce oder einer benutzerdefinierten Datenbank). Dies funktioniert perfekt, egal ob Ihre Kampagne auf einer Website oder in einer App läuft.
- Zum Bildschirm des Nutzers (Frontend): Verwenden Sie JavaScript Callbacks. Dies ist nützlich, wenn Sie möchten, dass die Website selbst sofort auf die Aktion eines Spielers reagiert – zum Beispiel, indem ein "Rabatt einlösen" Button auf Ihrer Webseite angezeigt wird, sobald sie das Spiel abschließen.### Integrationsvergleich
Funktion | Webhooks (empfohlen für Daten) | JavaScript Callbacks (ideal für UX) |
Verbindung | Server-zu-Server | Browser-zu-Browser |
Hauptziel | Sichere Übertragung von Lead-Daten und Kontaktinformationen. | Ein nahtloses "Live"-Erlebnis auf Ihrer Seite schaffen. |
Praxisbeispiel | Automatisches Hinzufügen eines Teilnehmers zu Ihrer Mailingliste. | Ausblenden des Spiels und Einblenden eines Promo-Codes auf Ihrer Seite. |
Sicherheit | Hoch (findet im Hintergrund statt). | Direkt (findet auf dem Gerät des Nutzers statt). |
Zusammenfassung der Anwendungsfälle
Egal, ob Sie Drimify auf einer Website oder in einer mobilen App einbetten, häufig wird eine Kombination aus beidem verwendet:
- Ein Webhook, um sicherzustellen, dass Ihr Marketingteam die Kontaktdaten des Leads in Ihrem CRM erhält.
- Ein JavaScript Callback, um sicherzustellen, dass der Benutzer sofort eine "Danke"-Nachricht oder einen Belohnungslink sieht, ohne die Seite zu aktualisieren.
Hinweis zu Callbacks: Da JavaScript Callbacks im Browser des Nutzers ausgeführt werden, sind sie hervorragend für die Benutzererfahrung (UX), sollten jedoch nicht für hochsichere Datenvalidierung verwendet werden. Für sichere, serverseitige Datenübertragungen (wie sensible Lead-Informationen) geben Sie immer den Webhooks den Vorzug.
Aktualisiert am: 20/03/2026
Danke!