Integrationen
HubSpot verbinden
Verbinde dein HubSpot-Konto in wenigen Minuten, ohne API-Keys und ohne von Hand verdrahtete Webhooks. Einmal autorisieren, CRM-Events wie neue Kontakte, Formular-Einsendungen und Deal-Stage-Änderungen auf deine Conversions abbilden und LeadJourney-Daten zurück nach HubSpot schicken.
Wenn du HubSpot verbindest, werden CRM-Events – neue Kontakte, neue Deals, Lifecycle- und Deal-Stage-Änderungen – zu LeadJourney-Conversions, automatisch der Kampagne, Ad Set und Anzeige zugeordnet, die sie verdient haben. Du autorisierst HubSpot einmal (keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen) und mappst danach jedes HubSpot-Event auf einen deiner Conversion-Typen. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so automatisch jeden Ad-Postback, den du bereits eingerichtet hast. Über denselben Screen kannst du außerdem LeadJourney-Klicks, Leads und Conversions als Datensätze zurück nach HubSpot senden.
Bevor du startest
Halte das bereit, damit die Verbindung von Anfang bis Ende funktioniert:
- Einen aktiven LeadJourney-Workspace und ein HubSpot-Konto, in das du dich einloggen kannst.
- Tracking ist live – Klicks müssen zuerst erfasst werden, damit CRM-Datensätze einer Kampagne zugeordnet werden können. Siehe Tracking-Script installieren.
- Eine Möglichkeit, die Click-ID auf deinen HubSpot-Datensätzen zu erfassen – typisch ein verstecktes Formularfeld, das LeadJourneys Click-ID auf dem Kontakt speichert (siehe Callout unten).
- Mindestens einen Conversion-Typ zum Mappen (z. B.
WonClient). 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 HubSpot-Karte, um die Integration zu öffnen (oder nutze
?slug=apps&app=hubspot). Solange du nicht verbunden bist, siehst du eine „Connect your
HubSpot account“-Karte; nach dem Verbinden zeigt derselbe Screen dein Konto und Portal, die
Einstellung LeadJourney Properties, deine Trigger und das Panel Send to HubSpot.
Schritt für Schritt
LeadJourney aus HubSpot autorisieren
Klick auf der Connect your HubSpot account-Karte auf Connect with HubSpot. Du wirst zu HubSpot weitergeleitet, um dich einzuloggen und den Zugriff von LeadJourney zu bestätigen und auszuwählen, welches HubSpot-Konto verbunden wird.
Die Freigabe gibt Lesezugriff auf deine Kontakte und Deals, plus die Berechtigung, CRM-Objekt-Events zu abonnieren (damit LeadJourney Erstellungen und Property-Änderungen aufnehmen kann) – keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen. Nach der Bestätigung schickt HubSpot dich zurück und du siehst eine „HubSpot connected“-Bestätigung.
Die Synchronisierung startet beim Verbinden
LeadJourney erfasst neue HubSpot-Events ab dem Moment der Verbindung. Daten von vor der Verbindung werden nicht importiert.
Verbindungsdetails prüfen
Sobald du verbunden bist, zeigt der Header ein Live-Pill (oder Needs reconnect, falls etwas bricht) sowie die Buttons Re-authorize und Disconnect. Darunter siehst du den Status Connection, dein Account mit der Portal-ID, Active triggers (aktive von allen) und das Datum Connected since.
Einen Trigger hinzufügen
Klick im Triggers-Panel – „Each trigger maps a HubSpot event to one of your conversions.“ – auf Add trigger. Im Dialog New HubSpot trigger:
- App: HubSpot (bereits ausgewählt).
- Trigger: wähle das HubSpot-Event aus dem Karten-Raster, z. B. einen neu angelegten Datensatz, eine Property-Änderung oder eine Formular-Einsendung. Jede Karte zeigt eine kurze Beschreibung, Search triggers… grenzt die Liste ein.
- Form (nur bei Formular-Einsendungen): wähle das HubSpot-Formular, das überwacht wird. Ein Formular, das nicht in der Liste steht (z. B. ein Meetings-Buchungsformular), nutzt du, indem du seine Formular-ID in die Suche einfügst und auf Use this form ID klickst.
- Property (nur bei Property-Änderungen): wähle, welche Property überwacht wird, z. B. Lifecycle stage, Lead status oder Deal stage.
- Target value (optional): leer lassen, um bei jeder Änderung zu feuern, oder auf einen Wert festlegen. Bei Deal stage wird daraus ein Dropdown deiner Pipeline-Stufen (mit Any stage change als Standard); Meeting outcome bietet Scheduled, Completed, Rescheduled, No-show und Canceled.
- LeadJourney Event: wähle den Conversion-Typ, den dieses HubSpot-Event aufzeichnen soll,
z. B.
WonClient. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
Klick auf Continue.
Deal-Stufen kommen aus deinen Pipelines
Wenn du die Deal stage-Property überwachst, lädt LeadJourney deine HubSpot-Pipelines und listet jede Stufe als Pipeline · Stufe, sodass du eine Conversion genau dann feuern kannst, wenn ein Deal z. B. Sales Pipeline · Closed won erreicht.
Daten empfangen und das Mapping bestätigen
Der Dialog öffnet einen Flow mit drei Tabs:
- Receive Data: klick auf Find latest data, um aktuelle Datensätze für den gewählten Trigger zu laden (bei einem Formular-Trigger die letzten Einsendungen dieses Formulars). Ist ein Target value gesetzt, erscheinen nur Datensätze, die gerade in diesem Zustand sind. Erscheint nichts, erstelle oder ändere einen Datensatz in HubSpot und prüfe erneut, dann wähle einen Datensatz und klick auf Continue with selected record.
- Configure Mapping: ordne den HubSpot-Datensatz den LeadJourney-Spalten zu. Neue Trigger
starten mit Email, Full name, Phone, click_id, Revenue und Cash
collected, vorbelegt, wo LeadJourney eine passende Property findet. Mehrere Properties
werden mit Leerzeichen verbunden, mit
static:setzt du einen festen Wert. Add custom field holt eine entfernte Spalte zurück oder fügt eines deiner Custom Fields hinzu, Create new field legt ein neues an (Typ Text, Number oder Currency). Bei Deal-Triggern kannst du auch Werte vom zugehörigen Kontakt (contact.…) ziehen. Das Mappen vonclick_idist empfohlen, aber optional (siehe Callout unten). - Filtering (optional): klick auf Add Another Filter und setze Pfad, Operator (equals, not equals, contains, greater than, exists und mehr) und Wert. Jeder Filter wird gegen den gewählten Datensatz getestet und zeigt PASS oder FAIL, mit einer Zusammenfassung wie „Your trigger would have fired“.
Save & Continue bringt dich vom Mapping zu den Filtern. Klick auf Activate, um abzuschließen (beim Bearbeiten Save trigger), oder auf Save and continue later, um den Zwischenstand zu sichern.
Wie HubSpot-Datensätze mit der richtigen Kampagne verknüpft werden
HubSpot erfasst LeadJourneys Click-ID nicht von allein – du speicherst sie auf dem Datensatz
und mappst sie hier. Üblich ist ein verstecktes Feld in deinem HubSpot-Formular, das die
click_id des Besuchers enthält (LeadJourneys Tracking-Script füllt es) und in eine
Kontakt-Property geschrieben wird. Zeige im Tab Configure Mapping click_id auf diese
Property, und jeder Kontakt oder Deal kommt bereits mit dem Klick – und damit der Kampagne,
Ad Set und Anzeige – verknüpft an, der ihn verdient hat. Bei einem Formular-Trigger erscheint
das versteckte Feld als Click ID (lj_click_id), sobald Einsendungen es mitschicken. Keine
Click-ID? LeadJourney matcht als Fallback über email oder phone.
Deine Trigger verwalten
Jeder Trigger erscheint als Zeile (z. B. Deal · dealstage changed → Conversion-Typ, Meeting booked → Conversion-Typ oder Form · (Formularname) submitted → Conversion-Typ) mit einem Active- / Paused-Pill und einer Zusammenfassung, wie viele Felder und Filter er nutzt.
- Pause / Resume: stoppe einen Trigger über den Schalter vorübergehend, ohne ihn zu löschen.
- Edit: Trigger, Mapping, Filter oder Ziel-Conversion ändern. Die URL bekommt einen
trigger_id-Parameter, so kannst du einen Link teilen, der genau diesen Trigger öffnet. - Delete: tippe
deleteund klick auf Delete trigger. Mapping und Filter lassen sich nicht wiederherstellen; die anderen Trigger laufen weiter. - Weitere hinzufügen: nutze Add trigger erneut, um mehr HubSpot-Events (neue Kontakte, neue Deals, Stage-Änderungen) auf verschiedene Conversions zu mappen.
LeadJourney Properties in HubSpot
Nach dem Verbinden legt das Panel LeadJourney Properties eine Gruppe „LeadJourney Properties“ auf deinen HubSpot-Kontakten an und hält die Attribution des ersten und letzten Touchpoints (Kanal, Kampagne, Anzeige, Click-IDs, Landingpage, Gerät und mehr) auf jedem Kontakt aktuell, den LeadJourney zuordnen kann. Mit dem Schalter On / Off pausierst du diese Schreibvorgänge. Die Property-Gruppe bleibt in jedem Fall bestehen.
Daten zurück an HubSpot senden
Das Panel Send to HubSpot schreibt LeadJourney-Klicks, Conversions und Leads als Datensätze nach HubSpot, ganz ohne Zapier. Klick auf + Add destination, dann:
- Create this HubSpot record: wähle Contact, Deal, Company oder Lead.
- When this happens: wähle das LeadJourney-Event. Bei einem Conversion-Event kannst du es über Conversion type eingrenzen oder auf Any conversion type lassen.
- Write mode: Create legt immer einen neuen Datensatz an, Update aktualisiert nur einen vorhandenen Treffer und überspringt, wenn keiner gefunden wird, Upsert aktualisiert den Treffer, falls es einen gibt, und legt sonst neu an.
- Matching property (Update und Upsert): die HubSpot-Property, die einen vorhandenen Datensatz identifiziert (bei Kontakten meist die E-Mail). Bei Deals, Companies und Leads im Update-Modus kannst du auch Contact email oder Contact phone wählen, um den Datensatz über den verknüpften Kontakt zu finden.
- Map fields: wähle eine HubSpot property und danach den LeadJourney value, der hineingeschrieben wird. Mehrere Werte werden mit Leerzeichen verbunden, alternativ tippst du einen festen Wert ein und klickst auf Add. Find latest data zeigt echte Beispielwerte (filterbar nach Click-ID oder Lead-ID); + Add field fügt eine weitere Zeile hinzu. Im Update-Modus ändern sich nur die Properties, die du mappst.
Klick auf Create destination. Warnt der Dialog, dass deine Verbindung keinen Schreibzugriff für diesen Datensatztyp hat, verbinde HubSpot neu (Re-authorize im Header), um ihn zu erteilen. Jede Destination-Zeile hat Pause / Resume, Edit und Delete (Löschen stoppt neue Datensätze; bestehende HubSpot-Datensätze bleiben unberührt). Die Tabelle Sync history listet jede Zustellung mit Status (Success, Failed oder Skipped), Event, Objekt, Modus, Zeitpunkt und Detail sowie einem Retry-Button für fehlgeschlagene oder übersprungene Zustellungen.
Erneut verbinden
Wenn HubSpot die App widerruft, die Verbindung verloren geht oder HubSpot nicht erreichbar ist, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund (z. B. „HubSpot revoked your app“ oder „HubSpot is unreachable“). Klick auf Reconnect, um die Autorisierung erneut auszuführen. Um erteilte Berechtigungen aufzufrischen, während alles läuft, nutze Re-authorize im Header. In beiden Fällen bleiben Trigger und Einstellungen erhalten.
Trennen (Disconnect)
Um HubSpot zu entfernen, klick im Header auf Disconnect, tippe disconnect und
bestätige mit Disconnect HubSpot. Das ist bewusst so, weil es destruktiv ist:
Disconnect löscht deine Trigger
Das Trennen entfernt die HubSpot-Verbindung dauerhaft, löscht jeden Trigger und widerruft die OAuth-Freigabe. HubSpot-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt – du richtest sie neu ein.
Fehlerbehebung
Keine Datensätze bei „Find latest data“?
Für diesen Trigger ist in HubSpot noch nichts passiert, oder kein Datensatz steht gerade auf dem gesetzten Target value. Erstelle oder ändere einen passenden Datensatz (einen neuen Kontakt, einen neuen Deal, eine Stage-Änderung oder eine Formular-Einsendung) und klick dann erneut auf Find latest data. Der passende Datensatz sollte erscheinen, sodass du das Mapping abschließen kannst.
Datensätze kommen an, werden aber keiner Kampagne zugeordnet?
LeadJourney muss wissen, zu welchem Klick der Datensatz gehört. Prüfe, dass (1) das Tracking-Script installiert ist und Klicks erfasst, (2) dein HubSpot-Formular die Click-ID auf dem Datensatz speichert und der Trigger click_id auf diese Property mappt und (3) der Trigger Active ist. Als Fallback können email oder phone zum Matchen genutzt werden.
Header zeigt „Needs reconnect“?
HubSpot hat die Freigabe widerrufen, die Verbindung ist weg oder die API ist nicht erreichbar. Klick im Banner auf Reconnect, um neu zu autorisieren. Deine Trigger bleiben erhalten.
Eine Destination zeigt Failed- oder Skipped-Zustellungen?
Öffne Sync history und lies die Spalte Detail. Update überspringt, wenn kein Treffer gefunden wird, und ohne Schreibberechtigung lehnt HubSpot den Push ab (neu autorisieren, um sie zu erteilen). Korrigiere die Destination und klick dann auf Retry.
Häufige Fragen
Verwandte Artikel
Events aus einem eigenen CRM senden
Eine Entwickler-Referenz für die Conversion API. Sende ein Webhook (Postback) aus deinem eigenen CRM oder Backend, sobald sich eine Pipeline-Stufe ändert – LeadJourney ordnet es dem Ad-Klick zu. Inklusive Endpoint, Authentifizierung, vollständiger Payload-Referenz und kopierfertiger Beispiel-Requests in cURL, Node.js, PHP und Python.
Salesforce verbinden
Verbinde deine Salesforce-Organisation mit einer einzigen Autorisierung, ohne API-Keys zum Kopieren. Mappe Salesforce-Events wie neue Leads, neue Opportunities und Stage-Änderungen auf deine Conversions und schreibe LeadJourney-Daten als Datensätze zurück nach Salesforce.