Qué aprenderás
Aprenda a utilizar la función de repetición de bloque para una sección o un bloque en una plantilla de correo electrónico de Klaviyo. Esta función le permite repetir el contenido de un bloque o sección para cada entrada de una matriz (es decir, una lista) de datos procedentes de los datos de eventos o perfiles de un destinatario, o de una fuente de datos.
Antes de empezarAntes de empezar
Si no está familiarizado con el uso de datos de eventos, perfiles o catálogos en los correos electrónicos, consulte nuestra referencia de personalización de mensajes como primer paso.
También será útil comprender los tipos de datos en Klaviyo, en particular las listas (es decir, las matrices). Una matriz almacena varios datos estructurados de la misma manera. Por ejemplo, los artículos comprados por un cliente se almacenan como una matriz dentro de un evento Pedido realizado. La matriz de artículos contiene 1 entrada por artículo pedido, y cada entrada contiene los detalles de 1 artículo (por ejemplo, nombre del artículo, URL de la imagen, cantidad, talla, color, etc.).
Casos de uso de la función de repetición de contenidosCasos de uso de la función de repetición de contenidos
Para utilizar la función de repetición de contenido, necesitará una matriz o lista de datos. La tabla siguiente enumera algunos ejemplos de matrices de datos que pueden existir en su cuenta de Klaviyo, junto con ejemplos de casos de uso.
Fuente de datos |
Ejemplo de caso de uso |
La matriz de artículos pedidos en un evento Pedido realizado |
Muestre los artículos comprados por un cliente (incluyendo una imagen del producto, el precio, el título y la información sobre la variante) en su correo electrónico de confirmación del pedido. |
Una lista de las suscripciones existentes para alguien suscrito a pedidos recurrentes |
Mostrar a un cliente una lista de sus suscripciones activas en una campaña. |
Una lista de entradas de blog recientes de un feed web personalizado |
Proporcione una lista actualizada de las entradas más recientes de su blog en su flujo de bienvenida, incluyendo un enlace a la entrada del blog y una vista previa de su contenido. |
Puede utilizar la función de repetición de contenidos con cualquier matriz, ya esté almacenada en el perfil de un suscriptor o en los datos de un evento, o en uno de sus feeds web. Los ejemplos anteriores son sólo una pequeña muestra de cómo puede utilizarse esta función.
Cómo utilizar la función de repetición de contenidosCómo utilizar la función de repetición de contenidos
Para activar la función de repetición de contenidos, navegue hasta la sección o bloque que desee repetir y, a continuación, haga clic en Opciones de visualización. En la sección Repetición de contenidos, haga clic en Crear repetición de contenidos.
Verá que aparecen dos campos: Repetir para y Alias del artículo. Para rellenar estos campos y configurar sus contenidos repetidos, siga los pasos que se indican a continuación:
- Identifique su "repita para"
- Elija su "alias de artículo"
- Construya su contenido repetitivo
- Vista previa de su correo electrónico
Identifique su "repita para"
Añada el nombre de la matriz sobre la que piensa iterar al campo Repetir para.
Para encontrar el nombre de su matriz, consulte los datos de su fuente de datos (es decir, datos de perfil, datos de eventos o un feed de datos). En este ejemplo, recorreremos la búsqueda de la matriz a partir de los datos de eventos:
- En su plantilla de correo electrónico, haga clic en Vista previa y pruebe.
- Haga clic en Evento.
- Seleccione el evento que desencadenará este flujo de correo electrónico (por ejemplo, Pago iniciado).
- Desplácese por los datos de la vista previa de su evento hasta que encuentre una matriz que contenga la información que necesita. Puede utilizar los iconos de flecha situados a la izquierda de los datos para contraer las secciones que no necesite y facilitar la navegación.
En este ejemplo, hay dos matrices que almacenan información sobre los artículos:
-
Elementos
Un array de nivel superior y contiene una lista simple con el nombre de cada elemento, pero ninguna otra información -
Artículos_de_línea
Anidada dentro de la matriz extra, y contiene más detalles incluyendo el título, precio, SKU y URL de la imagen de cada artículo.
En este caso, querrá utilizar la matriz más detallada, line_items, ya que contiene la información detallada necesaria para mostrar en el bloque de repetición. Para encontrar la variable adecuada para establecer en el campo Repetir para, busque dos variables dentro de la primera sección de la matriz y cópielas. En este ejemplo, copiaremos las variables para variant_price y title. Aquí están las dos etiquetas que copiamos:
{{ event.extra.line_items.0.variant_price }}
{{ event.extra.line_items.0.title }}
-
Elementos
-
Ignore las llaves y fíjese en las variables que contienen. Observe que el comienzo de ambas variables es el mismo:
event.extra.line_items.0
.Utilice todo hasta (pero excluyendo) el punto y el número al final de esta parte de la variable como su Repetición para. En este ejemplo, el ajuste apropiado para el campo Repetir para es
event.extra.line_items
.
Elija su alias de artículo
El alias de su artículo puede ser cualquier texto que desee utilizar (sin caracteres especiales ni espacios). Utilizará este alias dentro de su bloque de repetición para identificar las variables que deben extraerse de la matriz que seleccionó anteriormente. Elija un alias sencillo pero descriptivo, para que sea fácil de recordar.
Por ejemplo, si su bloque se repite sobre una lista de artículos de un carro abandonado, item es un buen alias para utilizar. Si su bloque se repite sobre una lista de entradas de blog, entonces podría utilizar post como alias.
Puede utilizar cualquier alias que desee; sólo asegúrese de utilizar sistemáticamente ese alias en las variables de su matriz (como se indica en los pasos siguientes).
Una vez que haya rellenado los campos Repetir para y Alias del artículo, haga clic en Guardar cambios y comience a crear su contenido.
Construya su bloque/sección de repeticiónConstruya su bloque/sección de repetición
Una vez que haya establecido los ajustes de Repetir para y Alias de artículo, añada etiquetas de personalización al bloque de contenido para iterar sobre ellas. Puede añadir cualquier tipo de variable a este bloque, incluidos datos de perfiles y eventos, pero las etiquetas que se extraigan de su matriz (por ejemplo, la lista de artículos que alguien pidió) deben ajustarse ligeramente.
Las variables de título completo y precio variante utilizadas en el ejemplo anterior fueron:
{{ event.extra.line_items.0.variant_price }}
{{ event.extra.line_items.0.title }}
Si añade las variables anteriores al bloque, éste se repetirá una vez por cada artículo de su matriz, pero cada repetición mostrará el título y el precio del primer artículo de la matriz.
Para mostrar el título y el precio de cada artículo, sustituya el texto del ajuste Repetir para (event.extra.line_items
), más el punto y el número subsiguientes (.0
) con su alias de artículo(item
). Las variables resultantes para este ejemplo son:
{{ item.variant_price }}
{{ item.title }}
Repita el proceso con cualquier otra variable que desee incluir de la matriz.
Todo lo que haya en el bloque o sección con la función de repetición de bloque activada se repetirá una vez por cada elemento de la matriz. Si tiene algún contenido que desea que aparezca sólo una vez, añádalo en un bloque o sección diferente.
Además, las variables personalizadas creadas a través de este proceso (por ejemplo, {{ item.title
}}
) sólo funcionan dentro del bloque o sección en el que está habilitada la sección de repetición de bloque. Si añade estas variables personalizadas en otro lugar, no se renderizarán.
Vista previa de su correo electrónico y solución de problemas
Una vez que haya construido su bloque de repetición, previsualice su correo electrónico. Si el correo electrónico hace referencia a datos de eventos, seleccione el mismo evento que utilizó para construir el bloque (es decir, el evento que desencadenará este flujo). Si su bloque hace referencia a datos de perfil, seleccione un perfil que tenga las variables correctas.
Si el bloque de repetición de su correo electrónico de previsualización aparece en blanco o no contiene todo el contenido que esperaba, vuelva a los pasos anteriores. Asegúrese de que su Repetición para, Alias de artículo y todas las variables personalizadas están correctamente configuradas siguiendo los pasos anteriores. A continuación, revise los datos de muestra que está utilizando: asegúrese de que ha seleccionado el evento correcto y de que el evento de muestra que ha elegido contiene los datos que necesita.
Recursos adicionalesRecursos adicionales