Integrationen

Shopify verbinden

Verbinde deinen Shopify-Shop mit der LeadJourney-App, aktiviere das Tracking-Embed in deinem Theme und mappe Bestellungen, Erstattungen und Checkouts auf deine Conversions, damit jeder Verkauf der Anzeige zugeordnet wird, die ihn ausgelöst hat.

Wenn du Shopify verbindest, werden Shop-Events (Bestellungen, Erstattungen, Checkouts) zu LeadJourney-Conversions, zugeordnet der Kampagne, dem Ad Set und der Anzeige, die den Käufer gebracht haben. Du gibst deine Shop-Domain ein und bestätigst die LeadJourney-App in Shopify. Danach installiert LeadJourney automatisch ein Checkout-Pixel und abonniert deine Bestell-Events. Ein manueller Schritt bleibt: das LeadJourney Tracking-Embed in deinem Theme einschalten, damit das Tracking-Script auf deiner Storefront läuft. Gemappte Events 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 einen Shopify-Shop, in dem du Apps installieren und das Theme bearbeiten darfst.
  • Die .myshopify.com-Domain deines Shops (steht in der URL deines Shopify-Admins). Deine eigene Shop-Domain funktioniert hier nicht.
  • Mindestens einen Conversion-Typ zum Mappen (z. B. WonClient). Richte diese zuerst im Events Manager ein.
  • Optional, aber empfohlen: eine verifizierte Tracking-Domain, damit das Storefront-Script first-party lädt.

Wo du es findest

Öffne Settings → Apps oder gehe zu app.leadjourney.io/settings?slug=apps. Klick auf die Shopify-Karte (unter Payments & Ecommerce), um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your Shopify store“-Karte; nach dem Verbinden zeigt derselbe Screen deinen Shop, den Status des Store-Setups, den Schritt für das Storefront-Tracking und deine Trigger.

Schritt für Schritt

Shop-Domain eingeben und die App bestätigen

Trag auf der Connect your Shopify store-Karte deinen Shop in Store domain ein, z. B. acme.myshopify.com. Ein reiner Handle wie acme funktioniert auch: LeadJourney ergänzt ihn und zeigt darunter Connecting acme.myshopify.com. Klick auf Connect with Shopify.

Du wirst zu Shopify weitergeleitet, um die LeadJourney-App zu bestätigen. Sie fordert Lesezugriff auf Bestellungen, Checkouts und Kunden an (um Verkäufe in attribuierte Conversions zu verwandeln) sowie die Berechtigung, das LeadJourney Web Pixel zu installieren, das deine Storefront und den Checkout trackt. Keine Änderungen am Theme-Code, keine API-Keys zum Kopieren. Nach der Bestätigung schickt Shopify dich zurück und du siehst eine „Shopify connected“-Bestätigung.

Installation in Shopify gestartet?

Wenn du die App-Installation auf Shopify-Seite begonnen hast, landest du auf dieser Karte mit bereits ausgefülltem Store domain. Prüfe, ob es der richtige Shop ist, und klick auf Connect with Shopify, um ihn mit diesem Workspace zu verknüpfen.

Store-Setup abschließen lassen

Direkt nach dem Verbinden erledigt das Store setup-Panel zwei Aufgaben im Hintergrund:

  • Checkout pixel: „Links each completed checkout back to the visit that produced it.“ Zeigt Installed, sobald es fertig ist.
  • Order events: „Shopify notifies us of every sale, refund and checkout.“ Zeigt Subscribed, sobald es fertig ist.

Jede Zeile zeigt Working…, solange sie läuft, und aktualisiert sich von selbst. Steht in einer Zeile Failed, erscheint dort der Grund, und mit Retry setup kannst du sie erneut ausführen, ohne neu zu verbinden.

Tracking auf deiner Storefront aktivieren

Das Checkout-Pixel weiß, dass ein Verkauf passiert ist, braucht aber das LeadJourney-Script auf deiner Storefront, um zu wissen, von welcher Anzeige der Käufer kam. Klick im Panel Enable tracking on your storefront auf Open theme editor. Der Editor deines Live-Themes öffnet sich direkt in der Ansicht für App-Embeds. Dann:

  1. Öffne App embeds und schalte LeadJourney Tracking ein.
  2. Füge die zwei Werte aus LeadJourney in die Felder ein: LeadJourney workspace ID und Tracking domain (jeweils mit Copy-Button).
  3. Klick auf Save.

Der Wert für Tracking domain ist deine verifizierte Tracking-Domain aus Settings → Tracking; hast du noch keine eingerichtet, zeigt LeadJourney seine gemeinsame Standard-Domain.

Einmal pro Theme

Theme-Einstellungen werden nicht übernommen, wenn du ein Theme wechselst oder duplizierst. Sobald du ein anderes Theme veröffentlichst, schalte LeadJourney Tracking erneut ein und füge beide Werte wieder ein.

Einen Trigger hinzufügen

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

  1. App: Shopify (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den dieses Shopify-Event aufzeichnen soll, z. B. WonClient. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
  3. Trigger: wähle das Shop-Event aus dem Kartenraster, etwa eine Bestellung, eine Erstattung oder einen Checkout. Mit Search triggers… filterst du die Liste.

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 für dieses Event zu laden. Erscheint nichts, platziere eine Testbestellung und prüfe erneut, dann wähle einen Datensatz und klick auf Continue with selected record.
  • Configure Mapping: ordne den Shopify-Datensatz den LeadJourney-Spalten zu: Email, Name, Phone, click_id, Revenue und Currency (First name / Last name oder eigene Felder fügst du per Add custom field hinzu). LeadJourney füllt passende Pfade vor, z. B. record.email, record.total_price und record.currency. Das Mappen von click_id ist empfohlen, aber optional.
  • Filtering (optional): klick auf Add filter und setze Path, Operator (z. B. equals, contains, greater than) und Value, damit der Trigger nur bei passenden Datensätzen feuert.

Klick auf Save & Continue, um abzuschließen.

Wie Bestellungen mit der richtigen Kampagne verknüpft werden

Das Storefront-Embed erfasst den Besuch samt Click-ID, und das Checkout-Pixel verknüpft den abgeschlossenen Checkout mit diesem Besuch. Zusätzlich stellt LeadJourney auf jedem Datensatz die aus der Bestellung gewonnene Click-ID als record.lj_click_id bereit, die die click_id-Zeile automatisch übernimmt. So kommt jede Bestellung bereits mit dem Klick (und damit der Kampagne, dem Ad Set und der Anzeige) verknüpft an, der sie verdient hat. Fehlt die Click-ID, kann weiterhin über email oder phone gematcht werden.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile (Shopify-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: einen einzelnen Trigger entfernen (zur Bestätigung delete tippen); die anderen laufen weiter.
  • Weitere hinzufügen: nutze Add trigger erneut, um mehr Shop-Events auf verschiedene Conversions zu mappen, z. B. Bestellungen auf eine Umsatz-Conversion und Erstattungen auf ein Refund-Event.

Erneut verbinden

Wird die LeadJourney-App aus deinem Shop deinstalliert, werden ihre Berechtigungen widerrufen oder antwortet Shopify nicht, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund (z. B. „Shopify rejected our access token“ oder „Your store is unreachable“). Klick auf Reconnect, um die Autorisierung für denselben Shop erneut auszuführen. Um die erteilten Berechtigungen jederzeit zu erneuern, nutze Re-authorize im Header. Deine Trigger und Einstellungen bleiben in beiden Fällen erhalten.

Trennen (Disconnect)

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

Disconnect löscht deine Trigger

Das Trennen entfernt den Shop dauerhaft aus diesem Workspace, löscht jeden Trigger und entfernt das LeadJourney-Tracking-Pixel von deiner Storefront. Verkäufe fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt.

Fehlerbehebung

„That doesn't look like a Shopify store“?

Das Feld akzeptiert nur eine .myshopify.com-Domain. Nutze die Domain aus der URL deines Shopify-Admins, nicht deine eigene Shop-Domain.

Store setup zeigt „Failed“?

Die fehlgeschlagene Zeile nennt den Grund. Behebe ihn, falls er bei dir liegt, und klick dann auf Retry setup. Neu verbinden musst du nicht.

Keine Datensätze bei „Find latest data“?

Dein Shop hat für dieses Event noch keine aktuellen Datensätze. Platziere eine Testbestellung (oder lege eine Erstattung an, um einen Refund-Trigger zu testen) und klick dann erneut auf Find latest data.

Bestellungen kommen an, werden aber keiner Kampagne zugeordnet?

Prüfe, dass (1) LeadJourney Tracking unter App embeds in dem Theme eingeschaltet ist, das tatsächlich veröffentlicht ist, mit korrekter Workspace-ID und Tracking-Domain, (2) das Checkout pixel Installed zeigt und (3) der Trigger Active ist und click_id mappt.

Häufige Fragen

Verwandte Artikel