Problemen oplossen met foutmeldingen voor e-mailtemplates

Wat je leert

Als je fouten of waarschuwingen tegenkomt in een e-mailtemplate, moet je ze mogelijk oplossen voordat je je bericht verzendt. Zoek in deze bron naar de foutmelding of waarschuwing die je tegenkomt om tips te vinden om het probleem op te lossen.

Waarschuwingen bij het verzenden van campagnes

• We hebben # blokken in je e-mail gevonden waarvan de standaardtekst nog ongewijzigd is of die leeg zijn. Controleer je e-mail voordat je doorgaat.
  Als je deze waarschuwing tegenkomt, zoek dan naar lege blokken of placeholdercontent (bijv. “Dit is een tekstblok. Klik hier om het te bewerken.”) in je template. Controleer de desktop- en mobiele versies van de template. Als je geen leeg blok of placeholdercontent kunt vinden, stuur dan een previewbericht naar jezelf en controleer het zowel op desktop als mobiel. Als de preview er goed uitziet, kun je het bericht veilig verzenden en deze waarschuwing negeren.
• Mogelijke problemen met e-mailcontent. Het lijkt erop dat er geen links in je e-mail staan. Ben je vergeten ze aan je e-mail toe te voegen?
  Deze waarschuwing verschijnt als je platte-tekst- of aangepaste HTML-e-mail geen links bevat. Controleer het bericht om er zeker van te zijn dat alle content is toegevoegd, inclusief links voor eventuele call-to-actions. Als je geen links in je e-mail wilt opnemen (behalve je afmeldingslink), kun je deze waarschuwing negeren.
• Afmeldingslink. We konden geen afmeldingslink in deze template vinden. Klaviyo voegt automatisch een afmeldingslink toe bij het verzenden van de e-mail.
  Deze waarschuwing verschijnt als je geen afmeldtag aan je bericht hebt toegevoegd (bijv. {% unsubscribe %} of {% unsubscribe_link %}). Voeg een afmeldingslink toe om te voorkomen dat Klaviyo's standaardvoettekst aan je bericht wordt toegevoegd.

Voorbeeldweergavefouten

Wanneer je een voorbeeld van een bericht bekijkt, kun je deze foutmelding tegenkomen:

Bericht weergegeven zonder tags of variabelen
Corrigeer ongeldige templatetag of variabelen om een voorbeeld van het bericht weer te geven met werkelijke profielen en gebeurtenissen.

Dit bericht betekent dat Klaviyo een templatetag of variabele niet kon renderen. Als je de bron van de fout wilt vinden, controleer dan de onderwerpregel en bodycontent van je bericht op variabelen, tags of voorwaardelijke statements (oftewel alles in je template dat wordt omringd door {{ }} or {% %}) die niet het formaat volgen dat wordt beschreven in de referentie voor berichtpersonalisatie. Hieronder vind je een paar tips om de fout te vinden:

• Controleer zowel de desktop- als de mobiele versie van je bericht.
• Als je bericht een unieke coupon bevat, zorg er dan voor dat de couponnaam klopt en dat je coupon is geconfigureerd op het tabblad coupon.

Nadat je het probleem hebt opgelost, bekijk je het bericht opnieuw als voorbeeld met een profiel of event dat de gegevens bevat die je template gebruikt. Controleer of de variabelen worden ingevuld voordat je een testmail verstuurt.

Aangepaste HTML-templatefouten

• We konden de volgende afbeeldingen niet vinden: ... Zorg ervoor dat ze zijn opgenomen in het zipbestand dat je hebt geüpload.
  Controleer of je alle paden naar afbeeldingsbronnen correct hebt gespeld en of ze overeenkomen met de bestandsnamen van de afbeeldingen die je hebt geüpload. Als er geen afbeeldingspaden worden vermeld in het foutbericht, controleer dan je HTML-bestand op lege background-attributen (bijv. background=""). Verwijder lege background-attributen en upload daarna het gecorrigeerde HTML-bestand opnieuw.
• Een {% afmelden %} tag is vereist.
  Voeg een Klaviyo-tag voor afmelden toe aan de voettekst van je bericht om deze fout op te lossen.
• Kon de rest niet parseren: 'Z' van 'XYZ'.
  Deze fout betekent dat Klaviyo een deel van een template-expressie niet kon lezen. Controleer de expressie die in de foutmelding wordt geciteerd op verkeerd geplaatste of herhaalde aanhalingstekens, spaties in eigenschapsnamen of onjuiste filtersyntaxis. Het probleem kan in {{ }} variabelen of {% %} tags zitten. Raadpleeg de referentie voor berichtpersonalisatie voor ondersteunde syntaxis en voorbeelden.

Catalogusfouten

Als je template een catalog lookup tag gebruikt, kun je de foutmelding Kan item met code: __ niet vinden. Het is mogelijk verwijderd.tegenkomen.

Als je deze fout ziet, betekent dit dat we de item-ID in de tag niet herkennen. Zorg ervoor dat:

• Je bekijkt een voorbeeld met een event dat item-ID's bevat (als de item-ID dynamisch verwijst naar eventgegevens).
• Als de item-ID afkomstig is uit gebeurtenisgegevens of een profieleigenschap, is de verwijzing correct opgemaakt.
• De item-ID in je tag, gebeurtenisgegevens of profieleigenschap komt overeen met een item in je Klaviyo-catalogus.

Shopify-templatefouten

• Body html Liquid-syntaxisfout: Onbekende tag 'afmelden'
  Body html Liquid-syntaxisfout: Onbekende tag 'web_view'
  Deze fouten, en andere fouten zoals deze, betekenen dat er een Klaviyo-specifieke tag aan je template is toegevoegd voordat je die exporteerde naar Shopify. Shopify ondersteunt Klaviyo-links voor afmelden, voorkeuren beheren of webweergave niet. Verwijder die Klaviyo-specifieke links uit de Shopify-meldingstemplate voordat je die opnieuw exporteert.
• Body Html Liquid-syntaxisfout: onbekende tag "Load"
  Deze fout geeft aan dat de geëxporteerde HTML een Klaviyo-specifieke tag bevat die Shopify niet ondersteunt. Als je Shopify-meldingtemplate een Klaviyo-productblok bevat, verwijder je dit, exporteer je de HTML van je template en importeer je die in Shopify.
• Body html Liquid syntax error: Unknown tag 'elsif'
  Body html Liquid syntax error: 'if' tag was never closed
  Body html Liquid syntax error: 'X' Tag Was Never Closed
  Veel van Klaviyo’s Shopify-melding templates bevatten voorwaardelijke statements, die je bericht dynamisch maken op basis van de bestelstatus van de klant, en loops, die content herhalen voor items in een bestelling. Als een deel van een statement of lus wordt verwijderd, kun je een fout zien zoals de bovenstaande.
  
  Om dit op te lossen, open je de template in Klaviyo en herstel je de ontbrekende tags. Elke {% if ... %} heeft een bijbehorende {% endif %} nodig en elke {% for ... %} heeft een bijbehorende {% endfor %} nodig. Houd {% elsif ... %} en {% else %} binnen hun bijbehorende statement. Als je opzettelijk een statement of loop verwijdert, verwijder dan het hele blok, inclusief de inhoud, zodat er geen niet-overeenkomende tags of itemvariabelen achterblijven. Zoek naar deze openings-, vertakkings- en afsluitende tags:
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}

Nadat je wijzigingen hebt aangebracht, exporteer je de bijgewerkte template en importeer je deze in Shopify. Bekijk een voorbeeld en test de melding in Shopify voordat je deze opslaat. Shopify-meldingsvariabelen worden ingevuld in Shopify; met een Klaviyo-voorbeeld kun je alleen de styling controleren.