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

Qué aprenderás

Aprenda a añadir y utilizar un feed web personalizado dentro de un correo electrónico. Un feed web personalizado le 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á entonces disponible para su uso en su correo electrónico.

El poder de los feeds web es que le permiten utilizar una única plantilla y extraer contenido dinámicamente, donde sólo tiene que mantener el feed actualizado y Klaviyo se asegurará de que el contenido fresco de su feed se rellena en cada envío.

Este artículo repasará la adición y el uso de un feed web personalizado en campañas y flujos.

Antes de empezar

El primer paso para añadir contenido externo dinámico a cualquier correo electrónico en Klaviyo es crear su fuente de alimentación web. Su alimentación 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 hará una petición HTTP a su URL especificada y obtendrá los datos de su feed. Debido a que los correos electrónicos de flujo se envían continuamente, Klaviyo mantendrá actualizado el contenido de su feed consultando periódicamente la URL de su feed para extraer contenido actualizado en uno de los siguientes horarios: 

• Refresco cada 15 minutos
  Klaviyo intentará refrescar su feed cada 15 minutos. Para ello, su feed debe cargarse en cinco segundos y volver con una respuesta satisfactoria.

• Actualización nocturna
  Si su feed tarda más de cinco segundos en volver, después de tres horas intentándolo, empezaremos a intentar actualizarlo cada noche. Para las actualizaciones nocturnas continuas, su feed debe cargarse en menos de 30 segundos. 

Si no podemos cargar su feed en 30 segundos durante tres noches seguidas, no podrá utilizar este feed en sus correos electrónicos. Los correos electrónicos de flujo que dependan de este feed dejarán de enviarse, y los correos electrónicos de campaña y de flujo no se enviarán hasta que se elimine el feed o se resuelva el problema pendiente con su feed.

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

Si tenemos problemas para acceder a su feed web, recibirá notificaciones en la aplicación y por correo electrónico que se lo harán saber. Un paso fácil para solucionar el problema es volver a comprobar los requisitos de alimentación y asegurarse de que se ajustan a los parámetros indicados anteriormente. 

Si realiza 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 desea que Klaviyo intente una nueva actualización, navegue hasta el feed en la pestaña Data Feeds y haga clic en Update Data Feed. Probaremos y revalidaremos su alimentación. Si su feed es válido y devuelve una respuesta oportuna, reanudaremos el intento de mantener su contenido actualizado. Este es un buen paso para solucionar problemas que puede probar si tiene problemas para acceder a su fuente web, incluso si no ha realizado cambios.

Filtros Django

Apoyamos el uso de filtros Django para las variables que inserte. A continuación encontrará algunos filtros de uso común, y podrá 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 desea incluir un breve resumen de una entrada de blog bajo el título de la entrada (y su feed proporciona este texto de resumen), puede utilizar el filtro Truncar.

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

{{ item.summary|truncatechars:250 }}

Añadir un feed web personalizado

Configure su alimentación

1. Haga clic en el nombre de su empresa en la esquina inferior izquierda de Klaviyo.
2. Haga clic en Configuración.
3. Haga clic en Otros.
   
4. Haga clic en Fuentes web.
5. Haga clic en Añadir Web Feed.
   
6. Rellene los campos de alimentación web como se indica a continuación:
   • Nombre del feed
     Más tarde utilizará este identificador en su plantilla para acceder al contenido del feed. Dé a su feed un nombre corto y descriptivo. Recomendamos nombrar los feeds en mayúsculas (por ejemplo, "MyDataFeed") o todo en mayúsculas con espacios sustituidos por guiones bajos (por ejemplo, "MY_DATA_FEED"). No se permiten espacios en los nombres de los feeds. 
   • URL del feed
     El punto final que Klaviyo utiliza para obtener el contenido del feed (es decir, la URL del feed JSON o XML configurado previamente). Si su feed contiene información privada, le recomendamos encarecidamente que utilice una URL HTTPS e incluya un parámetro de consulta nonce para proteger su feed.
   • Método de solicitud
     Especifique el método HTTP que se utilizará para solicitar su feed. Si no está seguro de cuál elegir, seleccione GET. 
   • 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. Una vez que haya rellenado todos los campos, haga clic en Añadir fuente web. Intentaremos consultar la URL del feed y validar que su feed funciona correctamente. Si nos encontramos con un error, verá un mensaje de error y no podrá guardar este nuevo feed hasta que se solucione el problema.
   • ¿Quiere probarlo pero no tiene su propia URL de alimentación web? Utilice la nuestra. Copie la siguiente URL del Centro de Ayuda de Klaviyo en el cuadro de URL de alimentación y pruébela en su propia cuenta de Klaviyo:

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

8. Klaviyo valida su feed y muestra cualquier error potencial. Una vez validado, verá su feed en Klaviyo y estará listo para ser utilizado en el correo electrónico.
   

Vista previa de su feed

Resulta ú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, busque su fuente. 
2. Pulse los tres puntos y seleccione Editar. 
   
3. En la página de detalles de la alimentación, haga clic en Vista previa. 

Al previsualizar su feed, verá el contenido del feed o un mensaje de error si no podemos cargar el feed. 

Si su feed es una matriz JSON, parsearemos automáticamente y mostraremos cada fila individualmente. Si es cualquier otra cosa, probablemente un diccionario JSON, mostraremos el diccionario completo.

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

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

Utilizar un feed web en un correo electrónico

Para las campañas, Klaviyo buscará cada feed una vez por envío y almacenará el contenido devuelto. Aunque realice envíos a miles de destinatarios, Klaviyo no realizará miles de peticiones a sus 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, estará disponible a través de la variable feeds:

{{ feeds }}

Por ejemplo, para el feed JSON anterior, ahora podemos hacer referencia o dar salida al 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. Arrastre un nuevo bloque de texto a su correo electrónico y colóquelo donde desee que aparezca el feed web.
2. Active la función de repetición de bloque/contenido: haga clic en la pestaña Opciones de visualización del bloque de texto y, a continuación, en Crear reglas de repetición.
3. Para el campo Repetir para, inserte feeds.YOUR_FEED_NAME, seguido del nombre de la(s) variable(s) que contiene(n) la matriz que desea iterar.
   • En nuestro ejemplo, como estamos iterando también sobre el valor "articles", repetiremos para: feeds.Klaviyo_Help_Center.articles.
4. Sus datos pueden estar anidados dentro de una serie de variables. Por ejemplo, su feed podría estar estructurado así: 

   rss: {
            ..... 
            canal: { 
                    ..... 
                        artículo: { 
                                .....}}}

   En este caso, utilizaría feeds.YOUR_FEED_NAME.rss.channel. item como su Repetición para.

5. Si sólo desea que este bloque itere sobre un determinado número de entradas, utilice el filtro "slice". Para utilizar este filtro, ajuste 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, inserte: artículo
7. Una vez configurada la función de repetición de bloque/repetición de contenido, puede insertar variables utilizando el alias" del elemento ".
8. Para identificar y añadir variables, abra la vista previa de su fuente web y consulte la forma en que están estructurados sus 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 dentro de la matriz de artículos están disponibles para su uso en un correo electrónico:
   
9. Para los datos de primer nivel, simplemente añada item antes del nombre de la variable que aparece en sus datos. Por ejemplo, utilice {{ 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, utilice la notación con puntos (por ejemplo, {{ item.images.thumbnail_url }}). Para obtener más información sobre las notaciones de puntos y las variables de plantilla, consulte nuestra guía sobre etiquetas de plantilla y sintaxis de variables. 
11. Cuando previsualice su plantilla, observará que la función Repetir bloque/repetición de contenido permitirá que este simple bloque de texto itere automáticamente sobre todas las entradas de su feed. Sólo se mostrarán las variables que especifique en el bloque de texto para cada entrada.
12. Si va a insertar una imagen, tenga en cuenta que deberá editar el campo Código fuente del bloque de texto y contener la imagen en una etiqueta <img src>.
    

Ha añadido un feed web personalizado a su correo electrónico y ahora puede rellenar dinámicamente un feed de datos desde su URL externa. 

Pruebe o valide su pienso

Si recibe un correo electrónico o una notificación dentro de la aplicación indicándole que tenemos problemas para acceder a su feed web:

1. Navegue hasta su feed y pulse el botón Actualizar feed.
2. Una vez completada la validación, hay dos tipos de mensajes de error que puede ver:
   • Respuesta no válida
     Si recibimos una respuesta de error al intentar consultar el contenido de su feed, le indicaremos el código de estado del error. Deberá 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 su fuente en 30 segundos, se producirán retrasos en el envío. Aunque es posible que haya podido guardar su feed históricamente, para mitigar el riesgo de retrasos en el envío, tendrá que solucionar el problema de rendimiento de su feed antes de volver a validarlo y guardarlo correctamente.

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

Le recomendamos que elimine la fuente problemática de todos los correos electrónicos mientras resuelve los problemas pendientes para evitar interrupciones en el envío.

Recursos adicionales

• Solucione los problemas de su feed web de Instagram en los correos electrónicos
• Cómo utilizar los feeds de productos y las recomendaciones