Integrationen

Typeform verbinden

Verbinde dein Typeform-Konto in wenigen Minuten. Einmal autorisieren, LeadJourney registriert einen Webhook auf jedem Formular, dann gibst du jedem Formular einen lj_click_id-URL-Parameter, damit Einsendungen der Anzeige zugeordnet werden, die sie ausgelöst hat.

Wenn du Typeform verbindest, werden Formular-Einsendungen zu LeadJourney-Conversions, zugeordnet der Kampagne, dem Ad Set und der Anzeige, die den Teilnehmer gebracht haben. Du autorisierst Typeform einmal; LeadJourney registriert dann auf jedem Formular deines Kontos einen Webhook, sodass Einsendungen sofort fließen und auch bei neuen Formularen weiterfließen. Für die Attribution braucht jedes Formular noch eine Sache: einen lj_click_id-URL-Parameter, der die Click-ID in die Einsendung trägt. Gemappte Einsendungen 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 ein Typeform-Konto, in das du dich einloggen kannst.
  • Tracking ist live: Klicks müssen zuerst erfasst werden, damit Einsendungen einer Kampagne zugeordnet werden können. Siehe Tracking-Script einbinden.
  • Besucher erreichen deine Formulare über LeadJourney-getrackte Links, damit der Parameter lj_click_id vorhanden ist. Siehe Wie Attribution funktioniert.
  • Mindestens einen Conversion-Typ zum Mappen (z. B. Lead). 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 Typeform-Karte (unter Forms), um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your Typeform account“-Karte; nach dem Verbinden zeigt derselbe Screen dein Konto, ein Forms-Panel und deine Triggers.

Schritt für Schritt

LeadJourney aus Typeform autorisieren

Klick auf der Connect your Typeform account-Karte auf Connect Typeform. Du wirst zu Typeform weitergeleitet, um dich einzuloggen und LeadJourney zu autorisieren. Keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen. Nach der Bestätigung schickt Typeform dich zurück und du siehst eine „Typeform connected“-Bestätigung.

Verbindung und Formulare prüfen

Der Header zeigt ein Live-Pill (oder Needs reconnect), dein Account, Forms tracked (Formulare mit funktionierendem Webhook von allen Formularen, plus wann zuletzt synchronisiert wurde) und Active triggers.

Darunter listet das Forms-Panel jedes Formular mit zwei Status-Pills:

  • Webhook on / Not registered: ob Einsendungen dieses Formulars LeadJourney erreichen.
  • Attributable / No click id: ob das Formular einen lj_click_id-Parameter trägt.

Neue Formulare werden stündlich automatisch übernommen. Um sie sofort zu übernehmen, klick auf Re-sync forms.

Jedes Formular attribuierbar machen

Typeform ignoriert jeden URL-Parameter, den ein Formular nicht deklariert hat. Ein Formular ohne lj_click_id kann also nie eine Click-ID tragen. Du hast zwei Wege, ihn hinzuzufügen:

  • LeadJourney fügt ihn hinzu: setze bei einem Formular mit No click id den Haken bei Auto-add click id. LeadJourney legt das versteckte Feld lj_click_id für dich an, ohne Änderungen im Builder. Klappt es, bestätigt dir eine Meldung, dass das Formular jetzt die Click-ID trägt, und das Pill wechselt auf Attributable. Noch wartende Formulare stehen unter Setting up attribution on … forms; klick auf Re-sync forms, um sie sofort zu verarbeiten.
  • Selbst hinzufügen: füge im Typeform-Builder lj_click_id unter den URL parameters (Hidden Fields) des Formulars hinzu und klick dann auf Re-sync forms.

Sobald ein Formular den Parameter trägt, zeigt seine Zeile click id via lj_click_id.

Einen Trigger hinzufügen

Klick im Triggers-Panel, in dem jeder Trigger Typeform-Einsendungen auf eine deiner Conversions abbildet (für alle Formulare oder nur eines), auf Add trigger. Im Dialog New Typeform trigger:

  1. App: Typeform (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den Einsendungen aufzeichnen sollen, z. B. Lead. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
  3. Form: lass All forms stehen, um bei jeder Einsendung des Kontos zu feuern, oder beschränke den Trigger auf ein Formular.
  4. Trigger: wähle den Einsendungs-Trigger.

Klick auf Continue.

Daten empfangen und das Mapping bestätigen

Der Dialog öffnet einen Flow mit drei Tabs:

  • Receive Data: klick auf Find latest data, um Einsendungen zu laden. Erscheint nichts, sende das Formular selbst ab und prüfe erneut, dann klick auf Continue with selected record. Hat das gewählte Formular (oder haben einige deiner Formulare) kein lj_click_id, nennt eine Warnung sie. Speichern kannst du trotzdem; diese Einsendungen werden nur keinem Klick zugeordnet.
  • Configure Mapping: ordne die Einsendung Email, Name, Phone, click_id, Revenue und Currency zu, per Add custom field für alles Weitere. Antworten werden über die Field Ref angesprochen (z. B. fields.work_email), nicht über ihre Position, und hidden.lj_click_id ist die Quelle, aus der du click_id mappst. Klick auf Save & Continue.
  • Filtering (optional): füge Bedingungen hinzu; jede wird gegen den gewählten Datensatz getestet und zeigt PASS oder FAIL, mit einer Zusammenfassung wie „Your trigger would have fired“. Mit Add Another Filter fügst du weitere hinzu.

Klick auf Activate, um abzuschließen.

Wie Einsendungen mit der richtigen Kampagne verknüpft werden

Eine Typeform-Einsendung kennt den Klick nur, wenn die Click-ID das Formular über seine URL erreicht, z. B. ?lj_click_id=…. Typeform speichert sie im URL-Parameter lj_click_id, und dein Trigger mappt hidden.lj_click_id auf click_id. So kommt jede Einsendung bereits mit dem Klick (und damit der Kampagne, dem Ad Set und der Anzeige) verknüpft an, der sie verdient hat. Ist dein Typeform auf einer Landingpage eingebettet, stell sicher, dass das Embed den lj_click_id der Seite an das Formular weiterreicht (der Typeform-Embed-Code kann URL-Parameter der Host-Seite weitergeben, z. B. data-tf-transitive-search-params="lj_click_id"). Zum Prüfen klappst du einen Datensatz unter Receive Data auf und schaust, ob hidden.lj_click_id einen Wert hat.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile (Typeform-Event → Conversion-Typ) mit einem Active- / Paused-Pill, dem Formular, auf das er beschränkt ist (oder All forms), und wie viele Felder und Filter er nutzt.

  • Pause / Resume: stoppe einen Trigger über den Schalter vorübergehend, ohne ihn zu löschen.
  • Edit: Formular, Mapping, Filter oder Ziel-Conversion ändern.
  • Delete: einen einzelnen Trigger entfernen (zur Bestätigung delete tippen); deine Formulare behalten ihren Webhook.
  • Weitere hinzufügen: z. B. ein Trigger pro Formular, jeweils auf eine andere Conversion gemappt.

Erneut verbinden

Widerruft Typeform den Zugriff von LeadJourney, ist der Webhook auf keinem Formular registriert oder ist Typeform nicht erreichbar, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund:

  • „Typeform disconnected your app“: der Zugriff wurde widerrufen oder ist abgelaufen. Klick auf Reconnect.
  • „No form is wired up“: deine Tokens funktionieren, aber kein Formular hat den Webhook. Klick auf Re-sync forms.
  • „Typeform is unreachable“: meist ein vorübergehender Ausfall. Versuch es in einer Minute erneut.

Re-authorize im Header führt die Autorisierung jederzeit erneut aus. Deine Trigger und Einstellungen bleiben erhalten.

Trennen (Disconnect)

Um Typeform zu entfernen, klick im Header auf Disconnect, tippe disconnect und bestätige mit Disconnect Typeform. Das ist bewusst so, weil es destruktiv ist:

Disconnect löscht deine Trigger

Das Trennen entfernt das Typeform-Konto dauerhaft aus diesem Workspace, entfernt den LeadJourney-Webhook von deinen Formularen und löscht jeden Trigger. Einsendungen fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt.

Fehlerbehebung

Ein Formular bleibt nach dem Sync auf „No click id“?

LeadJourney konnte dieses Formular nicht bearbeiten. Klick auf Reconnect (oder Re-authorize), um Bearbeitungsrechte für Formulare zu erteilen, und dann auf Re-sync forms. Alternativ fügst du lj_click_id selbst unter den URL parameters des Formulars im Typeform-Builder hinzu.

Formulare „failed to register“?

LeadJourney konnte seinen Webhook nicht an die aufgelisteten Formulare hängen, deren Einsendungen kommen also nicht an. Der Grund steht neben jedem Formular. Klick auf Re-sync forms, um es erneut zu versuchen.

Keine Einsendungen bei „Find latest data“?

Das Formular hat noch keine Einsendung erhalten. Sende es selbst ab und klick dann erneut auf Find latest data.

Einsendungen kommen an, werden aber keiner Kampagne zugeordnet?

Prüfe, dass (1) das Tracking-Script installiert ist und Klicks erfasst, (2) das Formular Attributable zeigt, (3) das Formular mit lj_click_id in seiner URL geöffnet wird (bei Embeds: der Parameter wird weitergereicht) und (4) der Trigger click_id aus hidden.lj_click_id mappt und Active ist. Als Fallback mappst du Email oder Phone, damit die Einsendung trotzdem gematcht werden kann.

Häufige Fragen

Verwandte Artikel