Integrationen

ActiveCampaign verbinden

Verbinde ActiveCampaign mit deiner API-URL und deinem API-Key. LeadJourney richtet Webhook und ein verstecktes Click-ID-Feld für dich ein, sodass Deals, Tags, Listen-Anmeldungen und Kontakt-Updates zu attribuierten Conversions werden und LeadJourney-Daten als Kontakte, Deals oder Tags zurückfließen können.

Wenn du ActiveCampaign verbindest, werden Deals, Tags, Listen-Anmeldungen und Kontakt-Updates zu LeadJourney-Conversions, automatisch der Kampagne, dem Ad Set und der Anzeige zugeordnet, die sie verdient haben. Weil jede ActiveCampaign-Automation mit einem Tag enden kann, macht ein Tag Added-Trigger aus jedem Automation-Ergebnis eine Conversion. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so automatisch jeden Ad-Postback, den du bereits eingerichtet hast. Auf demselben Screen kannst du außerdem LeadJourney-Klicks, Leads und Conversions zurück nach ActiveCampaign schicken.

Bevor du startest

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

  • Einen aktiven LeadJourney-Workspace und Zugriff auf Settings → Developer in ActiveCampaign.
  • Tracking ist live, denn Klicks müssen zuerst erfasst werden, damit Kontakte einer Kampagne zugeordnet werden können. Siehe Tracking-Script installieren.
  • 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 ActiveCampaign-Karte, um die Integration zu öffnen (oder nutze ?slug=apps&app=activecampaign). Solange du nicht verbunden bist, siehst du das Formular „Connect your ActiveCampaign account“; nach dem Verbinden zeigt derselbe Screen dein Konto, das Click-ID-Feld, deine Trigger und das Panel Send to ActiveCampaign.

Schritt für Schritt

API-URL und API-Key einfügen

ActiveCampaign bietet kein OAuth für Apps wie LeadJourney, du verbindest daher mit zwei Werten von einer Seite. Öffne in ActiveCampaign Settings → Developer und kopiere:

  • API URL: sieht aus wie https://your-account.api-us1.com. Sie enthält deinen Kontonamen und deine Region und muss deshalb zum Key passen.
  • API Key: auf derselben Seite, direkt unter der API-URL. Keys gehören zu einem einzelnen ActiveCampaign-User; wird dieser User entfernt, funktioniert der Key nicht mehr.

Füge beide ins Formular ein und klick auf Connect. LeadJourney prüft das Paar vor dem Speichern gegen die ActiveCampaign-API und speichert es verschlüsselt. Stimmt etwas nicht, erscheint der Fehler direkt im Formular. Bei Erfolg siehst du „ActiveCampaign connected“.

Die Synchronisierung startet beim Verbinden

LeadJourney erfasst neue ActiveCampaign-Events ab dem Moment der Verbindung. Datensätze und Änderungen von vor der Verbindung werden nicht importiert.

LeadJourney die Einrichtung abschließen lassen

Alles Weitere passiert nach dem Verbinden automatisch (klapp im Formular How do I set up ActiveCampaign for attribution? auf, um die Kurzfassung zu sehen):

  • LeadJourney registriert einen kontoweiten Webhook, sodass Deals, Tags, Listen-Anmeldungen und Kontakt-Updates sofort fließen, ohne Einrichtung pro Liste.
  • Es legt ein verstecktes Kontaktfeld LeadJourney Click ID an (siehe Callout unten).

Der Header zeigt dann ein Live-Pill (oder Needs reconnect) sowie Re-sync und Disconnect. Darunter siehst du Connection, dein Account, den Status des Click-id field (Ready mit seinem Personalization Tag oder Not created), Active triggers und Connected since.

Einen Trigger hinzufügen

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

  1. App: ActiveCampaign (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den dieses Event aufzeichnen soll, z. B. WonClient. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
  3. Trigger: wähle das ActiveCampaign-Event aus dem Karten-Raster. Tag Added ist meist der beste Einstieg.
  4. Attribute changed (optional, bei Events, die es unterstützen): wähle ein Feld und einen Target value, damit der Trigger nur bei diesem Wert feuert, z. B. Deal-Status Won aus allen Deal-Updates oder ein bestimmter Tag aus allen hinzugefügten Tags. Status, Tags und Listen zeigen ein Dropdown mit deinen echten Werten; mit Any value feuert jedes Update.

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 die 3 neuesten Datensätze zu laden. Lädt nichts, nennt der Dialog den Grund, wenn er ihn kennt (etwa ein Rate Limit); sonst lege einen passenden Datensatz in ActiveCampaign an und prüfe erneut.
  • Configure Mapping: ordne den Datensatz den LeadJourney-Spalten zu. Neue Trigger starten mit Email, Name, Phone, click_id, Revenue und Currency, vorbelegt aus Pfaden wie contact.email, contact.phone, contact.fields.LJ_CLICK_ID, deal.value und deal.currency. Deal-Events enthalten den primären Kontakt des Deals, daher funktioniert contact.email auch dort. Wähle mehrere Pfade, um sie mit Leerzeichen zu verbinden, oder stelle einem festen Wert static: voran. Add custom field fügt weitere Spalten hinzu.
  • Filtering (optional, „Filtering is not required“): lege einen Filter mit Pfad, Operator und Wert an, weitere über Add Another Filter. Jeder Filter wird gegen den gewählten Datensatz getestet und zeigt PASS oder FAIL, dazu eine Zusammenfassung wie „Your trigger would have fired“.

Klick auf Save & Continue, um abzuschließen, oder auf Save and continue later, um den Zwischenstand zu sichern.

Wie ActiveCampaign-Kontakte mit der richtigen Kampagne verknüpft werden

Beim Verbinden legt LeadJourney ein verstecktes Kontaktfeld LeadJourney Click ID an (im Header als Click-id field: Ready sichtbar). Trägt dieses Feld die Click-ID des Besuchers, werden Conversions dem exakten Anzeigen-Klick zugeordnet, statt über die E-Mail gematcht zu werden. Sorge dafür, dass alles, was deine Kontakte anlegt, die Click-ID in dieses Feld schreibt, und lass click_id im Tab Configure Mapping auf contact.fields.LJ_CLICK_ID gemappt. Ohne Click-ID matcht LeadJourney Conversions weiterhin über email oder phone mit Leads.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile (ActiveCampaign-Event → 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: Event, Bedingung, Mapping, Filter oder Ziel-Conversion ändern.
  • Delete: tippe delete zur Bestätigung. Mapping und Filter lassen sich nicht wiederherstellen; die anderen Trigger laufen weiter.
  • Weitere hinzufügen: nutze Add trigger erneut, z. B. einen Trigger pro Tag, der eine Stufe markiert.

Daten zurück an ActiveCampaign senden

Das Panel Send to ActiveCampaign schreibt LeadJourney-Klicks, Conversions und Leads nach ActiveCampaign, ganz ohne Zapier. Klick auf + Add destination, dann:

  1. Create this ActiveCampaign record: wähle Contact, Deal oder Tag (apply to contact). Eine Tag-Destination setzt einen Tag auf den Kontakt mit der gemappten E-Mail, der einfachste Weg, aus einer LeadJourney-Conversion eine ActiveCampaign-Automation zu starten.
  2. 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.
  3. Write mode: Create, Update (nur einen vorhandenen Treffer aktualisieren, überspringen, wenn keiner gefunden wird) oder, nur für Kontakte, Upsert (den Kontakt mit dieser E-Mail aktualisieren oder neu anlegen, falls es keinen gibt).
  4. Matching field (nur Update): bei Kontakten Email oder ein anderes Feld, das unten ebenfalls gemappt ist; bei Deals findet Contact email den Deal über den verknüpften Kontakt.
  5. Map fields: wähle ein ActiveCampaign field (oder tippe einen Custom-Field-Namen ein und klick auf Set) und danach den LeadJourney value, der gesendet wird. Mehrere Werte werden mit Leerzeichen verbunden, alternativ tippst du einen festen Wert ein. Find latest data zeigt echte Beispielwerte; + Add field fügt eine weitere Zeile hinzu.

Klick auf Create destination. Jede Zeile hat Pause / Resume, Edit und Delete (bestehende ActiveCampaign-Datensätze bleiben unberührt). Sync history listet jede Zustellung mit Status (Success, Failed oder Skipped) und Detail, mit Retry für fehlgeschlagene oder übersprungene Zustellungen.

Erneut verbinden und Re-sync

Wenn etwas bricht, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund:

  • „ActiveCampaign rejected the credentials“: der API-Key wurde vermutlich rotiert oder der zugehörige User entfernt. Kopiere API-URL und Key neu aus Settings → Developer und verbinde erneut.
  • „Webhook is not registered“: die Zugangsdaten funktionieren, aber es fließt nichts ein. Klick auf Re-sync.
  • „ActiveCampaign is rate-limiting us“: ActiveCampaign erlaubt 5 API-Anfragen pro Sekunde für dein gesamtes Konto. Eingehende Webhooks sind nicht betroffen; nur die Mapping-Screens werden langsamer, warte also kurz.
  • „ActiveCampaign is unreachable“: meist ein kurzer Ausfall. Versuch es in einer Minute erneut.

Re-sync registriert den Webhook neu und prüft das versteckte Click-ID-Feld erneut. Trigger und Einstellungen bleiben erhalten, nutze es also, wenn keine Events mehr ankommen oder das Click-id field Not created zeigt.

Trennen (Disconnect)

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

Disconnect löscht deine Trigger

Das Trennen löst dein ActiveCampaign-Konto dauerhaft vom Workspace, löscht jeden Trigger und widerruft die Webhook-Subscription. 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 also neu ein.

Fehlerbehebung

„Connect“ schlägt trotz gültigem Key fehl?

Ein gültiger Key mit der falschen API-URL scheitert genauso wie ein falscher Key. Kopiere beide Werte erneut von derselben Seite Settings → Developer, damit Kontoname und Region in der URL zum Key passen.

Revenue ist 100-mal zu hoch?

Mappe Revenue auf deal.value, nicht auf deal.value_cents. Das Cents-Feld ist ActiveCampaigns roher Integer-Wert (150000 für 1.500,00).

Kontakte kommen an, werden aber keiner Kampagne zugeordnet?

Prüfe, dass (1) das Tracking-Script installiert ist und Klicks erfasst, (2) das Click-id field Ready zeigt und deine Kontakte die Click-ID tatsächlich tragen und (3) der Trigger Active ist und click_id mappt. Als Fallback können email oder phone zum Matchen genutzt werden.

Häufige Fragen

Verwandte Artikel