Fehlerbehebung bei der Theme-Integration
Die Integration von ShopGuide in ein Thema verläuft die meiste Zeit reibungslos, aber wenn dies nicht der Fall ist, ist die Ursache normaler weise eine von wenigen vorhersehbaren Dingen. So gehen Sie damit um.
Der Chat-Block wird nicht angezeigt.
Egal, ob es in der Kategorie „Apps“ des Theme-Editors fehlt oder einfach nicht auf den Live-Seiten angezeigt wird – gehen Sie die folgenden Schritte der Reihe nach durch:
- Bestätigen Sie, dass ShopGuide installiert ist und Ihr Abonnement oder Ihre Testversion aktiv ist (ShopGuide admin → Einstellungen/Abrechnung)
- Bestätigen Sie, dass Ihr Thema Online Store 2.0 ist-ältere Themen unterstützen überhaupt keine App-Blöcke. siehe Shopify Theme Editor Basics
- Bestätigen Sie, dass der BlockShopGuide Chattatsächlich zu der Seite oder Vorlage hinzugefügt wird, die Sie sich ansehen. Ein Block wird nur dort angezeigt, wo er platziert wurde
- Bestätigen Sie, dassPause-Chat-Store front weitnicht aktiviert ist (ShopGuide Admin → Einstellungen)
- Leeren Sie den Browser-Cache und führen Sie eine Hard-Refresh durch (Strg+F5/Befehl+Umschalt+R).
Wenn es wirklich in der Vorlage fehlt, fügen Sie es erneut hinzu:Abschnitt hinzufügen → Apps → ShopGuide Chat. Wenn der Block vorhanden ist, aber nichts angezeigt wird, überprüfen Sie die Browser-Konsole auf JavaScript-Fehler und versuchen Sie es mit einem anderen Browser oder in einem Inkognito-Fenster. eine Verlängerung ausschließen.
Stylingprobleme
Farben, die nicht zu Ihrer Marke passen, ein zu geringer Kontrast oder eine Blase, die ein anderes feststehendes Element auf der Seite überlagert (z. B. einen Warenkorb-Drawer, eine festhängende „In den Warenkorb“-Leiste, ein Cookie-Banner oder das mobile Menü), lassen sich alle auf dieselben wenigen Lösungen zurückführen: Passen Sie die Farben und das Design an. Vorlage auf der Seite Aussehen (siehe Chat-Erscheinung sbild & Branding), versuchen Sie die gegenüber liegende Ecke oder aktivieren Sie "Store hat mobile Navigations leiste" (siehe Chat-Position ierung & Layout) oder greifen Sie mit dem Widget nach Custom CSS real Selektoren für alles, was die Einstellungen nicht abdecken (siehe Advanced Chat Styling).
Der Chat öffnet sich, reagiert jedoch nicht.
Überprüfen Sie, ob das Besucher limit Ihres Plans nicht erreicht wurde (ShopGuide admin → Abrechnung), überprüfen Sie Ihre eigene Verbindung, öffnen Sie die Browser konsole (F12) und suchen Sie nach JavaScript-oder Netzwerk fehlern. Testen in einem anderen Browser und mit einem anderen Onlineshop Wenn Apps oder Werbeblocker vorübergehend deaktiviert sind, kann ein Konflikt ausgeschlossen werden. Ebenfalls einen kurzen Blick wert: der pausierende Schalter für den gesamten Shop.
Einige browserspezifische Eigenheiten
Werbeblocker und Datenschutz-Erweiterungen blockieren gelegentlich das Skript des Chats oder dessen Netzwerkanfragen – der Inkognito-Modus mit deaktivierten Erweiterungen ist die schnellste Methode, um dieses Problem auszuschließen. Der Tracking-Schutz in Safari und Firefox kann bei allem zu Störungen führen. Dies hängt von der Zustimmung zu Analysen ab, z. B. proaktiven Nachrichten, die erst geladen werden, wenn die Zustimmung erteilt wurde. Dies ist das erwartete Verhalten, das mit Shopify 'Customer Privacy API zusammen hängt, kein Fehler. Und es lohnt sich, zu überprüfen, ob Sie eine relativ aktuelle Version verwenden. Browser-Version, bevor Sie weitere Schritte einleiten.
Insbesondere auf Mobilgeräten
Eine Sprechblase, die zu klein ist, um bequem darauf zu tippen, oder eine, die sich über die untere Navigationsleiste legt, benötigt in der Regel lediglich eine größere Einstellung für dieSprechblasengröße(Einstellungen → Sprechblase) oder die Option „Shop verfügt über eine mobile Navigationsleiste“ muss aktiviert werden. Langsamere Reaktion auf älteren oder Bei Low-End-Geräten lohnt es sich, die Darstellung auf einigen echten Smartphones zu testen, anstatt sich ausschließlich auf die Mobilvorschau des Theme-Editors zu verlassen.
Themenkompatibilität
Online Store 2.0 ist erforderlich-App-Blöcke existieren auf älteren Themen architekturen nicht. Dawn und andere aktuelle Themes aus dem Theme Store funktionieren sofort ohne weitere Konfiguration. Ein stark angepasstes oder veraltetes Theme muss möglicherweise aktualisiert werden, bevor der Block hinzugefügt werden kann. Alle; siehe Grundlagen des Shopify-Themen redakteurs.
Nach jedem Theme-Update sollten Sie drei Dinge überprüfen: Das Block ist weiterhin dort angehängt, wo Sie es erwarten, das Pop‑up erscheint und öffnet sich wie vorgesehen, und die Stilierung stimmt noch – Theme-Updates setzen gelegentlich injiziertes benutzerdefiniertes CSS zurück. anderweitig.
Genauer hinsehen
Suchen Sie in der Browser konsole (F12 in Chrome/Firefox, Entwickeln → JavaScript-Konsole auf Safari anzeigen) nach Fehlern aus ShopGuides eigenen Skripten-secure-chat-core.js, chat-styles.css, ab-test-engine-bundle.js. Filtern Sie auf der Register karte Netzwerk nach Anfragen an die /apps/proxy/...-oder /apps/ai-agent-proxy/...-Pfade Ihres Geschäfts. Eine fehl geschlagene oder langsame Anfrage dort weist normaler weise eher auf ein Abonnement-, Preis-oder Konnektivitäts problem als auf ein Thema hin.
Wenn nichts davon behoben ist, wenden Sie sich an den ShopGuide-Support mit der .myshopify.com-Domain Ihres Shops, Ihrem Themen namen und ob es sich um den Online Store 2.0, handelt, Ihren Browser und Ihre Version, alle Konsolen fehler meldungen oder Screenshots und die zu reproduzieren den Schritte es.