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 para uma seção ou um bloco em um modelo de e-mail do Klaviyo. 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 ou perfil de destinatário, ou de um feed de dados.

Antes de começar

Se o senhor não estiver familiarizado com o uso de dados de eventos, perfis ou catálogos em e-mails, consulte nossa referência de personalização de mensagens como uma primeira etapa. 

Também será útil entender os tipos de dados no Klaviyo, principalmente as listas (ou seja, matrizes). Uma matriz armazena vários dados estruturados da mesma forma. Por exemplo, os itens comprados de um cliente são armazenados como uma matriz em 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 de recursos de repetição de conteúdo

Para usar o recurso de repetição de conteúdo, o senhor precisará de uma matriz ou lista de dados. A tabela abaixo lista alguns exemplos de matrizes de dados que podem existir em sua conta da Klaviyo, juntamente com exemplos de casos de uso. 

O senhor pode usar o recurso de repetição de conteúdo com qualquer matriz, seja ela armazenada no perfil de um assinante, em dados de eventos ou em um de 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 deseja repetir e clique em Display Options. Na seção Content Repeat (Repetição de conteúdo), clique em Create Content Repeat (Criar repetição de conteúdo). 

O senhor verá dois campos aparecerem: Repetir para e Alias do item. Para preencher esses campos e configurar seu conteúdo repetitivo, siga as etapas abaixo: 

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

Identifique seu "repetir para" 

Adicione o nome da matriz que o senhor planeja iterar ao campo Repeat for (Repetir para ).

Para encontrar o nome de sua matriz, visualize os dados de sua fonte de dados (ou seja, dados de perfil, dados de eventos ou um feed de dados). Neste exemplo, vamos encontrar a matriz a partir dos dados do evento: 

1. Em seu modelo de e-mail, clique em Preview and test (Visualizar e testar).
2. Clique em Event (Evento).
3. Selecione o evento que acionará esse e-mail de fluxo (por exemplo, Checkout iniciado).
4. Percorra os dados de visualização do seu evento até encontrar uma matriz que contenha as informações de que o senhor precisa. O senhor pode usar os ícones de seta à esquerda dos dados para recolher as seções desnecessárias e facilitar a navegação.
   

   Neste exemplo, há duas matrizes que armazenam informações de itens: 

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

   Nesse caso, o senhor deve usar o array mais detalhado, line_items, pois ele contém as informações detalhadas necessárias para serem exibidas no bloco de repetição. Para encontrar a variável apropriada a ser definida no campo Repeat for (Repetir para ), encontre duas variáveis na primeira seção da matriz e copie-as. Neste exemplo, copiaremos as variáveis de variant_price e title. Aqui estão as duas tags que copiamos: 

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

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

5. Ignore os colchetes e observe as variáveis dentro deles. Observe que o início de ambas as variáveis é o mesmo: event.extra.line_items.0. 

   Use tudo até (mas excluindo) o ponto e o número no final dessa parte da variável como sua repetição para. Neste exemplo, a configuração apropriada para o campo Repeat for (Repetir para ) é event.extra.line_items.

Escolha o alias do item

O alias do item pode ser qualquer texto que o senhor queira usar (sem caracteres especiais ou espaços). O senhor usará esse alias no seu bloco de repetição 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 o seu bloco estiver repetindo uma lista de itens em um carrinho abandonado, item é um bom alias a ser usado. Se o seu bloco estiver se repetindo em uma lista de publicações de blog, o senhor poderá usar post como alias.

O senhor pode usar qualquer alias que desejar; apenas certifique-se de usar esse alias de forma consistente nas variáveis do seu array (conforme descrito nas etapas a seguir). 

Depois de preencher os campos Repeat for (Repetir para ) e Item alias (Alias do item ), clique em Save Changes (Salvar alterações ) e comece a criar seu conteúdo. 

Crie seu bloco/seção de repetição

Depois de definir as configurações de Repeat for (Repetir para ) e Item alias (Alias de item ), adicione tags de personalização ao bloco de conteúdo para iterar. O senhor pode adicionar qualquer tipo de variável a esse bloco, inclusive dados de perfil e de eventos, mas todas as tags extraídas do seu array (por exemplo, a lista de itens que alguém pediu) devem ser ligeiramente ajustadas. 

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

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

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

Se o senhor adicionar as variáveis acima ao bloco, ele repetirá o bloco uma vez por item em sua matriz, mas cada repetição mostrará o título e o preço do primeiro item na matriz. 

Para mostrar o título e o preço de cada item, substitua o texto da configuração Repeat for (event.extra.line_items), mais o ponto e o número (.0) subsequentes com seu alias de Item(item). As variáveis resultantes para esse exemplo são: 

{{ item.variant_price }}

{{ item.title }}

Repita o processo com quaisquer outras variáveis que o senhor queira incluir na matriz. 

Visualizar seu e-mail e solucionar problemas

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

Se o bloco de repetição em seu e-mail de visualização aparecer em branco ou não contiver todo o conteúdo esperado, retorne às etapas acima. Certifique-se de que o Repeat for, o alias do Item e todas as variáveis personalizadas estejam configurados corretamente, seguindo as etapas acima. Em seguida, revise os dados de visualização que está usando: certifique-se de que selecionou o evento correto e que o evento de amostra escolhido contém os dados necessários. 

Recursos adicionais

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