Behebung von Fehlermeldungen bei E-Mail-Vorlagen
Übersicht
Wenn in einer E-Mail-Vorlage Fehler oder Warnungen auftreten, musst du sie möglicherweise beheben, bevor du deine Nachricht sendest. Durchsuche diese Ressource nach der Fehlermeldung oder Warnung, die auftritt, um Tipps zur Behebung des Problems zu finden.
Warnungen beim Kampagnenversand
- Wir haben # Blöcke in deiner E-Mail gefunden, die entweder noch den unveränderten Standardtext enthalten oder leer sind. Bitte überprüfe deine E-Mail, bevor du fortfährst.
Wenn diese Warnung angezeigt wird, suche nach leeren Blöcken oder Platzhalterinhalten (z. B. „Dies ist ein Textblock. Zum Bearbeiten hier klicken.“) in deiner Vorlage. Überprüfe die Desktop- und Mobilversionen der Vorlage. Wenn du keinen leeren Block oder Platzhalterinhalt findest, sende dir selbst eine Vorschau-Nachricht und überprüfe sie sowohl auf dem Desktop als auch auf Mobilgeräten. Wenn die Vorschau gut aussieht, kannst du die Nachricht bedenkenlos senden und diese Warnung ignorieren. - Mögliche Probleme mit dem E-Mail-Inhalt. Es sieht so aus, als ob es keine Links in deiner E-Mail gibt. Hast du vergessen, sie zu deiner E-Mail hinzuzufügen?
Diese Warnung wird angezeigt, wenn deine Nur-Text- oder benutzerdefinierte HTML-E-Mail keine Links enthält. Überprüfe die Nachricht, um sicherzustellen, dass alle Inhalte hinzugefügt wurden, einschließlich Links für alle Call-to-Actions. Wenn du keine Links in deine E-Mail aufnehmen möchtest (außer deinem Abmeldelink), kannst du diese Warnung ignorieren. - Abmeldelink. In dieser Vorlage wurde kein Abmeldelink gefunden. Klaviyo wird beim Versenden der E-Mail automatisch einen Abmeldelink hinzufügen.
Diese Warnung wird angezeigt, wenn du deinem Nachrichtentext keinen Abmelde-Tag hinzugefügt hast (z. B. {% unsubscribe %} oder {% unsubscribe_link %}). Füge einen Abmeldelink hinzu, um zu vermeiden, dass Klaviyos Standard-Footer an deine Nachricht angehängt wird.
Vorschaufehler
Beim Vorschauen einer Nachricht kann diese Fehlermeldung angezeigt werden:
Nachricht ohne Tags oder Variablen angezeigt
Korrigiere ungültige Vorlagen-Tags oder Variablen, um eine Vorschau der Nachricht mit konkreten Profilen und Ereignissen anzuzeigen.
Diese Meldung bedeutet, dass Klaviyo einen Vorlagen-Tag oder eine Variable nicht rendern konnte. Um die Ursache des Fehlers zu finden, prüfe den Betreff und den Textinhalt deiner Nachricht auf Variablen, Tag oder bedingte Anweisungen (d. h. alles in deiner Vorlage, das von {{ }} or {% %} umgeben ist), die nicht dem Format entsprechen, das in der Referenz zur Nachrichtenpersonalisierung beschrieben ist. Unten findest du einige Tipps, um den Fehler zu finden:
- Prüfe sowohl die Desktop- als auch die Mobilversion deiner Nachricht.
- Wenn deine Nachricht einen personalisierten Gutschein enthält, stelle sicher, dass der Gutscheinname korrekt ist und dass dein Gutschein im Tab Gutscheine konfiguriert wurde.
Nachdem du das Problem behoben hast, sieh dir die Nachricht noch einmal in der Vorschau an, und zwar mit einem Profil oder Ereignis, das die Daten enthält, die deine Vorlage verwendet. Bestätige, dass die Variablen ausgefüllt werden, bevor du eine Test-E-Mail sendest.
Fehler in benutzerdefinierten HTML-Vorlagen
- Wir konnten die folgenden Bilder nicht finden: ... Stelle sicher, dass sie in der ZIP-Datei enthalten sind, die du hochgeladen hast.
Überprüfe, ob du alle Quellpfade der Bilder korrekt geschrieben hast und ob sie mit den Dateinamen der Bilder übereinstimmen, die du hochgeladen hast. Wenn in der Fehlermeldung keine Bildpfade angegeben sind, überprüfe deine HTML-Datei auf leere background-Attribute (z. B.background=""). Entferne leere background-Attribute und lade dann die korrigierte HTML-Datei erneut hoch. - Ein {% unsubscribe %}-Tag ist erforderlich.
Füge deiner Nachrichtenfußzeile ein Klaviyo-Abmelden-Tag hinzu, um diesen Fehler zu beheben. - Der Rest konnte nicht geparst werden: „Z“ aus „XYZ“.
Dieser Fehler bedeutet, dass Klaviyo einen Teil eines Vorlagen-Ausdrucks nicht lesen konnte. Überprüfe den im Fehler angegebenen Ausdruck auf falsch platzierte oder wiederholte Anführungszeichen, Leerzeichen in Eigenschaftsnamen oder falsche Filtersyntax. Das Problem kann in {{ }}-Variablen oder in {% %}-Tag liegen. Sieh dir die Referenz zur Nachrichtenpersonalisierung an, um unterstützte Syntax und Beispiele zu finden.
Katalogfehler
Wenn deine Vorlage ein Katalog-Lookup-Tag verwendet, kann der folgende Fehler auftreten: Unable to find item with code: __. It may have been deleted.
Wenn du diesen Fehler siehst, bedeutet das, dass wir die Artikel-ID im Tag nicht erkennen. Stelle sicher, dass:
- Du siehst dir gerade eine Vorschau mit einem Ereignis an, das Artikel-IDs enthält (wenn die Artikel-ID dynamisch auf Ereignisdaten verweist).
- Wenn die Artikel-ID aus Ereignisdaten oder einer Profileigenschaft stammt, ist die Referenz korrekt formatiert.
- Die Artikel-ID in deinem Tag, deinen Ereignisdaten oder deiner Profileigenschaft stimmt mit einem Artikel in deinem Klaviyo-Katalog überein.
Fehler bei Shopify-Vorlagen
- Body html Liquid syntax error: Unknown tag 'unsubscribe'
Body html Liquid syntax error: Unknown tag 'web_view'
Diese Fehler und andere ähnliche Fehler bedeuten, dass deiner Vorlage ein Klaviyo-spezifischer Tag hinzugefügt wurde, bevor du sie nach Shopify exportiert hast. Shopify unterstützt Klaviyos Links zum Abmelden, zum Verwalten von Präferenzen oder zur Webansicht nicht. Entferne diese Klaviyo-spezifischen Links aus der Shopify-Benachrichtigungsvorlage, bevor du sie erneut exportierst. - Body Html Liquid Syntax Error : Unbekannter Tag „Load“
Dieser Fehler weist darauf hin, dass das exportierte HTML einen Klaviyo-spezifischen Tag enthält, den Shopify nicht unterstützt. Wenn deine Shopify-Benachrichtigungsvorlage einen Klaviyo-Produktblock enthält, entferne ihn, exportiere das HTML deiner Vorlage und importiere es in Shopify. - Body html Liquid-Syntaxfehler: Unbekannter Tag 'elsif'
Body html Liquid-Syntaxfehler: Tag 'if' wurde nie geschlossen
Body html Liquid-Syntaxfehler: 'X'-Tag wurde nie geschlossen
Viele der Shopify-Benachrichtigungsvorlagen von Klaviyo enthalten bedingte Anweisungen, die deine Nachricht dynamisch machen, basierend auf dem Bestellstatus der Kund*innen, sowie Schleifen, die Inhalte für Artikel in einer Bestellung wiederholen. Wenn ein Teil einer Anweisung oder Schleife gelöscht wird, kann ein Fehler wie die oben genannten angezeigt werden.
Um das zu beheben, öffne die Vorlage in Klaviyo und stelle die fehlenden Tags wieder her. Jedes {% if ... %} braucht ein passendes {% endif %}, und jedes {% for ... %} braucht ein passendes {% endfor %}. Belasse {% elsif ... %} und {% else %} innerhalb ihrer passenden Anweisung. Wenn du eine Anweisung oder Schleife absichtlich entfernst, entferne ihren gesamten Block einschließlich seines Inhalts, sodass keine nicht zugeordneten Tags oder Artikelvariablen übrig bleiben. Suche nach diesen öffnenden, verzweigenden und schließenden Tags:- {% for item in...
- {% endfor %}
- {% if...
- {% elsif...
- {% else %}
- {% endif %}
Nachdem du Änderungen vorgenommen hast, exportiere die aktualisierte Vorlage und importiere sie in Shopify. Sieh dir die Benachrichtigung in Shopify in der Vorschau an und teste sie, bevor du sie speicherst. Shopify-Benachrichtigungsvariablen werden in Shopify ausgefüllt; eine Klaviyo-Vorschau ermöglicht dir nur, das Styling zu überprüfen.