Integrationen

WebinarGeek verbinden

Verbinde WebinarGeek mit deinem Konto-API-Key und einem signierten Webhook und bilde Anmeldungen, Live- und Replay-Zuschauer, No-Shows und Webinar-Zahlungen direkt auf deine Conversions ab.

Wenn du WebinarGeek verbindest, werden Webinar-Aktivitäten wie Anmeldungen, Live- und Replay-Zuschauer, No-Shows und Webinar-Zahlungen zu LeadJourney-Conversions, zugeordnet der Kampagne, dem Ad Set und der Anzeige, die den Platz gefüllt haben. WebinarGeek bietet kein OAuth, deshalb läuft die Verbindung über deinen Konto-API-Key plus einen kontoweiten Webhook, den du in WebinarGeek anlegst. Danach mappst du jedes WebinarGeek-Event auf einen deiner Conversion-Typen. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so jeden Ad-Postback, den du bereits eingerichtet hast.

Bevor du startest

Halte das bereit, damit die Verbindung von Anfang bis Ende funktioniert:

  • Einen aktiven LeadJourney-Workspace und Admin-Zugriff auf dein WebinarGeek-Konto (nur Konto-Admins sehen den API-Key).
  • Tracking ist live, damit Anmeldungen einem Klick zugeordnet werden können. Siehe Tracking-Script installieren.
  • Mindestens einen Conversion-Typ zum Mappen (z. B. WebinarRegistration). Richte diese zuerst im Events Manager ein.

Wo du es findest

Öffne Settings → Apps oder gehe zu app.leadjourney.io/settings?slug=apps. Klick auf die WebinarGeek-Karte, um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your WebinarGeek account“-Karte; nach dem Verbinden zeigt derselbe Screen die Webhook-URL, das Signing Secret, die Verbindungsdetails und deine Trigger.

Schritt für Schritt

Deinen WebinarGeek-API-Key kopieren

Logge dich als Konto-Admin in WebinarGeek ein und öffne Account settingsAdvancedAPI (app.webinargeek.com/admin/integrations/api). Kopiere den dort angezeigten API-Key. Der Guide Where do I find my API key? auf der Verbindungskarte listet dieselben Schritte.

Key einfügen und verbinden

Füge den Key auf der Karte Connect your WebinarGeek account in WebinarGeek API Key ein und klick auf Connect.

LeadJourney prüft den Key gegen dein WebinarGeek-Konto. Der Key wird verschlüsselt gespeichert und nur genutzt, um Webinar- und Anmeldedaten für den Mapping-Screen zu lesen. Klappt es, siehst du eine „WebinarGeek connected“-Bestätigung.

Nur neue Daten werden synchronisiert

LeadJourney synchronisiert neue WebinarGeek-Anmeldungen ab dem Moment der Verbindung. Anmeldungen von vor der Verbindung werden nicht importiert.

Den Webhook in WebinarGeek anlegen

Nach dem Verbinden erzeugt LeadJourney eine Webhook URL und ein Signing secret für deinen Workspace. Beide haben einen Copy-Button. In WebinarGeek:

  1. Gehe zu AccountIntegrationsWebhooks und füge einen Webhook hinzu.
  2. Gib ihm ein Label, z. B. LeadJourney.
  3. Füge die Webhook URL ein.
  4. Füge das Signing secret in das optionale Feld Secret des Webhooks ein. WebinarGeek signiert dann jede Zustellung und LeadJourney prüft sie, sodass niemand sonst an deine URL senden kann.
  5. Hake die WebinarGeek-Trigger an, die zu den Events passen, die du in LeadJourney einrichtest (nächste Schritte).

WebinarGeek-Webhooks gelten kontoweit, dieser eine Webhook deckt also jedes Webinar im Konto ab. Legst du später in LeadJourney einen Trigger für ein weiteres Event an, hake dieses Event auch am Webhook an.

Verbindungsdetails prüfen

Der Header zeigt ein Live-Pill (oder Needs reconnect, falls etwas bricht) sowie Connection, Account, Active triggers und Connected since. Die Buttons Update API key und Disconnect sitzen im selben Header.

Einen Trigger hinzufügen

Klick im Triggers-Panel („Each trigger maps a WebinarGeek event to one of your conversions.“) auf Add trigger. Im Dialog New WebinarGeek trigger:

  1. App: WebinarGeek (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den dieses Event aufzeichnen soll. (Du siehst „No conversion types yet“? Lege zuerst einen unter Settings → Events an.)
  3. Trigger: wähle das WebinarGeek-Event aus dem Raster, zum Beispiel eine Anmeldung, einen Live- oder Replay-Zuschauer, einen No-Show oder eine Zahlung. Mit Search triggers… kannst du die Liste filtern.

Klick auf Continue.

Daten laden, Felder mappen und filtern

Der Dialog öffnet drei Tabs:

  • Receive Data: klick auf Find latest data. LeadJourney lädt deine neuesten WebinarGeek-Anmeldungen in genau der Form, die der Webhook liefert, sodass du eine auswählen und direkt dagegen mappen kannst. Hat das Konto noch keine Anmeldungen, siehst du stattdessen deine Webinare; tippe die Feldnamen dann im nächsten Tab ein (email, firstname, surname, phone).
  • Configure Mapping: befülle jede LeadJourney column aus einem WebinarGeek-Feld. Die Standardzeilen sind Email, Name, Phone, click_id, Revenue und Currency. WebinarGeek hat kein kombiniertes Namensfeld, daher wird Name aus firstname und surname zusammen befüllt. Bei Zahlungsdatensätzen werden Revenue und Currency aus der Zahlung vorbelegt, sofern vorhanden. Wähle pro Zeile ein oder mehrere Felder (mehrere werden mit Leerzeichen verbunden), tippe einen Pfad und drück Enter oder nutze static:value für einen festen Wert. Add custom field fügt First name, Last name oder ein beliebiges Workspace-Feld hinzu oder legt ein neues an.
  • Filtering (optional): klick auf Add filter und setze Path, Operator und Value, damit der Trigger nur bei passenden Datensätzen feuert, zum Beispiel nur für ein bestimmtes Webinar.

Klick im letzten Tab auf Save & Continue. Mindestens ein Feld muss gemappt sein. Save and continue later speichert den Trigger im aktuellen Stand. Neue Trigger starten Active.

Wie WebinarGeek-Anmeldungen der richtigen Kampagne zugeordnet werden

Jedes Event braucht mindestens einen Identifier: eine Click-ID, eine E-Mail oder eine Telefonnummer. Registranten geben immer eine E-Mail an, also mappe Email in jedem Trigger, dann kann LeadJourney die Anmeldung dem Besucher zuordnen, der geklickt hat. WebinarGeek hat kein eigenes Feld für die Click-ID. Erfasst du sie, steht sie entweder in external_id (gesetzt, wenn eine Anmeldung über die WebinarGeek-API angelegt wird; LeadJourney belegt click_id daraus vor, wenn der Wert gesetzt ist) oder in einer eigenen Anmeldefrage, die unter extra_fields erscheint. Zeige die Zeile click_id auf das Feld, das du nutzt.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile, WebinarGeek-Event → Conversion-Typ, mit einem Active- / Paused-Pill und einer Zeile wie „4 field(s) mapped · 1 filter(s)“.

  • Pause / Resume: stoppe einen Trigger über den Schalter, ohne ihn zu löschen.
  • Edit: Event, Mapping, Filter oder Ziel-Conversion ändern.
  • Delete: tippe delete zur Bestätigung. Mapping und Filter dieses Triggers lassen sich nicht wiederherstellen; die anderen Trigger laufen weiter.
  • Weitere hinzufügen: nutze Add trigger erneut, zum Beispiel für getrennte Conversions für Anmeldungen, Live-Zuschauer und No-Shows. Hake jedes neue Event am WebinarGeek-Webhook an.

Erneut verbinden

LeadJourney prüft die Verbindung jedes Mal, wenn du die Integration öffnest. Lehnt WebinarGeek den Key ab („WebinarGeek rejected your API key“, meist weil er rotiert oder widerrufen wurde) oder antwortet die API nicht („WebinarGeek is unreachable“), wechselt der Header auf Needs reconnect und ein Banner nennt den Grund. Klick auf Reconnect (oder Update API key) und füge einen neuen Key ein. Deine Trigger und Einstellungen bleiben erhalten.

Trennen (Disconnect)

Klick im Header auf Disconnect. Tippe im Dialog Disconnect WebinarGeek? disconnect und bestätige mit Disconnect WebinarGeek.

Disconnect löscht deine Trigger

Das Trennen entfernt die Verbindung dauerhaft, löscht jeden Trigger und verwirft den gespeicherten API-Key. WebinarGeek-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt. Den LeadJourney-Webhook kannst du anschließend in WebinarGeek unter Account → Integrations → Webhooks löschen.

Fehlerbehebung

Unter „Receive Data“ erscheinen nur Webinare (oder gar nichts)?

Webinare bedeuten: Der Key funktioniert, aber das Konto hat noch keine Anmeldungen zum Zurücklesen. Tippe die Feldnamen unter Configure Mapping ein oder melde einen Test-Teilnehmer an und klick erneut auf Find latest data. Erscheint gar nichts, prüfe, ob der API-Key in WebinarGeek noch gültig ist.

Es kommen keine Conversions an?

Prüfe, dass (1) der Webhook in WebinarGeek die aktuelle Webhook URL und das aktuelle Signing secret nutzt, (2) der passende Trigger am Webhook angehakt ist, (3) der LeadJourney-Trigger Active ist und (4) eventuelle Filter auf die eingehenden Datensätze zutreffen.

Conversions kommen an, werden aber keiner Kampagne zugeordnet?

Stell sicher, dass das Tracking-Script auf den Seiten installiert ist, die Besucher vor der Anmeldung sehen, und dass Email (und, falls du sie erfasst, click_id) im Trigger gemappt ist.

Häufige Fragen

Verwandte Artikel