Risoluzione dei problemi relativi ai messaggi di errore dei modelli di e-mail

Cosa imparerai

Se incontri errori o avvisi in un modello di e-mail, potrebbe essere necessario risolverli prima di inviare il messaggio. Cerca in questa risorsa il messaggio di errore o l’avviso che stai riscontrando per trovare suggerimenti su come risolvere il problema.

Avvisi di invio della campagna

• Abbiamo trovato # blocchi nella tua e-mail che hanno ancora il testo predefinito non modificato o sono vuoti. Rivedi l'e-mail prima di continuare.
  Se visualizzi questo avviso, cerca blocchi vuoti o contenuti segnaposto (ad es. “Questo è un blocco di testo. Clicca qui per modificarlo.”) nel tuo modello. Controlla le versioni desktop e mobile del modello. Se non riesci a trovare un blocco vuoto o contenuti segnaposto, invia un messaggio di anteprima a te stesso e rivedilo sia su desktop sia su mobile. Se l'anteprima sembra corretta, puoi inviare il messaggio in sicurezza e ignorare questo avviso.
• Possibili problemi con il contenuto dell’e-mail. Non sembra che ci siano link nella tua e-mail. Hai dimenticato di aggiungerli alla tua e-mail?
  Questo avviso viene visualizzato se la tua e-mail in testo normale o l’e-mail HTML personalizzata non include alcun link. Controlla il messaggio per assicurarti che siano stati aggiunti tutti i contenuti, inclusi i link per eventuali call-to-action. Se non vuoi includere alcun link nella tua e-mail (a parte il link di annullamento dell'iscrizione), puoi ignorare questo avviso.
• Link di annullamento dell'iscrizione. Non è stato trovato alcun link di annullamento dell'iscrizione in questo modello. Klaviyo aggiungerà automaticamente un link di annullamento dell'iscrizione durante l'invio dell'e-mail.
  Questo avviso viene visualizzato se non hai aggiunto un tag di annullamento dell'iscrizione al tuo messaggio (ad es. {% unsubscribe %} o {% unsubscribe_link %}). Aggiungi un link di annullamento dell'iscrizione per evitare che il footer predefinito di Klaviyo venga aggiunto al tuo messaggio.

Errori di anteprima

Quando visualizzi l’anteprima di un messaggio, potresti visualizzare questo messaggio di errore:

Messaggio visualizzato senza tag o variabili
Correggi i tag modello o le variabili non validi per visualizzare l'anteprima del messaggio con profili ed eventi reali.

Questo messaggio significa che Klaviyo non è riuscito a eseguire il rendering di un tag modello o di una variabile. Per individuare l’origine dell’errore, controlla l’oggetto e il contenuto del corpo del messaggio per verificare la presenza di variabili, tag o istruzioni condizionali (ad esempio, qualsiasi elemento nel tuo modello racchiuso tra {{ }} or {% %}) che non seguono il formato descritto nella guida di riferimento alla personalizzazione dei messaggi. Di seguito alcuni suggerimenti per individuare l’errore:

• Controlla sia la versione desktop sia quella mobile del messaggio.
• Se il tuo messaggio contiene un coupon univoco, assicurati che il nome del coupon sia corretto e che il tuo coupon sia stato configurato nella scheda coupon.

Dopo aver corretto il problema, visualizza di nuovo l'anteprima del messaggio con un profilo o un evento che contenga i dati utilizzati dal modello. Verifica che le variabili vengano compilate prima di inviare un'e-mail di prova.

Errori del modello HTML personalizzato

• Non siamo riusciti a trovare le seguenti immagini: ... Assicurati che siano incluse nel file zip che hai caricato.
  Verifica di aver scritto correttamente tutti i percorsi di origine delle immagini e che corrispondano ai nomi file delle immagini che hai caricato. Se nel messaggio di errore non sono presenti percorsi delle immagini, controlla il file HTML per individuare attributi background vuoti (ad esempio background=""). Rimuovi gli attributi background vuoti, quindi carica di nuovo il file HTML corretto.
• È obbligatorio un tag {% annullare l'iscrizione %}.
  Aggiungi un tag di annullamento dell'iscrizione di Klaviyo al piè di pagina del tuo messaggio per risolvere questo errore.
• Impossibile analizzare il resto: 'Z' da 'XYZ'.
  Questo errore significa che Klaviyo non è riuscito a leggere una parte di un’espressione del modello. Controlla l’espressione riportata nell’errore per verificare la presenza di virgolette fuori posto o ripetute, spazi nei nomi delle proprietà o una sintassi del filtro errata. Il problema potrebbe trovarsi all’interno delle variabili {{ }} o dei tag {% %}. Fai riferimento alla guida di riferimento alla personalizzazione dei messaggi per sintassi ed esempi supportati.

Errori del catalogo

Se il tuo modello utilizza un tag di ricerca nel catalogo, potresti visualizzare l’errore Impossibile trovare l'articolo con codice: __. Potrebbe essere stato eliminato.

Se visualizzi questo errore, significa che non riconosciamo l’ID elemento incluso nel tag. Assicurati che:

• Stai visualizzando l’anteprima con un evento che contiene ID elemento (se l’ID elemento fa riferimento in modo dinamico ai dati dell’evento).
• Se l'ID dell'elemento proviene dai dati dell'evento o da una Proprietà del profilo, il riferimento è formattato correttamente.
• L'ID dell'articolo nel tuo tag, nei dati dell'evento o in una Proprietà del profilo corrisponde a un articolo nel tuo catalogo Klaviyo.

Errori del modello Shopify

• Body html Liquid syntax error: Unknown tag 'unsubscribe'
  Body html Liquid syntax error: Unknown tag 'web_view'
  Questi errori, e altri simili, significano che un tag specifico di Klaviyo è stato aggiunto al tuo modello prima di esportarlo su Shopify. Shopify non supporta i link di annullare l'iscrizione, gestisci preferenze o visualizzazione web di Klaviyo. Rimuovi questi link specifici di Klaviyo dal modello di notifica di Shopify prima di esportarlo di nuovo.
• Errore di sintassi Liquid HTML del corpo: tag sconosciuto "Load"
  Questo errore indica che l’HTML esportato contiene un tag specifico di Klaviyo che Shopify non supporta. Se il modello di notifica Shopify contiene un blocco prodotto Klaviyo, rimuovilo, esporta l’HTML del modello e importalo in Shopify.
• Body html Errore di sintassi Liquid: tag 'elsif' sconosciuto
  Body html Errore di sintassi Liquid: il tag 'if' non è mai stato chiuso
  Body html Errore di sintassi Liquid: il tag 'X' non è mai stato chiuso
  Molti modelli di notifica Shopify di Klaviyo includono istruzioni condizionali, che rendono il messaggio dinamico in base allo stato dell’ordine del cliente, e loop, che ripetono il contenuto per gli articoli in un ordine. Se viene eliminata una parte di un’istruzione o di un loop, potresti vedere un errore come quelli sopra.
  
  Per risolvere il problema, apri il modello in Klaviyo e ripristina i tag mancanti. Ogni {% if ... %} deve avere un corrispondente {% endif %} e ogni {% for ... %} deve avere un corrispondente {% endfor %}. Mantieni {% elsif ... %} e {% else %} all’interno della relativa istruzione corrispondente. Se rimuovi intenzionalmente un’istruzione o un loop, rimuovi l’intero blocco, inclusi i contenuti, così non rimangono tag non corrispondenti o variabili degli articoli. Cerca questi tag di apertura, diramazione e chiusura:
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}

Dopo aver apportato le modifiche, esporta il modello aggiornato e importalo in Shopify. Prima di salvarla, visualizza l’anteprima e testa la notifica in Shopify. Le variabili delle notifiche di Shopify vengono popolate in Shopify; un’anteprima in Klaviyo ti consente solo di verificare lo stile.