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 zapomniałeś(-aś) dodać je do e-maila?
  To ostrzeżenie pojawia się, jeśli Twój e-mail w wersji tekstowej lub niestandardowy e-mail HTML nie zawiera żadnych linków. Przejrzyj wiadomość, aby upewnić się, że dodano całą treść, w tym linki do każdego wezwania do działania (CTA). Jeśli nie chcesz umieszczać w e-mailu żadnych linków (poza łączem do wycofania subskrypcji), możesz zignorować to ostrzeżenie.
• Łącze do wycofania subskrypcji. W tym szablonie nie znaleziono łącza do wycofania subskrypcji. Klaviyo automatycznie doda łącze do wycofania subskrypcji podczas wysyłania e-maila.
  To ostrzeżenie pojawia się, jeśli nie dodasz do wiadomości znacznika wycofania subskrypcji (np. {% unsubscribe %} lub {% unsubscribe_link %}). Dodaj łącze do wycofania subskrypcji, aby uniknąć dołączania do Twojej 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 komunikat oznacza, że Klaviyo nie mógł wyrenderować znacznika szablonu lub zmiennej. Aby zlokalizować źródło błędu, sprawdź temat wiadomości i treść wiadomości pod kątem zmiennych, znaczników lub instrukcji warunkowych (tj. wszystkiego w Twoim szablonie ujętego w {{ }} or {% %}), które nie są zgodne z formatem opisanym w referencji personalizacji wiadomości. 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.

Po naprawieniu problemu ponownie wyświetl podgląd wiadomości, używając profilu lub zdarzenia zawierającego dane, których używa twój szablon. Upewnij się, że zmienne wypełniają się danymi, zanim wyślesz testowy e-mail.

Błędy niestandardowego szablonu HTML

• Nie mogliśmy znaleźć następujących obrazów: ... Upewnij się, że są dołączone do przesłanego pliku ZIP.
  Sprawdź, czy poprawnie wpisano wszystkie ścieżki źródłowe obrazów, i czy odpowiadają one nazwom plików obrazów, które przesłano. Jeśli w komunikacie o błędzie nie podano żadnych ścieżek obrazów, sprawdź swój plik HTML pod kątem pustych atrybutów background (np. background=""). Usuń puste atrybuty background, a następnie prześlij ponownie poprawiony plik HTML.
• Wymagany jest znacznik {% unsubscribe %}.
  Aby rozwiązać ten błąd, dodaj do stopki wiadomości znacznik wycofania subskrypcji Klaviyo.
• Nie udało się przeanalizować pozostałej części: 'Z' z 'XYZ'.
  Ten błąd oznacza, że Klaviyo nie mógł odczytać części wyrażenia w szablonie. Sprawdź wyrażenie zacytowane w błędzie pod kątem nieprawidłowo umieszczonych lub powtórzonych cudzysłowów, spacji w nazwach właściwości lub nieprawidłowej składni filtra. Problem może znajdować się w zmiennych {{ }} lub znacznikach {% %}. Zapoznaj się z informacjami o personalizacji wiadomości, aby poznać obsługiwaną składnię i przykłady.

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 zawartego w znaczniku. Upewnij się, że:

• Podglądasz zdarzenie zawierające identyfikatory elementów (jeśli identyfikator elementu dynamicznie odwołuje się do danych zdarzenia).
• Jeśli identyfikator elementu pochodzi z danych zdarzenia lub właściwości profilu, odwołanie jest prawidłowo sformatowane.
• Identyfikator produktu w Twoim znaczniku, danych zdarzenia lub właściwości profilu pasuje do produktu w Twoim katalogu Klaviyo.

Błędy szablonu Shopify

• Błąd składni Liquid w HTML treści: Nieznany znacznik „wycofać subskrypcję”
  Błąd składni Liquid w HTML treści: Nieznany znacznik „web_view”
  Te błędy i inne podobne oznaczają, że do Twojego szablonu dodano znacznik specyficzny dla Klaviyo przed wyeksportowaniem go do Shopify. Shopify nie obsługuje linków Klaviyo do wycofać subskrypcję, zarządzania preferencjami ani widoku w przeglądarce. Usuń te linki specyficzne dla Klaviyo z szablonu powiadomień Shopify, zanim ponownie go wyeksportujesz.
• Błąd składni Liquid w kodzie HTML treści : Nieznany znacznik "Load"
  Ten błąd oznacza, że wyeksportowany kod HTML zawiera znacznik specyficzny dla Klaviyo, którego Shopify nie obsługuje. Jeśli Twój szablon powiadomień Shopify zawiera blok produktu Klaviyo, usuń go, wyeksportuj kod 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” nie został nigdy zamknięty
  Błąd składni Liquid w kodzie HTML treści: znacznik „X” nie został nigdy zamknięty
  Wiele szablonów powiadomień Shopify w Klaviyo zawiera instrukcje warunkowe, które sprawiają, że Twoja wiadomość jest dynamiczna w zależności od statusu zamówienia klienta, oraz pętle, które powtarzają treść dla pozycji w zamówieniu. Jeśli część instrukcji lub pętli zostanie usunięta, możesz zobaczyć błąd podobny do tych powyżej.
  
  Aby to rozwiązać, otwórz szablon w Klaviyo i przywróć brakujące znaczniki. Każdy {% if ... %} wymaga odpowiadającego mu {% endif %}, a każdy {% for ... %} wymaga odpowiadającego mu {% endfor %}. Trzymaj {% elsif ... %} i {% else %} w ramach odpowiadającej im instrukcji. Jeśli celowo usuwasz instrukcję lub pętlę, usuń cały jej blok, łącznie z jego zawartością, aby nie pozostały żadne niedopasowane znaczniki ani zmienne pozycji. Szukaj następujących znaczników otwierających, rozgałęziających i zamykających:
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}

Po wprowadzeniu zmian wyeksportuj zaktualizowany szablon i zaimportuj go do Shopify. Przed zapisaniem podejrzyj i przetestuj powiadomienie w Shopify. Zmienne powiadomień Shopify są uzupełniane w Shopify; podgląd Klaviyo pozwala tylko sprawdzić styl.