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

Qué aprenderás

Descubre cómo usar la función de repetición de bloques para una sección o un bloque en una plantilla de Klaviyo Email. Esta función te permite repetir el contenido de un bloque o sección para cada entrada de una matriz (es decir, una lista) de datos del evento o de los datos del perfil de un destinatario, 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.).

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, ve a la sección o el bloque que quieras repetir y, luego, haz clic en Opciones de visualización. En la sección Content Repeat, haz clic en Crear repetición de contenido.

Verás que aparecen dos campos: Repetir para y Alias del elemento. Para completar 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»

Añade el nombre de la matriz que piensas iterar al campo Repetir para.

Para encontrar el nombre de tu matriz, consulta los datos de tu fuente de datos (es decir, datos del perfil, datos del evento o un feed de datos). En este ejemplo, veremos cómo encontrar la matriz a partir de los datos del evento:

1. En tu plantilla de email, haz clic en Previsualizar y probar.
2. Haz clic en Evento.
3. Selecciona el evento que activará este email de flujo (p. ej., Started Checkout).
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.
5. En este ejemplo, hay dos matrices que almacenan información sobre el artículo:
6. En este caso, te convendría usar la matriz más detallada, line_items, ya que contiene la información detallada necesaria para mostrar en el bloque repetido. Para encontrar la variable adecuada que establecer en el campo Repeat for, busca dos variables dentro de la primera sección de la matriz y cópialas. En este ejemplo, copiaremos las variables de variant_price y title. Aquí tienes las dos etiquetas que copiamos:
7. {{ event.extra.line_items.0.variant_price }}
8. {{ event.extra.line_items.0.title }}

• Artículos
  Una matriz de nivel superior que contiene una lista simple del nombre de cada artículo, pero sin ninguna otra información
• Line_items
  Anidado dentro de la matriz extra, e incluye más detalles, como el título, el precio, el SKU y la URL de la imagen de cada artículo.
  

9. Ignora las llaves y fíjate en las variables que contienen. Ten en cuenta que el comienzo de ambas variables es el mismo: event.extra.line_items.0.
10. Usa todo hasta el punto (pero sin incluirlo) y el número al final de esta parte de la variable como tu opción Repetir para. En este ejemplo, el ajuste adecuado 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 rellenado los campos Repetir para y Alias de elemento, haz clic en Guardar cambios y empieza a crear tu contenido.

Crea tu bloque/sección repetidos

Cuando hayas configurado tus ajustes de Repetir para y Alias del elemento, añade etiquetas de personalización al bloque de contenido para iterar. Puedes añadir cualquier tipo de variable a este bloque, incluidos datos de perfil y de eventos, pero cualquier etiqueta que se extraiga de tu matriz (p. ej., la lista de artículos que alguien ha pedido) 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 Repetir para (event.extra.line_items), además del punto y el número posteriores (.0), por tu Alias del artículo (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.

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 de tu email de vista previa aparece en blanco o no contiene todo el contenido que esperabas, vuelve a los pasos anteriores. Asegúrate de que Repeat for, Item alias y todas las variables personalizadas estén correctamente configuradas siguiendo los pasos anteriores. Después, revisa los datos de vista previa que estás usando: asegúrate de que has seleccionado el evento correcto y de que el evento de ejemplo 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