Cómo añadir un feed web personalizado en un correo electrónico

Objetivos de aprendizaje

Aprende a añadir y utilizar un feed web personalizado dentro de un correo electrónico. Un feed web personalizado te permite rellenar dinámicamente un feed de datos desde una URL externa dentro de un correo electrónico de Klaviyo. Antes de enviar un correo electrónico, Klaviyo realiza una petición HTTP a la URL y obtiene los datos. El contenido del feed web estará disponible para que lo utilices en tu correo electrónico.

El poder de los feeds web es que te permiten utilizar una única plantilla y extraer contenido dinámicamente, por lo que sólo tienes que mantener el feed actualizado y Klaviyo se asegurará de que el contenido fresco de tu feed se incluya en cada envío.

Este artículo tratará sobre cómo añadir y utilizar un feed web personalizado en campañas y flujo.

Antes de empezar

El primer paso para añadir contenido dinámico externo a cualquier correo electrónico en Klaviyo es crear tu web origen de fuente. Tu pienso debe: 

• Estar alojado en una URL accesible en formato JSON o XML
• Tener 3,3 MB o menos
• No utilizar una URL de redireccionamiento 

Klaviyo realizará una petición HTTP a tu URL especificada y obtendrá los datos de tu feed. Debido a que el flujo de correo electrónico se envía continuamente, Klaviyo mantendrá actualizado el contenido de tu feed consultando periódicamente la URL de tu feed para obtener contenido actualizado en uno de los siguientes horarios: 

• Actualizar cada 15 minutos
  Klaviyo intentará actualizar tu feed cada 15 minutos. Para ello, tu feed debe cargarse en cinco segundos y volver con una respuesta satisfactoria.

• Actualización nocturna
  Si tu feed tarda más de cinco segundos en volver, después de tres horas de intentarlo, empezaremos a intentar actualizar tu feed por la noche. Para la actualización nocturna continua, tu feed debe cargarse en menos de 30 segundos. 

Si no podemos cargar tu feed en 30 segundos durante tres noches seguidas, no podrás utilizar este feed en tu correo electrónico. flujo correo electrónico que dependa de este feed dejará de enviar, y campaña y flujo correo electrónico no enviarán hasta que se elimine el feed o se resuelva el problema pendiente con tu feed.

Cuando consultemos tu fuente, si obtenemos una respuesta de error, no podremos acceder al contenido de tu fuente. Seguiremos el mismo patrón anterior y volveremos a intentarlo durante un máximo de tres días. Mientras tanto, el correo electrónico no se enviará.

Si tenemos problemas para acceder a tu fuente web, recibirás notificaciones en la aplicación y por correo electrónico para informarte. Un paso fácil para solucionar el problema es volver a comprobar los requisitos de alimentación y asegurarte de que se ajustan a los parámetros indicados anteriormente. 

Si realizas cambios en un feed -por ejemplo, reducir el tamaño para acelerar el tiempo de carga o solucionar un problema que causa una respuesta de error- y deseas que Klaviyo intente una nueva actualización, navega hasta el feed en la pestaña Feeds de datos y haz clic en Actualizar Feed de datos. Probaremos y revalidaremos tu alimentación. Si tu feed es válido y devuelve una respuesta oportuna, reanudaremos el intento de mantener tu contenido actualizado. Este es un buen paso para solucionar problemas si tienes problemas para acceder a tu fuente web, aunque no hayas hecho cambios.

Filtros Django

Equipamos de asistencia el uso de filtros Django para las variables que insertes. A continuación se indican algunos filtros de uso común, y puedes obtener más información en nuestra guía sobre el Uso de filtros para personalizar variables y en el Glosario de filtros de variables.

Limitar el resumen del post a X número de palabras

Si quieres incluir un breve resumen de una entrada de blog bajo el título de la entrada (y tu feed proporciona este texto de resumen), puedes utilizar el filtro Truncar.

Para limitar el resumen de un artículo a 250 caracteres, por ejemplo, puedes utilizar:

{{ item.summary|truncatechars:250 }}

Añadir un feed web personalizado

Configura tu feed

1. Haz clic en el nombre de tu empresa en la esquina inferior izquierda de Klaviyo.
2. Haz clic en Configuración.
3. Haz clic en Otros.
   
4. Haz clic en Fuentes web.
5. Haz clic en Añadir fuente web.
   
6. Rellena los campos de alimentación web como se indica a continuación:
   • Nombre del feed
     Más tarde utilizarás este identificador en tu plantilla para acceder al contenido del feed. Dale a tu feed un nombre corto y descriptivo. Recomendamos nombrar los feeds en mayúsculas (por ejemplo, "MyDataFeed") o en mayúsculas, sustituyendo los espacios por guiones bajos (por ejemplo, "MY_DATA_FEED"). No se permiten espacios en los nombres de los feeds. 
   • URL del feed
     El punto de conexión que Klaviyo utiliza para obtener el contenido del feed (es decir, la URL del feed JSON o XML configurado previamente). Si tu feed contiene información privada, te recomendamos encarecidamente que utilices una URL HTTPS e incluyas un parámetro de consulta nonce para proteger tu feed.
   • Método de solicitud
     Especifica el método HTTP que se utilizará para solicitar tu feed. Si no estás seguro de cuál elegir, selecciona OBTENER. 
   • Tipo de contenido
     El formato del feed (JSON o XML). Recomendamos utilizar JSON si es posible. Para los feeds XML, el feed se convertirá a JSON.
7. Cuando hayas rellenado todos los campos, haz clic en Añadir fuente web. Intentaremos consultar la URL del feed y validar que tu feed funciona correctamente. Si nos encontramos con un error, verás un mensaje de error y no podrás guardar este nuevo feed hasta que se solucione el problema.
   • ¿Quieres probarlo pero no tienes tu propia URL de alimentación web? Utiliza la nuestra. Copia la siguiente URL del centro de ayuda de Klaviyo en la casilla Feed URL y pruébala en tu propia cuenta de Klaviyo:

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. Klaviyo valida tu feed y muestra los posibles errores. Una vez validado, verás tu feed en Klaviyo y estará listo para ser utilizado en el correo electrónico.
   

Previsualiza tu feed

Es útil previsualizar una fuente web antes de añadirla a un correo electrónico. Para previsualizar un feed:

1. En la página de fuentes web, busca tu fuente. 
2. Haz clic en los tres puntos y selecciona Editar. 
   
3. En la página de detalles del feed, haz clic en Vista previa. 

Cuando previsualices tu fuente, verás el contenido de la misma o un mensaje de error si no podemos cargarla. 

Si tu fuente es una matriz JSON, automáticamente analizaremos y mostraremos cada fila individualmente. Si es cualquier otra cosa, probablemente un diccionario JSON, mostraremos el diccionario completo.

Si estás desarrollando activamente tu feed, utiliza el botón actualizar para obtener la última versión de tu feed. La página de vista previa de un feed muestra el feed completo. Si tu fuente es grande, puede tardar varios segundos en mostrar el contenido. Ten en cuenta que si tu feed tarda más de 30 segundos en consultarse, esto afectará al rendimiento de cualquier correo electrónico que dependa de este feed.

Ahora que has añadido un feed web y previsualizado su contenido, puedes utilizarlo en un correo electrónico.

Utilizar un feed web en un correo electrónico

Para las campañas, Klaviyo obtendrá cada feed una vez por envío, y tienda, comercio el contenido devuelto. Aunque envíes a miles de destinatarios, Klaviyo no hará miles de peticiones a tus servidores.

Rellenar el contenido del feed en una plantilla

En nuestro feed web de ejemplo de la sección anterior, tenemos una matriz de artículos en la que cada entrada incluye un nombre, una URL, un ID de artículo, etc. Después de añadir un feed a un correo electrónico, está disponible a través de la variable feeds:

{{ feeds }}

Por ejemplo, para el feed JSON anterior, ahora podemos hacer referencia o mostrar el contenido del feed de artículos incluyendo esta sintaxis en nuestra plantilla:

{{ feeds.Klaviyo_Help_Center }}

Veamos un ejemplo en el que iteramos sobre todas las entradas de la matriz, mostrando determinadas variables. Utilizaremos el feed de Klaviyo Blog como ejemplo, e iteraremos sobre Imágenes.

1. Arrastra un nuevo bloque de texto a tu correo electrónico y colócalo donde quieras que aparezca la fuente web.
2. Activa las Funciones de repetición del bloque de texto/características: haz clic en la pestaña Opciones de visualización del bloque de texto y, a continuación, haz clic en Crear reglas de repetición.
3. En el campo Repetir para, inserta feeds.TU_NOMBRE_FEED, seguido del nombre de la(s) variable(s) que contiene(n) la matriz sobre la que quieres iterar.
   • En nuestro ejemplo, como también estamos iterando sobre el valor "articles", repetiremos para: feeds.Klaviyo_Help_Center.articles.
4. Tus datos pueden estar anidados dentro de una serie de variables. Por ejemplo, tu feed podría estar estructurado así: 

   rss: {
   ..... 
    canal: { 
   ..... 
    item: { 
   .....}}}

   En este caso, utilizarías feeds.TU_NOMBRE_FEED.rss.canal.item como tu Repetición para.

5. Si sólo quieres que este bloque itere sobre un determinado número de entradas, utiliza el filtro "slice". Para utilizar este filtro, ajusta el valor Repetir para añadiendo el filtro al final:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   En este ejemplo, |slice :':3' hará que sólo se muestren las tres primeras entradas. 
6. Para el campo Alias del artículo, inserta: artículo
7. Una vez configurado el bloque Repetición/Funciones de repetición de contenido/características, puedes insertar variables utilizando el alias" del elemento ".
8. Para identificar y añadir variables, abre la vista previa de tu fuente web y haz referencia a la forma en que están estructurados tus datos. Cualquier dato anidado dentro de la matriz utilizada en el campo Repetir para puede utilizarse como variable.
   En este ejemplo, todos los datos mostrados en la matriz de artículos están disponibles para su uso en un correo electrónico:
   
9. Para los datos de primer nivel, basta con añadir elemento antes del nombre de la variable que aparece en tus datos. Por ejemplo, utiliza {{ item.title }} para mostrar el título de un artículo, o {{ item.url }} para mostrar la URL de un artículo. 
10. Para acceder a los datos anidados dentro de las variables de primer nivel, utiliza la notación con puntos (p. ej, {{ item.images.thumbnail_url }}). Para saber más sobre las notaciones de puntos y la etiqueta de plantilla, consulta nuestra guía sobre la etiqueta de plantilla y la sintaxis de variables. 
11. Cuando previsualices tu plantilla, te darás cuenta de que las funciones Repetir bloque/Repetir contenido/características permitirán que este sencillo bloque de texto itere automáticamente sobre todas las entradas de tu feed. Sólo se mostrarán las variables que especifiques en el bloque de texto para cada entrada.
12. Si vas a insertar una imagen, ten en cuenta que tendrás que editar el campo Código fuente del bloque de texto y contener la imagen en una etiqueta <img src>.
    

Has añadido un feed web personalizado a tu correo electrónico y ahora puedes rellenar dinámicamente un feed de datos desde tu URL externa. 

Prueba o valida tu feed

Si recibes un correo electrónico o una notificación en la aplicación de que tenemos problemas para acceder a tu fuente web:

1. Navega hasta tu feed y pulsa el botón actualizar feed.
2. Una vez completada la validación, hay dos tipos de mensajes de error que puedes ver:
   • Respuesta no válida
     Si recibimos una respuesta de error al intentar consultar el contenido de tu feed, te indicaremos el código de estado del error. Tendrás que solucionar el problema que causa esta respuesta de error antes de que el feed pueda utilizarse correctamente dentro de cualquier correo electrónico.
   • Problema de rendimiento
     Si no recibimos una respuesta de tu fuente en 30 segundos, se producirán retrasos en el envío. Aunque hayas podido guardar tu feed históricamente, para mitigar el riesgo de retrasos en el envío, tendrás que solucionar el problema de rendimiento de tu feed antes de volver a validarlo y guardarlo correctamente.

En ambos casos, si utilizas una fuente problemática dentro de un envío, esto provocará retrasos en el envío o puede que tu correo electrónico se cancele por completo. Para el flujo, también es probable que los correos electrónicos no se envíen.

Te recomendamos que elimines la alimentación problemática de todo el correo electrónico mientras solucionas los problemas pendientes para evitar interrupciones en el envío.

Recursos adicionales

• Solucionar problemas de tu feed web de Instagram en correo electrónico
• Cómo utilizar la fuente de productos y recomendaciones