Solucionar problemas con los mensajes de error de las plantillas de email

Qué aprenderás

Si encuentras errores o advertencias en una plantilla de email, es posible que tengas que resolverlos antes de enviar tu mensaje. Busca en este recurso el mensaje de error o la advertencia que estás viendo para encontrar consejos para resolver el problema.

Advertencias de envío de campañas

• Hemos encontrado # bloques en tu email que aún tienen el texto predeterminado sin modificar o que están en blanco. Revisa tu email antes de continuar.
  Si ves esta advertencia, busca bloques vacíos o contenido de marcador de posición (por ejemplo, «Este es un bloque de texto. Haz clic aquí para editarlo.») en tu plantilla. Comprueba las versiones para ordenador y móvil de la plantilla. Si no puedes encontrar un bloque vacío o contenido de marcador de posición, envíate un mensaje de vista previa y revísalo tanto en ordenador como en móvil. Si la vista previa tiene buen aspecto, puedes enviar el mensaje con seguridad e ignorar esta advertencia.
• Posibles problemas con el contenido del email. Parece que no hay enlaces en el email. ¿Olvidaste añadirlos al email?
  Esta advertencia aparece si el email de texto sin formato o el email de HTML personalizado no incluye ningún enlace. Revisa el mensaje para asegurarte de que se ha añadido todo el contenido, incluidos los enlaces de cualquier llamada a la acción (CTA). Si no quieres incluir enlaces en el email (aparte del enlace para darse de baja), puedes ignorar esta advertencia.
• Enlace para darse de baja. No se ha encontrado ningún enlace para darse de baja en esta plantilla. Klaviyo añadirá automáticamente un enlace para darse de baja al enviar el email.
  Esta advertencia aparece si no has añadido una etiqueta para darse de baja a tu mensaje (p. ej., {% unsubscribe %} o {% unsubscribe_link %}). Añade un enlace para darse de baja para evitar que se añada el pie de página predeterminado de Klaviyo a tu mensaje.

Errores de vista previa

Al previsualizar un mensaje, puede que te encuentres con este mensaje de error:

Mensaje mostrado sin etiquetas ni variables
Corrige las etiquetas o variables de plantilla no válidas para acceder a la vista previa del mensaje con los perfiles y eventos reales.

Este mensaje significa que Klaviyo no pudo renderizar una etiqueta de plantilla o una variable. Para localizar el origen del error, revisa el asunto y el contenido del cuerpo del mensaje para detectar variables, etiquetas o declaraciones condicionales (es decir, cualquier elemento de la plantilla rodeado por {{ }} or {% %}) que no sigan el formato descrito en la referencia de personalización de mensajes. A continuación encontrarás algunos consejos para localizar el error:

• Comprueba las versiones de escritorio y móvil de tu mensaje.
• Si tu mensaje contiene un cupón único, asegúrate de que el nombre del cupón es correcto y de que el cupón se ha configurado en la pestaña cupón.

Después de corregir el problema, vuelve a previsualizar el mensaje con un perfil o evento que contenga los datos que usa la plantilla. Confirma que las variables se rellenan antes de enviar un email de prueba.

Errores de plantilla HTML personalizada

• No pudimos encontrar las siguientes imágenes: ... Asegúrate de que se incluyan en el archivo zip que subiste.
  Comprueba que has escrito correctamente todas las rutas de origen de las imágenes y que coinciden con los nombres de archivo de las imágenes que subiste. Si en el mensaje de error no se proporcionan rutas de imagen, revisa el archivo HTML para ver si hay atributos background vacíos (p. ej., background=""). Elimina los atributos background vacíos y, a continuación, vuelve a subir el archivo HTML corregido.
• Se requiere una etiqueta {% unsubscribe %}.
  Añade una etiqueta de baja de Klaviyo al pie de página de tu mensaje para resolver este error.
• No se pudo analizar el resto: 'Z' de 'XYZ'.
  Este error significa que Klaviyo no pudo leer parte de una expresión de plantilla. Comprueba la expresión citada en el error para ver si hay comillas mal colocadas o repetidas, espacios en los nombres de las propiedades o una sintaxis de filtro incorrecta. El problema puede estar dentro de variables {{ }} o etiquetas {% %}. Consulta la referencia de personalización de mensajes para ver la sintaxis compatible y ejemplos.

Errores del catálogo

Si tu plantilla usa una etiqueta de búsqueda en el catálogo, es posible que encuentres el error No se puede encontrar el artículo con el código: __. Es posible que se haya eliminado.

Si ves este error, significa que no reconocemos el ID del artículo incluido en la etiqueta. Asegúrate de que:

• Estás previsualizando un evento que contiene ID de artículo (si el ID de artículo hace referencia de forma dinámica a los datos del evento).
• Si el ID de artículo procede de datos de eventos o de propiedades de perfil, la referencia tiene el formato correcto.
• El ID de artículo de la etiqueta, los datos de evento o la propiedad de perfil coincide con un artículo del catálogo de Klaviyo.

Errores de plantilla de Shopify

• Body html Liquid syntax error: Unknown tag 'unsubscribe'
  Body html Liquid syntax error: Unknown tag 'web_view'
  Estos errores, y otros similares, significan que se añadió una etiqueta específica de Klaviyo a la plantilla antes de exportarla a Shopify. Shopify no admite los enlaces de darse de baja, gestionar preferencias o vista web de Klaviyo. Elimina esos enlaces específicos de Klaviyo de la plantilla de notificación de Shopify antes de volver a exportarla.
• Error de sintaxis de Liquid en el HTML del cuerpo: etiqueta "Load" desconocida
  Este error indica que el HTML exportado contiene una etiqueta específica de Klaviyo que Shopify no admite. Si la plantilla de notificación de Shopify contiene un bloque de producto de Klaviyo, elimínalo, exporta el HTML de la plantilla e impórtalo en Shopify.
• Error de sintaxis de Liquid en el html del cuerpo: etiqueta 'elsif' desconocida
  Error de sintaxis de Liquid en el html del cuerpo: la etiqueta 'if' nunca se cerró
  Error de sintaxis de Liquid en el html del cuerpo: la etiqueta 'X' nunca se cerró
  Muchas de las plantillas de notificación de Shopify de Klaviyo incluyen declaraciones condicionales, que hacen que el mensaje sea dinámico en función del estado del pedido del cliente, y bucles, que repiten contenido para los artículos de un pedido. Si se elimina parte de una declaración o un bucle, puedes ver un error como los de arriba.
  
  Para resolverlo, abre la plantilla en Klaviyo y restaura las etiquetas que faltan. Cada {% if ... %} necesita un {% endif %} correspondiente, y cada {% for ... %} necesita un {% endfor %} correspondiente. Mantén {% elsif ... %} y {% else %} dentro de su declaración correspondiente. Si eliminas intencionadamente una declaración o un bucle, elimina todo el bloque, incluido su contenido, para que no queden etiquetas sin correspondencia ni variables de artículos. Busca estas etiquetas de apertura, ramificación y cierre:
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}

Después de hacer cambios, exporta la plantilla actualizada e impórtala en Shopify. Previsualiza y prueba la notificación en Shopify antes de guardarla. Las variables de notificación de Shopify se rellenan en Shopify; una vista previa de Klaviyo solo te permite comprobar el estilo.