Fehlerbehebung — wenn das Popup nicht erscheint oder ein Code nicht greift

Die meisten Probleme haben eine von wenigen Ursachen. Geht die Punkte der Reihe nach durch; die häufigste steht jeweils oben.

Das Popup erscheint nicht#

1. Ist das App-Embed im Theme eingeschaltet? Ohne das PopUplift-App-Embed erscheint in eurem Shop nie ein Popup. Prüfen: Online Store → Themes → Customize → App embeds → PopUplift einschalten → Save. Das Embed gilt nur für das Theme, in dem ihr es einschaltet — nach einem Theme-Wechsel also erneut prüfen.

Beim Veröffentlichen warnt PopUplift mit Your theme is not running the popup yet, wenn es das Embed noch nie im Shop gesehen hat. Das Signal wird höchstens alle fünf Minuten aktualisiert und kommt erst, wenn eine Shop-Seite geladen wurde: Direkt nach dem Einschalten einmal den Shop in einem neuen Tab öffnen, dann I activated it — check again.

2. Ist das Popup veröffentlicht und die Kampagne aktiv? In der Popup-Liste steht der Status. Ein veröffentlichtes Popup mit dem Badge Paused wird niemandem gezeigt — unter More actions auf Resume klicken. Änderungen, die nur im Entwurf stehen, sieht der Shop erst nach Publish changes.

3. Habt ihr es selbst schon gesehen? Ein Popup, das ihr in diesem Browser abgeschlossen oder weggeklickt habt, erscheint dort nicht mehr von selbst. Außerdem öffnet jedes Popup höchstens einmal pro Sitzung, pro Seitenaufruf erscheint höchstens ein Popup, und die Frequenz-Regeln halten weitere Popups eine Weile zurück. Zum Testen deshalb immer ein neues privates Fenster nehmen.

4. Passt der Trigger? Ein Popup braucht mindestens eine Basic-Trigger-Gruppe. Exit intent · Desktop feuert nur am Desktop, wenn die Maus das Fenster verlässt; eine Gruppe für „Mobile" nur auf Mobilgeräten. Wartet bei Time delay die eingestellten Sekunden ab.

5. Passt das Targeting? Prüft die Bedingungen im Bereich Targeting. Häufige Stolperstellen:

• Gerät: Als Desktop zählt ein Fenster ab 1024 px Breite.
• Seite: Page path is exactly verlangt den genauen Pfad, z. B. /products/ring — ohne Domain.
• Einwilligung: Bedingungen zu früheren Besuchen, Quelle (UTM, Referrer) und Returning visitor können nur mit Einwilligung des Besuchers zutreffen. Wer im Cookie-Banner ablehnt, gilt z. B. nie als wiederkehrend. Mehr unter Consent und AVV.

6. Läuft ein anderes Popup zuerst? Sind mehrere Popups live, erscheint pro Seitenaufruf das, dessen Trigger zuerst feuert. Läuft ein A/B-Test, seht ihr eventuell Variante B.

7. Ist die Free-Grenze erreicht? Über 5.000 Besuchern im Monat pausiert der Free-Plan die Auslieferung; ein Banner in der App sagt das. Siehe Abrechnung und Pläne.

Zur Kontrolle: Die Karte auf der Detailseite des Popups zeigt, ob schon ein Popup-View gemessen wurde (Published; waiting for a measured popup view). Im Theme-Editor zeigt PopUplift eine Vorschau eines veröffentlichten Popups — das ist nur eine Vorschau und zählt nicht als View.

Das Theme-Embed#

• Das Embed ist der Hauptschalter für alle Popups: Ausschalten stoppt alle Popups auf einmal, ohne etwas zu löschen.
• Im Theme-Editor erscheint pro Seitenaufruf ein veröffentlichtes Popup sofort, ohne Trigger, ohne Statistik, ohne Lead und mit Beispielcode. Sind mehrere live, prüft ein bestimmtes Popup über Preview in der App. Wegklicken sperrt dort nichts. Ist noch kein Popup veröffentlicht, zeigt der Editor unten rechts einen Hinweis, dass PopUplift aktiv ist.

Ein Code funktioniert nicht#

Meldet Shopify an der Kasse, der Code sei ungültig oder nicht anwendbar:

• Mindestbestellwert — Shopify prüft ihn an der Zwischensumme des Warenkorbs.
• Abgelaufen — die Frist läuft ab der Vergabe des Codes; beim Code per E-Mail schon ab der Anmeldung im Popup, nicht erst ab der Bestätigung.
• Produktauswahl — gilt die Belohnung nur für bestimmte Produkte oder Kollektionen, muss so ein Artikel im Warenkorb liegen.
• Schon benutzt — ohne eigenes Nutzungslimit ist jeder Einmal-Code genau einmal einlösbar; mit Can only be redeemed once per customer zusätzlich nur einmal je Kunde.
• Kombination — ein anderer Rabatt im Warenkorb, mit dem der Code nicht kombiniert werden darf. Die Einstellungen stehen in der Belohnung unter Advanced settings.
• Static code — der Code muss genau so in Shopify existieren und aktiv sein. PopUplift prüft Tippfehler nicht.

Wird der Code nicht automatisch angewendet: Das automatische Einlösen braucht Apply the code automatically und klappt nicht in jedem Theme. Der Code bleibt dann sichtbar und lässt sich von Hand eingeben; „already applied" steht nur da, wenn der Shop es bestätigt hat.

Das Popup lässt sich nicht veröffentlichen#

• Datenschutz-Links fehlen. Enthält der Hinweistext im Popup den Link zur Datenschutzerklärung oder zu den AGB, müssen unter Settings → Shop & legal gültige Adressen dafür stehen.
• Code per E-Mail ohne Voraussetzungen. Dafür braucht es eine Belohnung, eine Klaviyo-Verbindung und eine Liste mit Double Opt-in.
• Fester Code doppelt vergeben (This discount code is already assigned to another popup). Derselbe feste Code hängt schon an einem anderen laufenden Popup — nehmt für eines der beiden einen anderen Code.
• Das Theme-Embed fehlt (Your theme is not running the popup yet). Das ist nur eine Warnung: Ihr könnt trotzdem veröffentlichen, aber ohne Embed sieht niemand das Popup (siehe oben).

Der Code kommt nicht per E-Mail#

Bei Send the code after email confirmation verschickt Klaviyo den Code aus eurem eigenen Flow. Prüft dort:

• Bestätigt? Der Code wird erst freigegeben, nachdem der Besucher die Double-Opt-in-Mail bestätigt hat.
• Gibt es einen Flow, der den Code verschickt — und ist er live? Ein Flow im Entwurf verschickt nichts. Die Karte Reward delivery flow im Schritt Opt-in zeigt euren Flow auf der Liste oder am Ereignis PopupLift Reward Released; Reward flow steht dann auf Draft oder None found. Nach dem Veröffentlichen erinnert PopUplift mit Reward email: not verified daran, einen eigenen Flow zu prüfen.
• Steht der Code in der Mail? In einem listen-getriggerten Flow {{ person.popuplift_offer }}, in einem Flow mit dem Auslöser PopupLift Reward Released {{ event.code }}. Ereignis-Variablen bleiben in einem listen-getriggerten Flow leer.
• Absender und Domain in Klaviyo eingerichtet und aktiviert? Ohne sie verschickt Klaviyo nichts, oft ohne Fehlermeldung.

Details: Die Reward-E-Mail.

Anmeldungen fehlen in Klaviyo#

• Unter Settings → Integrations → Klaviyo prüfen, ob die Verbindung Connected zeigt und die richtige Liste gewählt ist.
• Bei Double Opt-in erscheint ein Kontakt erst nach der Bestätigung als Listenmitglied.
• Unter Leads steht für jeden Kontakt, ob er an Klaviyo übertragen wurde.

Umsatz fehlt im Bericht#

PopUplift zählt nur bezahlte Bestellungen, die einen Popup-Code enthalten. Eine Bestellung ohne Code, eine noch nicht bezahlte Bestellung oder ein Code, der zu keinem Popup gehört, erscheint nicht. Wie genau gezählt wird: Berichte und Umsatz.

Immer noch hängen geblieben?#

Schreibt an support@popuplift.com — mit dem Namen des Popups, der Seite, auf der es erscheinen soll, und einem Screenshot der Meldung.