Integrationen

Pipedrive-Webformulare zuordnen

Die LeadJourney-Click-ID durch ein Pipedrive-Webformular tragen, damit jede Einsendung der richtigen Kampagne zugeordnet wird – das versteckte Feld lj_click_id, der Embed, der die ID still verschluckt, und das Trigger-Mapping auf LeadJourney-Seite.

Aus einer Einsendung in einem Pipedrive-Webformular wird in Pipedrive ein Lead, und die Pipedrive-Integration von LeadJourney macht daraus eine Conversion. Ohne ein zusätzliches Feld kann LeadJourney diesen Lead allerdings nur über die E-Mail zuordnen – ein Erstbesucher, dessen Adresse noch nie gesehen wurde, bleibt damit ohne Zuordnung.

Diese Seite ergänzt genau dieses Feld: ein verstecktes lj_click_id, das vom Anzeigenklick ins Formular und von dort auf den Lead wandert.

Kurz gesagt

  1. In Pipedrive ein Text-Feld namens lj_click_id anlegen und im Formular als verstecktes Feld ergänzen.
  2. Die Click-ID in die URL des Formulars selbst bringen – der Standard-Embed erledigt das nicht.
  3. In LeadJourney im Trigger click_id auf lj_click_id zeigen lassen.

Bevor du startest

  • Pipedrive ist verbunden – siehe Pipedrive verbinden.
  • Aktives Tracking auf der Seite, die zum Formular verlinkt, damit es überhaupt eine Click-ID gibt – siehe Tracking-Skript installieren.
  • Web Forms gehören zum LeadBooster-Add-on von Pipedrive; zum Einrichten braucht es die Deals-Admin-Berechtigung.

Schritt 1: Das Feld in Pipedrive anlegen

Gehe in Pipedrive auf Settings → Data fields → Leads/Deals und lege ein eigenes Feld an:

  • Typ: Text
  • Name: lj_click_id — genau so, klein geschrieben, mit Unterstrichen

Der Name ist entscheidend, weil das Formular das Feld aus dem URL-Parameter mit demselben Namen füllt.

Schritt 2: Als verstecktes Feld ins Formular

Öffne Leads → Web Forms, öffne das Formular, füge das Feld lj_click_id hinzu und aktiviere Hidden field. Besucher sehen es nicht; es existiert nur, um den Wert zu transportieren.

Wiederhole das für jedes Formular, das zugeordnet werden soll. Ein Formular ohne das Feld erzeugt weiterhin Leads – sie kommen nur ohne Click-ID an.

Schritt 3: Die Click-ID in die Formular-URL bringen

Dieser Schritt entscheidet, ob das Ganze funktioniert. Das versteckte Feld wird aus einem Parameter ?lj_click_id=<id> auf der URL des Formulars selbst gefüllt.

Der Standard-Embed verliert die Click-ID

Der übliche Embed von Pipedrive – das pipedriveWebForms-Div samt Loader-Skript – rendert das Formular in einem iframe und reicht die Query-Parameter der umgebenden Seite nicht weiter. ?lj_click_id=… auf deiner Landingpage bringt also für sich genommen nichts: Der Parameter muss an der URL hängen, von der das Formular geladen wird.

Beide Wege unten brauchen zuerst die Click-ID des Besuchers im Browser. Dieser Helfer liest sie aus, mit Rückfallebenen für ein blockiertes Skript – die vollständige Erklärung steht in Click-ID auslesen und speichern:

async function getClickId() {
  try {
    const id = await window.lj?.getClickId();
    if (id) return id;
  } catch {}
  const fallbacks = [
    () => localStorage.getItem("clickId"),
    () => decodeURIComponent(document.cookie.match(/(?:^|; )clickId=([^;]*)/)?.[1] ?? ""),
    () => sessionStorage.getItem("clickId"),
    () => new URLSearchParams(location.search).get("lj_click_id"),
  ];
  for (const read of fallbacks) {
    try { const id = read(); if (id) return id; } catch {}
  }
  return null;
}

Wenn das Formular auf deiner Seite liegt, baue das iframe selbst statt den Loader von Pipedrive zu nutzen – so bestimmst du das src:

<iframe id="pd-form" title="Kontaktformular" width="100%" height="700" frameborder="0"></iframe>

<script>
  getClickId().then((clickId) => {
    const src = new URL("https://webforms.pipedrive.com/f/DEINE-FORMULAR-ID");
    if (clickId) src.searchParams.set("lj_click_id", clickId);
    document.getElementById("pd-form").src = src.toString();
  });
</script>

Die Formular-URL findest du in Pipedrive unter Share as link – es ist dieselbe URL, die auch der Loader verwendet hätte.

Höhe und Größenanpassung

Der Loader von Pipedrive passt die Höhe des iframes an, während das Formular wächst. Baust du das iframe selbst, setzt du stattdessen eine feste Höhe – plane also genug Platz für den längsten Zustand deines Formulars ein, inklusive Fehlermeldungen.

Schritt 4: Das Formular einmal absenden

Die Web-Form-Liste im Trigger wird aus Formularen gebaut, die kürzlich abgesendet wurden – Pipedrive bietet keine API, um Formulare aufzulisten. Sende dein Formular also einmal ab, mit einem echten Wert im versteckten Feld, damit es im nächsten Schritt erscheint.

Schritt 5: Den Trigger in LeadJourney anlegen

Öffne Einstellungen → Apps → Pipedrive, klicke auf Add trigger und richte ihn ein:

  1. LeadJourney Event: die Conversion, die diese Einsendung erfassen soll, typischerweise Lead.
  2. Trigger: das Pipedrive-Webformular-Ereignis.
  3. Web Form: dein Formular aus der Liste.
  4. Klicke auf Receive Data → Find latest data und wähle die eben erzeugte Einsendung.
  5. Zeige unter Configure Mapping mit click_id auf lj_click_id.

Speichern – und jede weitere Einsendung kommt mit dem Klick verknüpft an, der sie erzeugt hat.

Den Feld-Hash von Pipedrive brauchst du nicht

Pipedrive sendet eigene Felder unter einem 40-stelligen Hash statt unter dem Feldnamen – normal müsstest du also nach dem richtigen Schlüssel suchen. LeadJourney gleicht die Werte am Lead mit den Click-IDs deines Workspaces ab, erkennt den Treffer und bietet ihn als sauberen Pfad lj_click_id im Mapping an. Mehr als den richtigen Feldnamen im Formular brauchst du nicht.

Testen

Nimm eine Test-Anzeigen-URL oder eine aus dem UTM Builder, damit ein Klick erfasst wird.

Prüfen, ob die Formular-URL die ID trägt

Klick dich zum Formular durch und sieh dir die Adresse an – oder das src des iframes in den Entwicklertools. Dort muss lj_click_id= gefolgt von einer UUID stehen. Steht es nicht da, funktioniert Schritt 3 nicht, und alles Weitere ebenso wenig.

Absenden und den Lead prüfen

Sende das Formular ab, öffne den Lead in Pipedrive und prüfe, ob das Feld lj_click_id den Wert enthält.

Zuordnung bestätigen

Öffne in LeadJourney CRM → Leads und prüfe, ob der neue Lead eine Quelle zeigt. Das API-Postbacks-Log zeigt, ob über die Click-ID zugeordnet wurde oder über die E-Mail.

Fehlerbehebung

Das Feld bleibt bei jedem Lead leer

Fast immer Schritt 3. Prüfe die URL des Formulars, nicht die deiner Landingpage, auf ?lj_click_id=…. Nutzt du den Standard-Embed pipedriveWebForms, wird sie dort nie stehen – dieser Embed reicht den Parameter nicht durch.

Dein Formular steht nicht in der Web-Form-Liste

Die Liste zeigt nur Formulare mit einer kürzlichen Einsendung. Sende es einmal ab und öffne den Trigger-Dialog erneut.

Das Feld ist gefüllt, aber click_id wird im Mapping nicht angeboten

LeadJourney blendet lj_click_id ein, sobald es einen Wert sieht, der zu einer Click-ID deines Workspaces passt. Achte darauf, dass die unter Receive Data gewählte Einsendung auch tatsächlich die ID trug – eine ältere Testeinsendung ohne sie zeigt den Pfad nicht.

Manche Leads haben sie, andere nicht

Das ist erwartbar und kein Fehler: Besucher, die Cookies abgelehnt haben, mit blockiertem Skript kamen oder über einen Link gingen, den dein Snippet nicht umgeschrieben hat, haben keine Click-ID. Diese Leads entstehen trotzdem und lassen sich weiterhin über die E-Mail zuordnen.

Häufige Fragen

Verwandte Artikel