Rozwiązywanie problemów z komunikatami o błędach dotyczącymi szablonów e-mailowych

Czego się dowiesz?

Jeśli w szablonie e-maila pojawiają się błędy lub ostrzeżenia, może być konieczne ich rozwiązanie przed wysłaniem wiadomości. Wyszukaj w tym zasobie komunikat o błędzie lub ostrzeżeniu, które się pojawia, aby znaleźć wskazówki dotyczące rozwiązania problemu.

Ostrzeżenia dotyczące wysyłania kampanii

• Znaleźliśmy # bloków w Twojej wiadomości e-mail, które albo nadal mają niezmieniony domyślny tekst, albo są puste. Sprawdź wiadomość e-mail, zanim przejdziesz dalej.
  Jeśli pojawi się to ostrzeżenie, poszukaj pustych bloków lub treści zastępczej (np. „To jest blok tekstowy. Kliknij tutaj, aby go edytować.”) w swoim szablonie. Sprawdź wersje szablonu na komputery i urządzenia mobilne. Jeśli nie możesz znaleźć pustego bloku lub treści zastępczej, wyślij do siebie wiadomość podglądową i sprawdź ją zarówno na komputerze, jak i na urządzeniu mobilnym. Jeśli podgląd wygląda dobrze, możesz bezpiecznie wysłać wiadomość i zignorować to ostrzeżenie.
• Możliwe problemy z treścią e-maila. Wygląda na to, że w Twoim e-mailu nie ma żadnych linków. Czy zapomniano dodać je do e-maila?
  To ostrzeżenie pojawia się, jeśli e-mail w formacie zwykłego tekstu lub z niestandardowym kodem HTML nie zawiera żadnych linków. Sprawdź wiadomość, aby upewnić się, że dodano całą treść, w tym linki do wszelkich wezwań do działania (CTA). Jeśli nie chcesz dodawać żadnych linków w e-mailu (poza łączem do wycofania subskrypcji), możesz zignorować to ostrzeżenie.
• Łącze do wycofania subskrypcji. Nie mogliśmy znaleźć łącza do wycofania subskrypcji w Twoim e-mailu. Jeśli nie dodasz go ręcznie, Klaviyo zrobi to automatycznie podczas wysyłania e-maila.
  To ostrzeżenie pojawia się, jeśli nie dodano do wiadomości znacznika wycofania subskrypcji (np. {% unsubscribe %} lub {% unsubscribe_link %}). Dodaj łącze do wycofania subskrypcji, aby uniknąć dołączenia do wiadomości domyślnej stopki Klaviyo.

Błędy podglądu

Podczas podglądu wiadomości może pojawić się ten komunikat o błędzie:

Wiadomość wyświetlana bez znaczników lub zmiennych
Napraw nieprawidłowy znacznik szablonu lub zmienne, aby wyświetlić podgląd wiadomości z rzeczywistymi profilami i zdarzeniami.

Ten błąd oznacza, że gdzieś w Twojej wiadomości znajduje się nieprawidłowa składnia. Aby znaleźć źródło błędu, sprawdź temat wiadomości oraz treść wiadomości pod kątem zmiennych, znaczników lub instrukcji warunkowych (tj. wszystkiego w szablonie ujętego w nawiasy klamrowe {}), które nie są zgodne z formatem opisanym w zasobach Centrum pomocy Klaviyo. Poniżej znajdziesz kilka wskazówek, jak zlokalizować błąd:

• Sprawdź zarówno wersję wiadomości na komputery, jak i na urządzenia mobilne.
• Jeśli Twoja wiadomość zawiera kupon dynamiczny, upewnij się, że nazwa kuponu jest poprawna i że kupon został skonfigurowany na karcie Kupony.

Błędy niestandardowego szablonu HTML

• Nie udało się znaleźć następujących obrazów: ... Upewnij się, że są dołączone do przesłanego pliku zip.
  Sprawdź, czy wszystkie ścieżki źródłowe obrazów zostały poprawnie wpisane i czy odpowiadają nazwom plików przesłanych obrazów. Jeśli w komunikacie o błędzie nie podano ścieżek obrazów, sprawdź plik HTML pod kątem pustych atrybutów tła (np. background=””).
• Wymagany jest znacznik {% unsubscribe %}.
  Aby rozwiązać ten błąd, dodaj do stopki wiadomości znacznik wycofania subskrypcji Klaviyo.
• Nie można przeanalizować pozostałej części: „Z” z „XYZ”.
  Ten błąd oznacza, że jeden z Twoich znaczników (wszystko, co jest otoczone przez {% %}) nie jest rozpoznawany przez Klaviyo. Zapoznaj się z naszym przewodnikiem referencja personalizacji wiadomości, aby zobaczyć akceptowane znaczniki.

Błędy katalogu

Jeśli szablon używa znacznika wyszukiwania w katalogu, możesz napotkać błąd Nie można znaleźć elementu o kodzie: __. Mógł zostać usunięty.

Jeśli widzisz ten błąd, oznacza to, że nie rozpoznajemy identyfikatora elementu uwzględnionego w karcie. Upewnij się, że:

• Podglądasz zdarzenie zawierające identyfikatory elementów (jeśli identyfikator elementu dynamicznie odwołuje się do danych zdarzenia).
• Odwołanie do identyfikatora elementu w danych zdarzenia ma poprawny format.
• Identyfikator elementu z danych zdarzenia odpowiada temu, co znajduje się w katalogu Klaviyo.

Błędy szablonu Shopify

• Błąd składni Liquid w kodzie HTML treści: Nieznany tag „wycofać subskrypcję”
  Błąd składni Liquid w kodzie HTML treści: Nieznany tag „web_view”
  Te błędy i inne podobne oznaczają, że do szablonu dodano znacznik specyficzny dla Klaviyo przed wyeksportowaniem go do Shopify. Shopify nie obsługuje linków Klaviyo do wycofania subskrypcji, zarządzania preferencjami ani wersji przeglądarkowej.
• Błąd składni Liquid w treści HTML: nieznany znacznik "Load"
  Shopify nie obsługuje funkcji bloków produktów Klaviyo. Jeśli dodasz blok produktu do szablonu powiadomień Shopify, a następnie zaimportujesz ten szablon do Shopify, pojawi się ten błąd. Usuń blok produktu, wyeksportuj HTML swojego szablonu i zaimportuj go do Shopify.
• Błąd składni Liquid w kodzie HTML treści: nieznany znacznik 'elsif'
  Błąd składni Liquid w kodzie HTML treści: znacznik 'if' nigdy nie został zamknięty
  Błąd składni Liquid w kodzie HTML treści: znacznik 'X' nie został zamknięty
  Wiele szablonów powiadomień Shopify w Klaviyo zawiera instrukcje warunkowe, które sprawiają, że wiadomość jest dynamiczna w zależności od statusu zamówienia klienta. Jeśli część instrukcji warunkowej zostanie usunięta, zobaczysz błąd taki jak powyższe.
  
  Aby to rozwiązać, otwórz szablon w Klaviyo i usuń pozostałe elementy instrukcji warunkowej. Wyszukaj znaczniki zaczynające się od:
  • { % for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}