Como criar blocos dinâmicos em um e-mail de fluxo

O que você vai aprender

Saiba como usar blocos de tabelas dinâmicas para adicionar informações sobre produtos e outros eventos aos seus fluxos acionados por métricas. Neste artigo, o senhor aprenderá a criar um bloco dinâmico usando o exemplo de um lembrete de carrinho abandonado que mostra os produtos que foram deixados para trás.

Se o senhor usar uma das integrações de comércio eletrônico pré-construídas do Klaviyo (por exemplo, Shopify, BigCommerce, Magento ou WooCommerce), não precisará criar esses blocos manualmente. Em vez disso, use a biblioteca de fluxos para encontrar e-mails de fluxo pré-construídos e totalmente funcionais para usar como modelos. 

Em um fluxo acionado por métricas, o senhor pode personalizar o conteúdo de seus e-mails com base no evento que aciona o fluxo. Por exemplo, se alguém iniciar um checkout, o senhor pode incluir imagens e preços de produtos em um e-mail de carrinho abandonado para incentivar os destinatários a retornar ao carrinho e concluir a compra. O bloco de tabela dinâmica será repetido automaticamente com as informações especificadas para cada item do carrinho.

Antes de começar

Antes de começar, certifique-se de que o senhor tenha dados de eventos para usar. Navegue até Analytics > Metrics para verificar se o evento existe no Klaviyo.

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

Também será útil entender os tipos de dados no Klaviyo, especialmente as listas (ou seja, matrizes). Uma matriz é uma forma de armazenar vários dados estruturados da mesma maneira. Por exemplo, os itens do carrinho de um cliente são armazenados como uma matriz em um evento Checkout Started. O array de itens contém uma entrada por item pedido, e cada entrada contém os detalhes desse item (por exemplo, nome do item, URL da imagem, quantidade, tamanho, cor etc.). 

Que tipos de fluxos podem usar blocos de tabela dinâmicos? 

Os blocos de tabelas dinâmicas contêm informações sobre um ou mais produtos com os quais o cliente interagiu de alguma forma (por exemplo, comprou ou deixou no carrinho). Esses blocos de tabela são úteis para eventos que podem conter diferentes números de produtos, dependendo da ação de um cliente. Os blocos de tabelas dinâmicas são úteis para fluxos acionados por esses eventos: 

• Ordem colocada (fluxo de confirmação da ordem)
• Finalização de compra iniciada (fluxo de carrinho abandonado) 
• Pedido atendido (fluxo de confirmação de envio) 
• Pedido cancelado (confirmação de cancelamento) 
• Quaisquer outros eventos que contenham uma lista de um ou mais produtos

Os blocos de tabelas dinâmicas não são úteis se o evento sempre contiver um único produto. Os eventos abaixo requerem blocos de tabelas estáticas. 

• Adicionado ao carrinho (finalização abandonada do fluxo de compra)
• Produto visualizado (fluxo de abandono de navegação) 

Saiba como criar um bloco de tabela estática para eventos de produto único. 

1. Crie seu fluxo

Comece criando seu fluxo:

1. Navegue até a guia Flows (Fluxos ) no Klaviyo.
2. Clique em Create flow (Criar fluxo). 
3. Clique em Build your own. 
4. Dê um nome ao seu fluxo e clique em Create flow (Criar fluxo). 
5. Em Select a trigger (Selecionar um acionador), clique em Your métrica (Sua métrica). 
6. Selecione de quais integrações a sua métrica de acionamento é enviada (por exemplo, Shopify).
7. Escolha o evento que deve acionar seu fluxo. Neste exemplo, usaremos o evento Checkout Started. Isso garante que tenhamos acesso aos dados de eventos necessários para construir um bloco de carrinho abandonado.
8. Clique em Done (Concluído). 
9. Arraste e solte uma ação de e-mail no fluxo.

2. Adicione uma tabela dinâmica ao seu fluxo E-mail

Em seguida, adicione uma tabela dinâmica ao seu fluxo E-mail:

1. Clique no bloco de e-mail que adicionou ao seu fluxo na última seção. 
2. Ao lado de modelo, clique em Select modelo. 
3. Escolha um modelo para usar como base.
4. Arraste um bloco de tabela para seu e-mail.
5. Clique em Styles > Dynamic para converter a tabela em um bloco dinâmico. O senhor verá dois campos aparecerem: Row Collection e Row alias, que o senhor preencherá nas etapas 3 e 4.
6. Clique novamente na guia Content (Conteúdo ) para ajustar os tipos de coluna.
7. Em geral, uma mensagem de carrinho abandonado mostra imagens dos itens abandonados à esquerda e detalhes sobre o item à direita. Clique no seletor de linha à esquerda ou à direita e, em seguida, clique em Texto ou Imagem para alterar o tipo de célula.
   

3. Identifique sua coleção de linhas

Nesta etapa, o senhor adicionará o nome da matriz que pretende iterar ao campo de coleção Row. Para encontrar o nome de sua matriz:

1. Clique em Preview & test.
2. Percorra os dados de visualização do seu evento até encontrar uma matriz que contenha as informações de que o senhor precisa. 
   Se ninguém tiver concluído a ação de acionamento do fluxo ainda, não haverá dados de visualização disponíveis para o fluxo. O usuário pode navegar até seu site para realizar a ação (por exemplo, adicionar itens ao carrinho e iniciar um checkout) e, em seguida, seu evento será exibido nas opções de visualização do Klaviyo.
   
   Neste exemplo, há duas matrizes que armazenam informações sobre o item: 
   
   • Itens
     Uma matriz de nível superior que contém uma lista simples com o nome de cada item.
   • line_items,
     Uma matriz aninhada dentro da matriz extra que contém mais detalhes, incluindo o título, o preço, a SKU e o URL da imagem de cada item.
     

   O senhor deve usar o array mais detalhado, line_items, pois ele contém as informações detalhadas necessárias para exibição no bloco da tabela de repetição. Para encontrar a variável apropriada a ser definida no campo de coleta Row, selecione duas variáveis na primeira seção da matriz e copie-as. Neste exemplo, copie as tags de variant_price e title. Aqui estão as duas tags desse exemplo: 

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

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

3. 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. 

4. Use tudo até (mas excluindo) o ponto e o número no final dessa parte da variável como sua coleção de linhas. Neste exemplo, a configuração apropriada para o campo de coleta Row é event.extra.line_items.

Definir conteúdo de fallback (opcional)

O conteúdo de fallback aparecerá se não houver dados na coleção de linhas que o senhor selecionar. Isso só é necessário quando o senhor cria uma tabela com base em dados que não aparecem consistentemente no evento de acionamento. Para adicionar conteúdo de fallback, alterne a opção Conteúdo de fallback e adicione conteúdo (ou seja, texto ou uma imagem) ao campo exibido. 

4. Escolha um alias de linha

Seu alias de linha pode ser qualquer texto que o senhor queira usar (sem caracteres especiais ou espaços). O senhor usará esse alias no bloco da tabela dinâmica para identificar as variáveis que devem ser extraídas da matriz selecionada acima. É útil escolher um alias simples, mas descritivo, para que seja fácil de lembrar. 

Neste exemplo, o bloco de tabela dinâmica se repete em uma lista de itens em um carrinho abandonado, portanto, item é um bom alias a ser usado. Se o bloco se repetir em uma lista de posts 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 Row Collection e Row Alias, o senhor está pronto para começar a criar sua tabela. 

5. Adicionar detalhes dinâmicos do produto

Depois que a fonte de dados estiver configurada, o senhor poderá usar tags para adicionar texto ao seu e-mail. Como esse e-mail é para um fluxo de carrinho abandonado, é importante mostrar o nome do produto deixado para trás, juntamente com outros detalhes, como preço e link para compra.

Para inserir o título do produto em seu bloco:

1. Navegue até uma das colunas da tabela. Se quiser uma imagem na primeira coluna e o texto na segunda, clique no seletor de colunas à direita da seção Content (Conteúdo ) do bloco.
2. Cole a variável de evento completa do modal de visualização (por exemplo, {{ event.extra.line_items.0.title }}).
3. Substitua a coleção de linhas dentro da variável (ou seja, o texto que o senhor usou para a coleção Row) e o ponto e o número a seguir pelo alias selecionado na última etapa (por exemplo, item), mantendo os colchetes ao redor. Neste exemplo, {{ event.extra.line_items.0.title }} se torna {{ item.title }}.
   
4. Visualize o e-mail para garantir que o título seja exibido. Se não aparecer, verifique novamente a ortografia, a capitalização e a formatação do texto, bem como suas configurações na guia Styles (Estilos ), para garantir que não haja erros.

Repita as mesmas etapas para adicionar outros detalhes do item. 

Hiperlink para o título de um produto

Para adicionar um hiperlink ao título do produto: 

1. Encontre a variável URL do produto nos detalhes do evento.
2. Substitua a coleção de linhas e o número pelo seu alias de linha, como na variável acima (por exemplo, {{ event.extra.line_items.url }} torna-se {{ item.url }}). 
3. Destaque a variável completa do título do item (por exemplo, {{ item.title }}). 
4. Clique no ícone de link e cole sua variável de URL no campo URL.

Considerações sobre as variáveis monetárias

Se o preço do item for passado como um número nos detalhes do evento (sem símbolo de moeda), use a tag currency_format para aplicar a formatação da moeda. Para aplicar essa tag, substitua variable_name no código abaixo pela variável de preço completo, excluindo os colchetes da variável original: 

{% currency_format variable_name %}

Portanto, sua variável final pode ter a seguinte aparência: 

{% currency_format item.price %}

6. Adicionar uma imagem

Para inserir uma imagem dinâmica, localize a variável de evento da imagem no modal de visualização. Geralmente, essa variável é listada em image, img ou src, mas isso depende de sua integração. Aqui, ele está em src: {{ event.extra.line_items.0.product.images.0.src }}. Aplique os mesmos ajustes a essa variável conforme descrito na etapa cinco (substituindo event.extra.line_items.0 com item). Trata-se de uma matriz de variável de evento em event.extra.line_items, que contém as imagens para esse item específico.

1. Quando tiver essa variável, vá até a coluna em que deseja exibir a imagem (a coluna da esquerda, neste caso).
2. Clique em Image (Imagem ) abaixo de Cell content (Conteúdo da célula ) se estiver atualmente definido como Text (Texto).
3. Clique em Select image (Selecionar imagem).
4. Na guia Dynamic Image (Imagem dinâmica ), cole a variável da imagem no campo Dynamic variable (Variável dinâmica) ou dynamic URL (URL dinâmico ).
5. Insira a variável de evento de imagem personalizada, {{ item.product.images.0.src }}.
6. Clique em Salvar.
7. Adicione a variável URL do produto da etapa cinco no campo Link address (Endereço do link) para que a imagem seja clicável.
8. Defina uma largura máxima para a imagem, começando com 250-300 e ajustando conforme necessário.
9. Quando terminar de fazer as alterações, clique em Done (Concluído ) e visualize o e-mail para ter certeza de que ele aparece como esperado. Se uma imagem não for exibida, verifique a ortografia da variável em comparação com a do modal de visualização.

7. Visualizar seu e-mail

Após concluir as etapas acima, os modelos de e-mail devem ser semelhantes ao modelo abaixo quando visualizados.

Para ver como isso ficaria com conteúdo dinâmico e para garantir que os links funcionem corretamente, clique em Preview & test. Se houver algum erro, verifique a ortografia e a estrutura de suas variáveis, bem como a guia Styles (Estilos ) do bloco. 

O senhor pode usar esses mesmos conceitos para criar blocos dinâmicos adicionais para fluxos acionados com base em diferentes métricas.

Criar um bloco de tabela estática para eventos de produto único 

Se um evento só puder conter um único produto, use um bloco de tabela estático. Para esses eventos, não há necessidade de definir uma coleção Row ou um alias Row, e o senhor pode usar variáveis não editadas diretamente dos dados do evento. 

1. Navegue até a guia Flows (Fluxos ) no Klaviyo.
2. Clique em Create flow (Criar fluxo). 
3. Clique em Build your own. 
4. Dê um nome ao seu fluxo e clique em Create flow (Criar fluxo). 
5. Em Select a trigger (Selecionar um acionador), clique em Your métrica (Sua métrica). 
6. Escolha uma métrica de produto único, como Produto visualizado ou Adicionado ao carrinho. 
7. Clique em Done (Concluído). 
8. Arraste e solte uma ação de e-mail no fluxo.
9. Ao lado de modelo, clique em Select modelo. 
10. Selecione um modelo para usar como base.
11. Arraste um bloco de tabela para seu e-mail.
12. Por padrão, o campo dados é definido como Static em Styles; não altere essa configuração.
    
13. Clique em Preview & test para ver as variáveis disponíveis para sua mensagem. Clique na variável URL da imagem para copiá-la.
    
14. Usando os campos Cell selector e Cell conteúdo, defina a célula esquerda para usar o tipo de célula Image.
15. Clique em Select image (Selecionar imagem). 
16. Selecione Dynamic Image. 
17. Cole a variável de URL da imagem que o senhor copiou no campo Dynamic variable or dynamic URL (Variável dinâmica ou URL dinâmica ). 
18. Clique em Salvar. 
19. Defina a célula direita para usar o tipo de célula Text (Texto ). 
20. Copie as variáveis que deseja exibir (por exemplo, título do produto, preço do produto) e cole-as na célula de texto.
    
21. Adicione blocos adicionais, como um botão de CTA para retornar ao carrinho, e estilize o e-mail como desejar.
22. Quando terminar, clique em Exit (Sair).

Recursos adicionais

• Como criar um fluxo de carrinho abandonado
• Referência de personalização de mensagens
• Como exibir produtos verticalmente em e-mails
• Curso: Aplicar conceitos de lógica de programação para criar mensagens mais personalizadas