Como usar o recurso de repetição de conteúdo

O que você vai aprender

Saiba como usar o recurso de repetição de bloco em uma seção ou em um bloco em um modelo do Klaviyo Email. Esse recurso permite repetir o conteúdo de um bloco ou seção para cada entrada em uma matriz (ou seja, lista) de dados de um evento do destinatário ou dados de perfil, ou de um feed de dados.

Antes de começar

Se você não está familiarizado com o uso de dados de evento, perfil ou catálogo em e-mails, confira nossa referência de personalização de mensagens como primeiro passo.

Também será útil entender os tipos de dados no Klaviyo, principalmente listas (ou seja, arrays). Uma matriz armazena várias partes de dados que são estruturadas da mesma forma. Por exemplo, os itens comprados de um cliente são armazenados como uma matriz dentro de um evento Placed Order. A matriz de itens contém 1 entrada por item pedido, e cada entrada contém os detalhes de 1 item (por exemplo, nome do item, URL da imagem, quantidade, tamanho, cor etc.).

Casos de uso do recurso de repetição de conteúdo

Para usar o recurso de repetição de conteúdo, você vai precisar de um array ou uma lista de dados. A tabela abaixo lista alguns exemplos de arrays de dados que podem existir na sua conta da Klaviyo, junto com casos de uso de exemplo.

Você pode usar o recurso de repetição de conteúdo com qualquer matriz, seja ela armazenada no perfil de um assinante ou em dados de eventos, ou em um dos seus feeds da web. Os exemplos acima são apenas uma pequena amostra de como esse recurso pode ser usado.

Como usar o recurso de repetição de conteúdo

Para ativar o recurso de repetição de conteúdo, navegue até a seção ou o bloco que você gostaria de repetir e clique em Opções de exibição. Na seção Repetição de conteúdo, clique em Criar repetição de conteúdo.

Você verá dois campos aparecerem: Repetir por e Alias do item. Para preencher esses campos e configurar seu conteúdo recorrente, siga as etapas abaixo:

1. Identifique seu "repetir para"
2. Escolha seu "alias do item"
3. Crie seu conteúdo recorrente
4. Visualize seu e-mail

Identifique seu "repetir para"

Adicione o nome do array que você pretende iterar no campo Repetir para.

Para encontrar o nome do seu array, veja os dados da sua fonte de dados (ou seja, dados de perfil, dados de evento ou um feed de dados). Neste exemplo, vamos mostrar como encontrar o array nos dados de evento:

1. No seu modelo de e-mail, clique em Visualização e teste.
2. Clique em Evento.
3. Selecione o evento que vai acionar este e-mail de fluxo (ex.: Checkout iniciado).
4. Role pelos dados de visualização do seu evento até encontrar uma matriz que contenha as informações de que você precisa. Você pode usar os ícones de seta à esquerda dos dados para recolher as seções de que você não precisa e facilitar a navegação.
5. Neste exemplo, há duas matrizes que armazenam informações do item:
6. Nesse caso, você vai querer usar a matriz mais detalhada, line_items, já que ela contém as informações detalhadas necessárias para exibir no bloco de repetição. Para encontrar a variável apropriada para definir no campo Repetir para, encontre duas variáveis dentro da primeira seção da matriz e copie-as. Neste exemplo, vamos copiar as variáveis de variant_price e title. Aqui estão as duas tags que copiamos:
7. {{ event.extra.line_items.0.variant_price }}
8. {{ event.extra.line_items.0.title }}

• Itens
  Um array de nível superior que contém uma lista simples do nome de cada item, mas nenhuma outra informação
• Line_items
  Aninhado dentro da matriz extra e contém mais detalhes, incluindo o título, o preço, o SKU e a URL da imagem de cada item
  

9. Ignore as chaves e observe as variáveis dentro delas. Observe que o início de ambas as variáveis é o mesmo: event.extra.line_items.0.
10. Use tudo até (mas sem incluir) o ponto e o número no final desta parte da variável como seu Repetir para. Neste exemplo, a configuração apropriada para o campo Repetir para é event.extra.line_items.

Escolha o alias do seu item

O alias do item pode ser qualquer texto que você queira usar (sem caracteres especiais nem espaços). Você usará esse alias no seu bloco repetido para identificar as variáveis que devem ser extraídas da matriz selecionada acima. Escolha um alias simples, mas descritivo, para que seja fácil de lembrar.

Por exemplo, se seu bloco estiver se repetindo em uma lista de itens em um carrinho abandonado, item é um bom alias para usar. Se seu bloco estiver se repetindo em uma lista de posts do blog, então você pode usar post como seu alias.

Você pode usar qualquer alias que quiser; só garanta que use esse alias de forma consistente nas variáveis da sua matriz (conforme descrito nas etapas a seguir).

Depois de preencher os campos Repeat for e Item alias, clique em Salvar alterações e comece a criar seu conteúdo.

Crie seu bloco/seção recorrente

Depois de definir as configurações de Repetir para e Alias do item, adicione tags de personalização ao bloco de conteúdo para iterar. Você pode adicionar qualquer tipo de variável a este bloco, incluindo dados de perfil e de evento, mas quaisquer tags extraídas do seu array (por exemplo, a lista de itens que alguém pediu) devem ser ajustadas levemente.

As variáveis de título completo e preço da variante usadas no exemplo acima foram:

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

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

Se você adicionar as variáveis acima ao bloco, ele repetirá o bloco uma vez por item no seu array, mas cada repetição mostrará o título e o preço do primeiro item no array.

Para mostrar o título e o preço de cada item, substitua o texto da configuração Repetir para (event.extra.line_items), além do ponto e do número subsequentes (.0), pelo seu Alias do item (item). As variáveis resultantes para este exemplo são:

{{ item.variant_price }}

{{ item.title }}

Repita o processo com quaisquer outras variáveis que você queira incluir do array.

Visualize seu e-mail e solucione problemas

Depois de criar seu bloco de repetição, visualize seu e-mail. Se o e-mail fizer referência a dados de evento, selecione o mesmo evento que você usou para criar o bloco (isto é, o evento que acionará esse fluxo). Se o seu bloco fizer referência a dados de perfil, selecione um perfil que tenha as variáveis corretas.

Se o bloco repetido no seu e-mail de pré-visualização aparecer em branco ou não contiver todo o conteúdo que você esperava, volte às etapas acima. Verifique se Repeat for, Item alias e todas as variáveis personalizadas estão configuradas corretamente seguindo as etapas acima. Em seguida, revise os dados de prévia que você está usando: verifique se você selecionou o evento correto e se o evento de amostra que você escolheu contém os dados de que você precisa.

Recursos adicionais

• Referência de personalização de mensagens
• Guia do editor de modelos de e-mail