Fehlerbehebung für deine Checkout-Blocks-Inhalte
Der Inhalt deiner Checkout Blocks wird möglicherweise aus verschiedenen Gründen nicht wie erwartet angezeigt, was dazu führt, dass Elemente verschwinden oder nicht richtig funktionieren. Zu den häufigen Problemen gehören nicht erfüllte Anzeigeregeln, Fehlkonfigurationen von Berechtigungen oder Diskrepanzen zwischen den Einstellungen im Block selbst und der Art und Weise, wie der Block zum Checkout- und Konto-Editor hinzugefügt wurde.
Dieser Leitfaden hilft dir, häufige Probleme mit Checkout Blocks selbst zu beheben und zu lösen. Wenn du nach dem Durchgehen der Schritte in diesem Leitfaden weiterhin Probleme hast, dann kontaktiere den Shopify Support, um Unterstützung zu erhalten.
Auf dieser Seite
- Fehlerbehebung bei Blöcken
- Fehlerbehebung beim Erstellen oder Speichern von Blöcken
- Fehlerbehebung bei benutzerdefinierten Rabatten
- Fehlerbehebung bei Anpassungen von Liefer- und Zahlungsmethoden
- Änderungen mit einem Test-Checkout überprüfen
- Häufig gestellte Fragen
- Bevor du den Shopify Support bezüglich Checkout Blocks kontaktierst
Fehlerbehebung für Blöcke
Blöcke sind die Anpassungselemente, die Inhalte in deinem Checkout anzeigen, wie z. B. benutzerdefinierte Felder, dynamische Inhalte und Banner. Wenn ein Block nicht wie erwartet funktioniert, nutze die folgenden Abschnitte, um das Problem zu identifizieren und zu beheben.
Block wird im Checkout nicht angezeigt
Fehlerbehebung: Block nicht zum Editor hinzugefügt
Das Erstellen eines Blocks in der Checkout Blocks-App fügt ihn nicht automatisch zu deinem Checkout hinzu. Du musst den Block mit dem Editor für Checkout und Kundenkonten zu deiner Checkout-Konfiguration hinzufügen.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Einstellungen > Checkout.
Fehlerbehebung: Block nicht auf „Aktiv“ gesetzt
Ein Block muss auf Aktiv gesetzt sein, damit er im Checkout angezeigt wird. Blockentwürfe werden den Kund:innen nicht angezeigt.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Block nicht für Markt oder Seite veröffentlicht
Wenn dein Block mit marktspezifischen Veröffentlichungseinstellungen konfiguriert ist, wird er nur in den von dir ausgewählten Märkten angezeigt. Wenn der Block nur auf bestimmten Checkout-Seiten veröffentlicht wird, wird er auf anderen Seiten nicht angezeigt.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Anzeigeregeln nicht erfüllt
Anzeigeregeln definieren die Bedingungen, die erfüllt sein müssen, damit ein Block im Checkout angezeigt wird. Wenn diese Bedingungen während der Checkout-Sitzung von Kund:innen nicht erfüllt sind, wird der Block nicht angezeigt.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Nicht übereinstimmende Block-ID
Jeder Blocktyp im Checkout- und Konto-Editor hat eine Block-ID-Einstellung. Die Block-ID im Editor muss mit der Block-ID des Blocks übereinstimmen, den du in der Checkout-Blocks-App erstellt hast. Wenn die IDs nicht übereinstimmen, wird der Block nicht angezeigt.
Wenn dein Block in der Checkout-Blocks-App beispielsweise die Block-ID 4 hat, muss auch die Block-ID des Blocks im Checkout- und Konto-Editor auf 4 gesetzt sein.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Das Feld für die Vorschau-Block-ID enthält einen Wert
Das Feld Vorschau-Block-ID (für Testzwecke) im Checkout- und Konto-Editor ist nur für Testzwecke vorgesehen. Wenn dieses Feld nach dem Speichern deines Checkouts einen Wert enthält, kann es die Anzeigeregeln deines Blocks außer Kraft setzen und zu unerwartetem Verhalten führen.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Einstellungen > Checkout.
Fehlerbehebung: Ein Block mit höherer Priorität wird stattdessen angezeigt
Wenn du mehrere Blöcke desselben Typs mit überlappenden Anzeigeregeln hast, wird nur der Block mit der höchsten Priorität angezeigt. Mehr Informationen zur Block-Priorität.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung bei Erreichen des Limits für aktive Blöcke
Checkout Blocks unterstützt bis zu 30 aktive Blöcke pro Blocktyp. Wenn du mehr als 30 aktive Blöcke eines einzelnen Typs hast, z. B. 35 aktive Blöcke für benutzerdefinierte Felder, können nur die ersten 30 Blöcke im Checkout angezeigt werden.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Block wird mehrmals im Checkout angezeigt
Fehlerbehebung bei einem Block, der einem geteilten Abschnitt hinzugefügt wurde
Je nachdem, wo du einen Block im Editor für Checkout und Konten hinzufügst, wird er möglicherweise bei jedem Schritt des Checkouts angezeigt. Der Abschnitt Bestellübersicht und der Bereich, der mit der Schaltfläche zum Fortfahren oder Zurückkehren verbunden ist, sind auf allen Seiten des Checkouts gleich.
Um einen Block nur bei einem bestimmten Schritt anzuzeigen, füge den Block zum Hauptinhaltsbereich dieses Schritts hinzu.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Einstellungen > Checkout.
Fehlerbehebung bei mehrfach hinzugefügten Blockinstanzen
Einige Blocktypen, wie z. B. Blöcke vom Typ Bestellposition bearbeiten, müssen in der Regel nur einmal zum Checkout hinzugefügt werden. Der Block stützt sich auf Anzeigeregeln, um für verschiedene Szenarien unterschiedliche Inhalte anzuzeigen. Wenn Blockinhalte dupliziert werden, hast du den Block möglicherweise versehentlich öfter als nötig hinzugefügt.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Einstellungen > Checkout.
Fehlerbehebung bei Fehlern beim Erstellen oder Speichern von Blöcken
Wenn du beim Versuch, einen Block zu erstellen oder zu speichern, eine Fehlermeldung erhältst, lies die folgenden Abschnitte.
Fehlerbehebung für die Fehlermeldung „Bei der Übermittlung deines Formulars sind einige Probleme aufgetreten“
Dieser Fehler deutet in der Regel darauf hin, dass deinem Mitarbeiterkonto die erforderlichen Berechtigungen fehlen, um Blöcke in Checkout Blocks zu erstellen.
Erforderliche Berechtigungen:
- Shop-Berechtigungen > Inhalt: Mitarbeiter:innen müssen die Berechtigungen zum Anzeigen und zum Erstellen und Bearbeiten von Metaobjekt-Definitionen sowie zum Anzeigen und zum Erstellen und Bearbeiten von Einträgen haben.
- Shop-Berechtigungen > Shop-Einstellungen: Mitarbeiter:innen müssen die Berechtigung Einstellungen verwalten haben.
- App-Berechtigungen: Mitarbeiter:innen müssen mindestens Berechtigungen für Checkout Blocks haben.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Einstellungen > Benutzer und Berechtigungen.
- Klicke auf das Mitarbeiterkonto, bei dem der Fehler auftritt.
- Erweitere unter Shop-Berechtigungen den Abschnitt Inhalt.
- Bestätige, dass für Metaobjekt-Definitionen die Berechtigungen Anzeigen und Erstellen und Bearbeiten ausgewählt sind.
- Bestätige, dass für Einträge die Berechtigungen Anzeigen und Erstellen und Bearbeiten ausgewählt sind.
- Bestätige unter Shop-Einstellungen, dass Einstellungen verwalten ausgewählt ist.
- Bestätige unter App-Berechtigungen, dass Checkout Blocks ausgewählt ist.
- Klicke auf Speichern.
Wenn du keine Berechtigung hast, Mitarbeiterberechtigungen zu ändern, kontaktiere die Shop-Inhaber:innen oder andere Mitarbeiter:innen mit Berechtigungen zur Benutzerverwaltung.
Fehlerbehebung bei benutzerdefinierten Rabatten
In Checkout Blocks erstellte benutzerdefinierte Rabatte werden möglicherweise aufgrund mehrerer Faktoren nicht wie erwartet angewendet.
Fehlerbehebung bei Erreichen des Limits für aktive automatische Rabatte
Shopify erlaubt maximal 25 aktive automatische Rabatte gleichzeitig, einschließlich App-basierter Rabatte von allen installierten Apps. Dieses Limit gilt für deinen gesamten Shop, nicht nur für Checkout Blocks.
Wenn du versuchst, einen 26. automatischen Rabatt zu aktivieren, wird dieser im Checkout nicht angewendet.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Rabatte.
- Filtere, um nur automatische Rabatte anzuzeigen.
- Zähle, wie viele automatische Rabatte derzeit aktiv sind.
- Wenn du 25 oder mehr aktive automatische Rabatte hast, deaktiviere oder lösche Rabatte, die du nicht mehr benötigst, bevor du neue aktivierst.
Mehr Informationen zu den Einschränkungen beim Kombinieren von Rabatten.
Fehlerbehebung bei nicht aktivem Rabatt
Ein benutzerdefinierter Rabatt muss auf Aktiv gesetzt sein, damit er im Checkout angewendet wird. Der Rabatt darf außerdem nicht basierend auf dem konfigurierten Start- und Enddatum abgelaufen sein.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung bei nicht erfüllten Rabattregeln
Benutzerdefinierte Rabatte in Checkout Blocks können detaillierte bedingte Regeln haben, die bestimmen, wann der Rabatt angewendet wird. Wenn diese Bedingungen während der Checkout-Sitzung von Kund:innen nicht erfüllt sind, wird der Rabatt nicht angewendet.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung bei Anpassungen von Zustell- und Zahlungsmethoden
Wenn Zustell- oder Zahlungsmethoden nicht wie erwartet ausgeblendet, umbenannt oder neu angeordnet werden, dann lies die folgenden Abschnitte.
Fehlerbehebung: Anpassung nicht aktiv
Eine Anpassung der Zustell- oder Zahlungsmethode muss auf Aktiv gesetzt sein, damit sie im Checkout angewendet wird.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Limit für aktive Functions erreicht
Shopify Functions hat Beschränkungen für die Anzahl der aktiven Funktionen, die du pro Typ haben kannst. Du kannst in jedem Shop maximal 25 Funktionen zur Anpassung von Zahlungen aktivieren. Wenn du dieses Limit überschreitest, erhältst du möglicherweise die folgende Fehlermeldung: Failed to enable customization. Please try again or contact support.
Diese Limits tragen dazu bei, dass der Checkout eine hohe Leistung beibehält. Du musst Anpassungen zusammenführen oder entfernen, um das Limit nicht zu überschreiten.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Fehlerbehebung: Anpassungsregeln werden nicht erfüllt
Anpassungen von Zustell- und Zahlungsmethoden basieren auf Regeln, die festlegen, wann die Anpassung angewendet wird. Wenn diese Bedingungen während der Checkout-Sitzung einer Kund:in nicht erfüllt werden, wird die Anpassung nicht wirksam.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Apps > Checkout Blocks.
Änderungen mit einem Test-Checkout validieren
Bevor du dich in einer Live-Umgebung auf deine Anpassungen in Checkout Blocks verlässt, solltest du mit einem Test-Checkout überprüfen, ob sie wie erwartet funktionieren.
Schritte:
- Füge in deinem Onlineshop Produkte zu deinem Warenkorb hinzu, die den Bedingungen für die Blöcke, Rabatte oder Anpassungen entsprechen, die du testen möchtest.
- Gehe zum Checkout, schließe den Kauf aber nicht ab.
- Überprüfe jeden Schritt des Checkouts und überprüfe Folgendes:
- Blöcke werden an den richtigen Stellen und mit dem richtigen Inhalt angezeigt.
- Benutzerdefinierte Rabatte werden angewendet, wenn die Berechtigungsanforderungen erfüllt sind.
- Anpassungen von Zustell- und Zahlungsmethoden funktionieren wie erwartet.
- Wenn du Anzeigeregeln testest, die auf dem Gesamtwert des Warenkorbs basieren, probiere verschiedene Warenkorbwerte aus, um zu bestätigen, dass die Blöcke bei den richtigen Schwellenwerten angezeigt und ausgeblendet werden.
- Wenn du auf Kund:innen basierende Anzeigeregeln testest, dann teste sowohl Checkout-Szenarien für angemeldete Kund:innen als auch für Gäste.
Häufig gestellte Fragen
Wie viele Blöcke kann ich gleichzeitig aktiv haben?
Du kannst bis zu 30 aktive Blöcke pro Blocktyp haben. Beispielsweise kannst du gleichzeitig 30 aktive benutzerdefinierte Felder, 30 aktive dynamische Inhaltsblöcke und 30 aktive Bearbeitungsblöcke für Positionen haben. Du kannst mehr als 30 Blöcke eines Typs erstellen, aber im Checkout können nur die ersten 30 aktiven Blöcke angezeigt werden.
Warum benötige ich bestimmte Mitarbeitendenberechtigungen, um Checkout Blocks zu verwenden?
Checkout Blocks erstellt Metaobjekt-Definitionen, um Blockkonfigurationen zu speichern. Mitarbeiter:innen benötigen Berechtigungen zum Erstellen und Bearbeiten von Metaobjekt-Definitionen und -Einträgen, um Blöcke in der App speichern zu können. Zusätzlich benötigen Mitarbeiter:innen die Berechtigung Einstellungen verwalten unter Shop-Einstellungen und explizite App-Berechtigungen für Checkout Blocks.
Kann ich Checkout Blocks verwenden, wenn ich keinen Shopify-Plus-Plan habe?
Händler:innen mit dem Basic-Plan oder höher können Blöcke für dynamische Inhalte und statische Inhalte nur auf ihren Dankes- und Bestellstatus-Seiten verwenden. Alle anderen Funktionen von Checkout Blocks, einschließlich benutzerdefinierter Felder, benutzerdefinierter Rabatte und Anpassungen der Liefer- und Zahlungsmethoden, erfordern den Shopify Plus-Plan.
Woher weiß ich, welche Block-ID ich verwenden soll?
Wenn du einen Block in der Checkout Blocks-App erstellst, wird ihm eine Block-ID zugewiesen (der Standardwert ist 0). Wenn du diesen Blocktyp zu deinem Checkout im Editor hinzufügst, musst du dieselbe Block-ID festlegen, damit der Editor weiß, welcher spezifische Block angezeigt werden soll. Wenn du verschiedene Blöcke desselben Typs an unterschiedlichen Orten anzeigen möchtest, weise jedem Block eine eindeutige Block-ID zu und gib diese IDs im Editor an. Mehr Informationen zu Block-IDs.
Kann ich Rabatte von Checkout Blocks mit anderen Rabatten kombinieren?
In Checkout Blocks erstellte benutzerdefinierte Rabatte sind automatische Rabatte, die von Shopify Functions bereitgestellt werden. Sie befolgen dieselben Regeln für die Rabattkombination wie andere automatische Rabatte. Du kannst in deinem gesamten Shop maximal 25 aktive automatische Rabatte haben, einschließlich derer, die in Checkout Blocks und anderen Apps erstellt wurden.
Bevor du den Shopify Support wegen Checkout Blocks kontaktierst
Wenn du die oben genannten Schritte zur Fehlerbehebung ausprobiert hast und dein Problem mit Checkout Blocks weiterhin besteht, kannst du den Shopify Support kontaktieren, um Unterstützung zu erhalten. Bevor du den Shopify Support kontaktierst, sammle die folgenden Checkout Blocks-spezifischen Informationen, um dein Problem schneller zu lösen:
- Blockdetails: Der Name, der Typ (z. B. benutzerdefiniertes Feld, dynamischer Inhalt oder Positionsbearbeitung) und die Block-ID des Blocks, der nicht funktioniert.
- Konfigurations-Bildschirmaufnahmen: Bildschirmaufnahmen der Blockeinstellungen in der Checkout-Blocks-App, einschließlich aller Anzeigeregeln, Veröffentlichungseinstellungen und des Status.
- Editor-Bildschirmaufnahmen: Bildschirmaufnahmen, die zeigen, wie der Block im Checkout- und Konten-Editor konfiguriert ist, einschließlich der Felder „Block-ID“ und „Vorschau-Block-ID“.
- Fehlermeldungen: Bildschirmaufnahmen oder der genaue Text von Fehlermeldungen, die du beim Erstellen, Speichern oder Anzeigen der Vorschau von Blöcken erhältst.
- Test-Checkout-URL: Ein Link zu einem Test-Checkout oder einem abgebrochenen Checkout, über den das Problem reproduziert werden kann, zusammen mit dem Warenkorbinhalt, der zur Auslösung der Anzeigeregeln verwendet wurde.
- Erwartetes vs. tatsächliches Verhalten: Eine klare Beschreibung dessen, was deiner Erwartung nach hätte passieren sollen, im Vergleich zu dem, was tatsächlich im Checkout passiert.
- Abgeschlossene Schritte zur Fehlerbehebung: Welche Abschnitte aus diesem Leitfaden du bereits durchgesehen hast und was du ausprobiert hast.
- Berechtigungen für Mitarbeitende: Bestätigung, dass dein Konto über die erforderlichen Berechtigungen für „Inhalt“ (Metaobjekt-Definitionen und Einträge), „Shop-Einstellungen“ (Einstellungen verwalten) und „App-Berechtigungen“ (Checkout Blocks) verfügt.
Mit diesen Checkout-Blocks-spezifischen Informationen kann der Shopify Support dein Problem effizienter diagnostizieren und lösen.