Importiert LeadJourney meine bestehenden Patch-Daten?

Nein. LeadJourney synchronisiert neue Patch-Events ab dem Moment der Verbindung. Daten von davor werden nicht importiert.

Patch Retention verbinden

Verbinde Patch Retention mit einem API-Token, mach aus Käufen, Check-ins, Buchungen und Formular-Einsendungen zugeordnete Conversions und schreibe LeadJourney-Gäste und -Events zurück nach Patch.

Wenn du Patch Retention verbindest, werden Käufe, Check-ins, Buchungen, Kontakte und Formular-Einsendungen aus Patch zu LeadJourney-Conversions, dem Gast zugeordnet über die Click-ID, wo du eine hast, und sonst über E-Mail oder Telefon. Patch bietet kein OAuth, deshalb verbindest du dich mit einem API-Token. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so jeden Ad-Postback, den du bereits eingerichtet hast. Außerdem kannst du LeadJourney-Gäste und -Events zurück nach Patch schreiben, etwa um eine Dankes-Automation zu starten.

Bevor du startest

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

Einen aktiven LeadJourney-Workspace und Zugriff auf die Settings deines Patch-Accounts.
Deinen Patch-API-Token, zu finden in Patch unter Settings → API Access.
Tracking ist live, damit Klicks erfasst sind, bevor Gäste konvertieren. Siehe Tracking-Script installieren.
Mindestens einen Conversion-Typ zum Mappen (z. B. Purchase). 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 Patch Retention-Karte, um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your Patch account“-Karte mit einer Einrichtungsanleitung (How do I set up Patch for attribution?); nach dem Verbinden zeigt derselbe Screen deinen Account, das Click-ID-Feld, die Automation-URLs, deine Trigger und den Bereich Send to Patch.

Schritt für Schritt

Mit deinem API-Token verbinden

Füge auf der Connect your Patch account-Karte deinen Token in Patch API token ein. Das Feld Click ID field key (optional) kann vorerst leer bleiben; nach dem Verbinden wählst du das Feld aus deinen echten Patch-Feldern aus.

Klick auf Connect. LeadJourney prüft den Token, indem es die Accounts auflistet, die er sehen kann, und du siehst eine „Patch connected“-Bestätigung. Das Polling deiner Bestellungen, Check-ins und Buchungen startet sofort.

Deinen Patch-Account auswählen

Sieht dein Token mehr als einen Patch-Account (ein Betreiber mit mehreren Venues), erscheint ein Panel Patch account. Wähle über Select a Patch account… die Venue, zu der dieser Workspace gehört. Bis dahin wird nichts gepollt und nichts konvertiert, und alles, was LeadJourney liest und schreibt, ist auf den gewählten Account beschränkt.

Das Click-ID-Feld einrichten

Die API von Patch kann Felder lesen, aber nicht anlegen, deshalb übernimmst du diesen Teil:

Gehe in Patch zu Settings → Fields und lege ein Kontaktfeld namens lj_click_id an.
Setze dieses Feld auf die Formulare und Waiver, die Gäste ausfüllen, befüllt mit dem Wert lj_click_id, den das LeadJourney-Tracking-Script an die Seiten-URL hängt.
Wähle das Feld zurück in LeadJourney im Panel Click ID field aus und klick auf Save field. Gerade erst angelegt? Klick auf Refresh fields, um die Liste neu aus Patch zu lesen.

Überspringst du das, wähle Don't use a click ID field: Conversions kommen trotzdem an und werden dem Gast über E-Mail oder Telefon zugeordnet, so wie der meiste Venue-Traffic ohnehin ankommt.

Eine Patch-Automation pro Event bauen

Patch hat keine Webhook-Einstellungen zum Ausfüllen. Das Panel Automation URLs listet eine URL pro Event. Baue für jedes Event, das konvertieren soll, eine Automation in Patch: Löse sie auf dieses Event aus, beende sie mit einem HTTP Request-Action-Block, setze die Methode auf POST und füge die passende URL ein.

Kopiere den Request body aus demselben Panel in die Parameter des Blocks und ersetze jeden Wert durch das passende Patch-Feld. Nur die Kontakt-ID ist Pflicht, weil LeadJourney die übrigen Gastdaten selbst aus Patch liest.

Events mit der Markierung polled werden zusätzlich alle zehn Minuten über die API von Patch gelesen und konvertieren daher auch ohne Automation; die Automation macht sie nur sofort. Die übrigen haben kein API-Event, dort ist eine Automation der einzige Weg zu LeadJourney. Klick auf Pull now, um aktuelle Bestellungen, Check-ins und Buchungen sofort abzurufen; der Header zeigt die Zeit unter Last pull.

Einen Trigger hinzufügen

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

App: Patch (bereits ausgewählt).
LeadJourney Event: der Conversion-Typ, den dieses Patch-Event aufzeichnen soll.
Trigger: wähle ein Patch-Event aus dem Raster (mit Search triggers… eingrenzen).

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 neuesten Datensätze für das Event zu laden, und wähle einen aus. Gibt es noch keinen, lege zuerst einen Test-Datensatz in Patch an oder tippe die Feldnamen im nächsten Tab ein.
Configure Mapping: ordne den Datensatz Email, Name, Phone, click_id, Revenue und Currency zu. Gastdaten liegen unter contact. (z. B. contact.email), und die Click-ID kommt als lj_click_id an, befüllt aus deinem Click-ID-Feld. Zeilen können mehrere Pfade kombinieren oder mit static:value einen festen Wert übernehmen; Add custom field fügt weitere hinzu.
Filtering (optional): klick auf Add filter, damit der Trigger nur feuert, wenn jeder Filter auf den eingehenden Datensatz passt.

Klick auf Save & Continue, um abzuschließen, oder auf Save and continue later, um einen Entwurf zu speichern.

Wie Patch-Gäste mit der richtigen Kampagne verknüpft werden

Gäste kommen genauso oft über Waiver, Kiosk und Kasse wie über ein Webformular in eine Venue, deshalb matchen Patch-Conversions standardmäßig über email oder phone. Für Zuordnung auf Klick-Ebene befüllst du lj_click_id auf dem Kontakt und mappst im Tab Configure Mapping click_id aus lj_click_id. Jede Conversion hängt dann am exakten Anzeigenklick und damit an Kampagne, Ad Set und Anzeige.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile (Patch-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, Mapping, Filter oder Ziel-Conversion ändern.
Delete: tippe delete zur Bestätigung. Die anderen Trigger laufen weiter.

Gäste und Events zurück nach Patch schreiben

Der Bereich Send to Patch schreibt LeadJourney-Klicks, -Conversions und -Leads nach Patch. Klick auf + Add destination und lege fest:

CREATE THIS PATCHRETENTION RECORD: Contact oder Event (purchase, check-in, booking). Über ein Event kann eine LeadJourney-Conversion eine Automation in Patch starten.
WHEN THIS HAPPENS: das LeadJourney-Event. Bei Conversions kannst du über CONVERSION TYPE eingrenzen oder Any conversion type stehen lassen.
WRITE MODE: Create or update (passenden Gast aktualisieren oder anlegen), Update only (nur Kontakte; überspringen, wenn der Gast nicht existiert) oder Create (nur Events; das Event einem Gast zuordnen, den Patch bereits kennt).
MATCHING FIELD: immer Pflicht, weil jeder Schreibvorgang in Patch an einem Gast hängt. Es muss außerdem eines der gemappten Felder sein.
MAP FIELDS: links das Patch-Feld, rechts die LeadJourney-Werte. Klick auf Find latest data, um echte Beispielwerte zu sehen, oder tippe einen festen Wert ein.

Klick auf Create destination. Die Tabelle Sync history listet jede Zustellung mit Status (Success, Failed, Skipped); fehlgeschlagene oder übersprungene kannst du mit Retry erneut senden. Das Löschen einer Destination ändert nichts an Datensätzen, die schon in Patch liegen.

Erneut verbinden

Wenn etwas bricht, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund: „Patch rejected your API token“ (der Token wurde rotiert oder widerrufen), „Pick a Patch account“ (wähle einen im Account-Panel) oder „Patch is unreachable“ (oft ein vorübergehender Ausfall). Klick auf Reconnect oder im Header auf Update API token, um einen neuen Token einzutragen. Deine Trigger und Einstellungen bleiben erhalten.

Trennen (Disconnect)

Um Patch zu entfernen, klick im Header auf Disconnect und tippe disconnect zur Bestätigung.

Disconnect löscht deine Trigger

Das Trennen entfernt die Patch-Verbindung dauerhaft, löscht jeden Trigger und verwirft den gespeicherten API-Token. Patch-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt. Entferne die Automationen, die du in Patch gebaut hast, wenn du sie nicht mehr brauchst.

Fehlerbehebung

Nach dem Verbinden konvertiert nichts?

Prüfe, ob ein Banner Pick a Patch account erscheint, und wähle deine Venue. Stelle dann sicher, dass der Trigger Active ist und bei Events ohne polled-Markierung die Patch-Automation an die richtige URL sendet.

„Patch has no field with the key …“?

Das eingetragene Click-ID-Feld gibt es in diesem Patch-Account nicht. Lege es in Patch unter Settings → Fields an, klick auf Refresh fields, wähle es aus und klick auf Save field.

Ein Kauf oder Check-in kommt verspätet an?

Ohne Automation werden gepollte Events alle zehn Minuten gelesen. Klick auf Pull now, um sie sofort abzurufen, oder richte die Automation für Echtzeit-Zustellung ein.