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

O que você vai aprender

Saiba como usar blocos de tabela dinâmica para adicionar informações de produtos e outros eventos aos seus fluxos acionados por métrica. Neste artigo, você vai 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 você usa uma das integrações de e-commerce pré-criadas do Klaviyo (por exemplo, Shopify, BigCommerce, Magento ou WooCommerce), não precisa criar esses blocos manualmente. Em vez disso, use a biblioteca de fluxos para encontrar e-mails de fluxo pré-criados e totalmente funcionais para usar como modelo.

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

This content requires Functional cookies to be enabled.

Update Cookie Settings

Antes de começar

Antes de começar, verifique se você tem dados de eventos para usar. Navegue até Análises > Métricas para confirmar que o evento existe no Klaviyo.

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

Também será útil entender os tipos de dados na Klaviyo, especialmente listas (isto é, matrizes). Uma matriz é uma forma de armazenar várias partes de dados que são estruturadas da mesma maneira. Por exemplo, os itens do carrinho de um cliente são armazenados como uma matriz em um evento Checkout Started. A matriz items 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 fluxo podem usar blocos de tabela dinâmicos?

Os blocos de tabela dinâmicos contêm informações sobre um ou mais produtos com os quais um 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 quantidades de produtos, dependendo de uma ação do cliente. Os blocos de tabela dinâmicos são úteis para fluxos acionados por estes eventos:

• Pedido realizado (fluxo de confirmação de pedido)
• Checkout iniciado (fluxo de checkout abandonado)
• Pedido processado (fluxo de confirmação de envio)
• Pedido cancelado (confirmação de cancelamento)
• Quaisquer outros eventos que contenham uma lista de um ou mais produtos

Use um bloco de tabela estática quando o evento fornecer os detalhes de um único produto, sem uma lista de produtos para repetir. Alguns exemplos incluem:

• Adicionado ao carrinho (fluxo de carrinho abandonado)
• Produto visualizado (fluxo de carrinho abandonado)

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 aba Fluxos na Klaviyo.
2. Clique em Criar fluxo.
3. Clique em Crie a sua.
4. Dê um nome ao seu fluxo e clique em Criar fluxo.
5. Em Selecione um disparador, clique em Suas métricas.
6. Selecione de qual integração sua métrica de acionamento é enviada (por exemplo, Shopify).
7. Escolha o evento que deve acionar seu fluxo. Neste exemplo, vamos usar o evento Checkout Started. Isso garante que temos acesso aos dados do evento necessários para criar um bloco de carrinho abandonado.
8. Clique em Salvar, revise seu acionador e clique em Confirmar e salvar.
9. Arraste e solte uma ação de E-mail no fluxo.

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

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

1. Clique no bloco de e-mail que você adicionou ao seu fluxo na última seção.
2. Ao lado de modelo, clique em Selecionar modelo.
3. Escolha um modelo para usar como base.
4. Arraste um bloco de tabela para o seu e-mail.
5. Clique em Styles > Dynamic para converter a tabela em um bloco dinâmico. Você verá 2 campos aparecerem: Coleção de linhas e Alias da linha, que você vai preencher nas etapas 3 e 4.
6. Clique de volta na guia Conteúdo para ajustar seus tipos de coluna.
7. Em geral, uma mensagem de carrinho abandonado mostra imagens dos itens abandonados à esquerda e detalhes sobre o item à direita. Em Seletor de célula, selecione a célula à esquerda ou à direita e clique em Texto ou Imagem em Conteúdo da célula para alterar o tipo de célula.

3. Identifique sua coleção de linhas

Nesta etapa, você vai adicionar o nome da matriz que pretende iterar no campo Coleção de linhas. Para encontrar o nome da sua matriz:

1. Clique em Visualizar.
2. Selecione um evento de exemplo que contenha dados do produto e, em seguida, role a visualização dos dados até encontrar um array que contenha as informações de que você precisa.
3. 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. Você pode navegar até o seu site para realizar a ação (por exemplo, adicionar itens ao carrinho e iniciar um checkout) e, em seguida, seu evento aparecerá nas opções de visualização da Klaviyo.
4. Neste exemplo do Shopify, há 2 arrays que armazenam informações de itens:

• Itens
  Uma matriz de nível superior que contém uma lista simples do nome de cada item.
• line_items
  Uma matriz aninhada no objeto extra que contém mais detalhes, incluindo o título, o preço, o SKU e o URL da imagem de cada item.
  

1. Você vai querer usar o array mais detalhado, line_items, já que ele contém as informações detalhadas necessárias para exibir no bloco de tabela repetida. Para encontrar a variável apropriada para definir no campo Row collection, selecione 2 variáveis na primeira seção do array e copie-as. Neste exemplo, copie as tags de price e title. Veja as 2 tags deste exemplo:
2. {{ event.extra.line_items.0.price }}
3. {{ event.extra.line_items.0.title }}

4. 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.
5. Use tudo antes de .0 como sua Coleção de linhas. Neste exemplo, o valor é event.extra.line_items. Feche a prévia, volte para a aba Estilos da tabela e insira esse valor em Coleção de linhas sem chaves.

Defina o conteúdo alternativo (opcional)

O conteúdo de fallback será exibido se não houver dados na coleção de linhas selecionada. Isso só é necessário quando você cria uma tabela com base em dados que não aparecem de forma consistente no evento de acionamento. Para adicionar conteúdo de fallback, ative 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 você queira usar (sem caracteres especiais ou espaços). Você vai usar esse alias no seu bloco de tabela dinâmica para identificar variáveis que devem ser obtidas do array que você selecionou acima. É útil escolher um alias simples, mas descritivo, para ficar fácil de lembrar.

Neste exemplo, o bloco de tabela dinâmica se repete em uma lista de itens em um carrinho abandonado, então item é um bom alias para usar. Se o seu bloco se repetir 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 Row collection e Row alias, você está pronto para começar a criar sua tabela.

5. Adicionar detalhes dinâmicos do produto

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

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

1. Na guia Conteúdo da tabela, selecione a célula em Seletor de célula onde você quer incluir os detalhes do produto. Para uma imagem à esquerda e texto à direita, selecione a célula da direita.
2. Clique duas vezes na célula de texto do seu e-mail e cole a variável completa do evento a partir do modal de pré-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 você usou para a Coleção de linhas) e o ponto e número seguintes pelo alias selecionado na última etapa (por exemplo, item), mantendo os colchetes ao redor. Neste exemplo, {{ event.extra.line_items.0.title  }} vira {{ item.title }}.
   

4. Visualize o e-mail para garantir que o título seja exibido. Se ele não aparecer, verifique novamente a grafia, as letras maiúsculas/minúsculas e a formatação do texto, bem como suas configurações na guia Estilos, para garantir que não haja erros.

Repita as mesmas etapas para adicionar detalhes adicionais do item.

Criar um hiperlink no título de um produto

Para adicionar um hyperlink ao título do produto:

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

Considerações sobre variáveis de moeda

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

{% currency_format variable_name %}

Assim, sua variável final pode ficar assim:

{% currency_format item.price %}

6. Adicionar uma imagem

Para inserir uma imagem dinâmica, encontre a variável de evento da imagem na prévia. Muitas vezes, essa variável aparece em image, img ou src, mas isso depende da sua integração. Neste exemplo, é {{ event.extra.line_items.0.product.images.0.src }}. Substitua event.extra.line_items.0 por item, como na etapa 5. Mantenha .0 após images: ele seleciona a primeira imagem de cada produto.

1. Quando você tiver essa variável, vá até a coluna em que você quer exibir a imagem (a coluna da esquerda, neste caso).
2. Clique em Imagem em Conteúdo da célula se no momento estiver definido como Texto.
3. Clique em Selecionar imagem.
4. Selecione a guia Imagem dinâmica.
5. Cole a variável de imagem personalizada {{ item.product.images.0.src }} no campo Variável dinâmica ou URL dinâmica.
6. Clique em Save.
7. Adicione a variável de URL do produto da etapa cinco no campo Endereço do link para que a imagem seja clicável.
8. Defina a largura máxima da imagem, começando com 250–300 pixels e ajustando conforme necessário.

7. Visualize seu e-mail

Depois de concluir as etapas acima, ao pré-visualizar o modelo de e-mail, ele deve ficar parecido com o exemplo abaixo.

Clique em Prévia e selecione um evento de amostra com vários produtos, se houver um disponível. Verifique se a imagem, os detalhes e os links de cada produto correspondem. Se estiver faltando uma imagem ou outro detalhe, verifique a ortografia e a estrutura das suas variáveis em relação aos dados da prévia, bem como a aba Estilos do seu bloco.

Quando terminar, feche a prévia e clique em Sair. Antes de ativar um fluxo de carrinho abandonado, conclua a configuração de tempo e filtros em nosso guia do fluxo de carrinho abandonado.

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

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

Se um evento fornecer os detalhes de um único produto sem uma lista de produtos, use um bloco de tabela estática. Para esses eventos, não é necessário configurar uma coleção de linhas ou um alias de linha, e você pode usar variáveis sem edição diretamente dos dados do seu evento.

1. Navegue até a aba Fluxos na Klaviyo.
2. Clique em Criar fluxo.
3. Clique em Crie a sua.
4. Dê um nome ao seu fluxo e clique em Criar fluxo.
5. Em Selecione um disparador, clique em Suas métricas.
6. Selecione a integração que envia sua métrica e, em seguida, escolha uma métrica de produto único, como Viewed Product ou Added to Cart.
7. Clique em Salvar, revise seu acionador e clique em Confirmar e salvar.
8. Arraste e solte uma ação de E-mail no fluxo.
9. Clique no bloco de e-mail e, em seguida, clique em Selecionar modelo ao lado de Modelo.
10. Selecione um modelo para usar como base.
11. Arraste um bloco de tabela para o seu e-mail.
12. Por padrão, o campo Dados é definido como Estático em Estilos; não altere essa configuração.
    

13. Clique em Prévia para ver as variáveis disponíveis para a sua mensagem. Clique na variável de URL da imagem para copiá-la e depois feche a prévia.
    

14. Usando os campos Seletor de célula e Conteúdo da célula, defina a célula à esquerda para usar o tipo de célula Imagem.
15. Clique em Selecionar imagem.
16. Selecione Imagem dinâmica.
17. Cole a variável do URL da imagem que você copiou no campo Variável dinâmica ou URL dinâmico.
18. Clique em Save.
19. Defina a célula da direita para usar o tipo de célula Texto.
20. Clique em Pré-visualizar para copiar uma variável que você gostaria de exibir (por exemplo, título do produto ou preço do produto). Feche a pré-visualização e, em seguida, clique duas vezes na célula de texto do seu e-mail e cole a variável. Repita para qualquer outro detalhe que você queira adicionar.

21. Adicione blocos adicionais, como um botão de CTA para que a pessoa volte ao carrinho, e personalize o estilo do e-mail como quiser.
22. Clique em Prévia e confira a imagem, o texto e os links do produto usando um evento de exemplo para o disparador do seu fluxo.
23. Quando terminar, feche a pré-visualização e clique em Sair.

Recursos adicionais