Cómo usar la función de repetición de contenido

Qué aprenderás

Aprende a usar la función de repetición de contenido para una sección o un bloque en una plantilla de email de Klaviyo Email. Estas funciones te permiten repetir el contenido de un bloque o una sección para cada entrada de una matriz (es decir, una lista) de datos procedentes de un evento del destinatario o de los datos de perfil, o de un feed de datos.

Antes de empezar

Si no estás familiarizado con el uso de datos de eventos, perfiles o catálogos en emails, consulta nuestra referencia de personalización de mensajes como primer paso.

También te será útil comprender los tipos de datos en Klaviyo, especialmente las listas (es decir, arrays). Una matriz almacena varios datos que están estructurados de la misma manera. Por ejemplo, los artículos comprados de un cliente se almacenan como un array dentro de un evento Placed Order. El array de artículos contiene 1 entrada por cada artículo pedido, y cada entrada contiene los detalles de 1 artículo (p. ej., el nombre del artículo, la URL de la imagen, la cantidad, la talla, el color, etc.).

Para repetir contenido a partir de los datos del evento, usa un email en un flujo activado por ese evento. Por ejemplo, usa los datos de Started Checkout en un flujo activado por Started Checkout. Para las campañas, usa una lista almacenada en los datos del perfil o un feed web personalizado.

Casos de uso de la función de repetición de contenido

Para usar la función de repetición de contenido, necesitarás una matriz o una lista de datos. La siguiente tabla muestra algunos ejemplos de matrices de datos que pueden existir en tu cuenta de Klaviyo, junto con casos de uso de muestra.

Puedes usar la función de repetición de contenido con cualquier matriz, tanto si se almacena en el perfil de un suscriptor o en los datos de evento, como en uno de tus feeds web. Los ejemplos anteriores son solo una pequeña muestra de cómo se pueden usar estas funciones.

Cómo usar la función de repetición de contenido

Para habilitar la función de repetición de contenido, navega a la sección o al bloque que quieres repetir y, a continuación, haz clic en Mostrar. En la sección Repetición de contenido, haz clic en Añadir repetición de contenido.

La repetición de contenido utiliza 2 campos: Repetir durante y Alias del elemento. Para rellenar estos campos y configurar tu contenido repetido, sigue los pasos que se indican a continuación:

1. Identificar tu «repetir para»
2. Elige tu «alias de elemento»
3. Crear tu contenido recurrente
4. Vista previa del correo

Identificar tu «repetir para»

La ruta completa a la matriz que quieres repetir pertenece al campo Repetir para.

Para una lista almacenada en una propiedad de perfil, usa la ruta completa de la propiedad, como person.FavoriteProducts para una propiedad llamada FavoriteProducts. Para un feed web personalizado con una lista de artículos, usa feeds.YOUR_FEED_NAME.articles y sustituye YOUR_FEED_NAME por el nombre del feed. Introduce la ruta sin llaves.

Para encontrar el nombre de tu matriz, consulta los datos de la fuente de datos (es decir, datos del perfil, datos de eventos o un feed de datos). Los pasos que se indican a continuación usan datos de eventos como ejemplo. Usa los nombres de las propiedades que se muestran en tus propios datos de eventos, ya que pueden variar según la integración:

1. En la plantilla de email, haz clic en Vista previa.
2. Si estás editando una plantilla guardada, selecciona Evento en Vista previa de la fuente de datos y selecciona el evento que activará el flujo (p. ej., Started Checkout). Si estás editando un email en un flujo activado por evento, los datos del evento se seleccionan automáticamente.
3. Usa las flechas para elegir un evento reciente que contenga los datos que quieres mostrar.
4. Desplázate por los datos de vista previa de tu evento hasta que encuentres un array que contenga la información que necesitas. Puedes usar los iconos de flecha de la izquierda de los datos para contraer las secciones que no necesitas y facilitar la navegación.

En este ejemplo, hay 2 matrices que almacenan información de los artículos:

• Elementos
  Una matriz de nivel superior que contiene una lista sencilla del nombre de cada elemento, pero ninguna otra información
• line_items
  Anidado dentro del objeto extra, y contiene más detalles, incluido el título, el precio, el SKU y la URL de la imagen de cada artículo
  

1. En este caso, te conviene usar el array más detallado, line_items, ya que contiene la información detallada necesaria para mostrarla en el bloque repetitivo. Para encontrar la variable adecuada que se debe establecer en el campo Repetir para, haz clic en 2 valores dentro de la primera entrada del array para copiar sus etiquetas, una a la vez. En este ejemplo, copiaremos las variables de variant_price y title. Estas son las 2 etiquetas que copiamos:
   • {{ event.extra.line_items.0.variant_price }}
   • {{ event.extra.line_items.0.title }}
2. Ignora las llaves y céntrate en las variables que hay dentro. Ten en cuenta que los comienzos de ambas variables son iguales: event.extra.line_items.0.
3. Haz clic en Listo para volver al editor y a la configuración de Repetición de contenido de tu bloque o sección.
4. Introduce todo hasta (pero sin incluir) el punto y el número al final de esta parte de la variable en Repetir para. En este ejemplo, la configuración adecuada para el campo Repetir para es event.extra.line_items.

Elige el alias de tu elemento

El alias del elemento puede ser cualquier texto que quieras usar (sin caracteres especiales ni espacios). Usarás este alias dentro del bloque repetido para identificar las variables que deben extraerse de la matriz que has seleccionado arriba. Elige un alias sencillo pero descriptivo para que sea fácil de recordar.

Por ejemplo, si tu bloque se repite en una lista de artículos en un carrito abandonado, item es un buen alias para usar. Si tu bloque se repite sobre una lista de entradas del blog, podrías usar post como alias.

Puedes usar el alias que quieras; solo asegúrate de usar ese alias de forma coherente en las variables de tu matriz (como se indica en los pasos siguientes).

Una vez que hayas completado los campos Repetir para y Alias del artículo, haz clic en Guardar y empieza a crear el contenido.

Crea tu bloque/sección repetidos

Una vez que hayas configurado Repetir para y Alias del elemento, añade etiquetas de personalización al bloque de contenido sobre el que se va a iterar. Puedes añadir cualquier tipo de variable a este bloque, incluidos datos de perfil y de evento, pero cualquier etiqueta que se extraiga de tu array (p. ej., la lista de artículos que alguien pidió) debe ajustarse ligeramente.

Las variables del título completo y del precio de la variante que se utilizaron en el ejemplo anterior fueron:

{{ event.extra.line_items.0.variant_price }}

{{ event.extra.line_items.0.title }}

Si añades las variables anteriores al bloque, este se repetirá una vez por cada elemento de tu matriz, pero cada repetición mostrará el título y el precio del primer elemento de la matriz.

Para mostrar el título y el precio de cada artículo, sustituye el texto de la configuración Repeat for (event.extra.line_items), además del punto y el número posteriores (.0), por tu Item alias (item). Las variables resultantes de este ejemplo son:

{{ item.variant_price }}

{{ item.title }}

Repite el proceso con cualquier otra variable que quieras incluir de la matriz.

Si el array contiene valores simples, como una lista de nombres de elementos, usa el alias por sí solo para mostrar cada valor. Por ejemplo, con item como Alias del elemento, usa {{ item }} en lugar de {{ item.title }}.

Vista previa del email y solución de problemas

Una vez que hayas creado el bloque repetido, previsualiza tu email. Si el email hace referencia a datos de eventos, selecciona el mismo evento que usaste para crear el bloque (es decir, el evento que activará este flujo). Si tu bloque hace referencia a datos del perfil, selecciona un perfil que tenga las variables correctas.

Si el bloque repetido en el email de vista previa aparece en blanco o no contiene todo el contenido que esperabas, vuelve a los pasos anteriores. Asegúrate de que Repetir para, Alias del artículo y todas las variables personalizadas estén configuradas correctamente siguiendo los pasos anteriores. Después, revisa los datos de vista previa que estás usando: asegúrate de que has seleccionado el evento o el perfil correctos y de que la muestra que has elegido contiene los datos que necesitas.

Recursos adicionales

• Referencia de personalización de mensajes
• Guía sobre el editor de plantillas de email