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

Blocos de tabela dinâmicos não são úteis se o evento sempre contiver um único produto. Em vez disso, os eventos abaixo exigem blocos de tabela estáticos.

• Adicionado ao carrinho (fluxo de checkout 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 Concluído.
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 Estilos > Dinâmico para converter a tabela em um bloco dinâmico. Você verá 2 campos aparecerem: Coleção de linhas e Alias da linha, que você 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. Clique no seletor da 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, 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 e testar.
2. Role pelos dados de visualização do seu evento 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, há 2 matrizes que armazenam informações do item:
5. 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 tabela repetida. Para encontrar a variável apropriada a ser definida no campo Row collection, selecione duas variáveis dentro da primeira seção da matriz e copie-as. Neste exemplo, copie as tag de variant_price e title. Aqui estão as duas tag deste exemplo:
6. {{ event.extra.line_items.0.variant_price }}
7. {{ event.extra.line_items.0.title }}

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

8. 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.
9. Use tudo até (mas excluindo) o ponto e o número no fim desta parte da variável como sua Row collection. Neste exemplo, a configuração apropriada para o campo Row collection é event.extra.line_items.

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. Navegue até uma das colunas da tabela. Se você quiser uma imagem na primeira coluna e o texto na segunda, clique no seletor de colunas à direita da seção Conteúdo do bloco.
2. Cole a variável completa do evento a partir do modal de prévia (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 coleta de linhas e o número pelo seu alias de linha, assim como na variável acima (por exemplo, {{ event.extra.line_items.url }} se torna {{ 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 sua variável de URL no campo URL.

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 no modal de pré-visualização. Muitas vezes, essa variável aparece como image, img ou src, mas isso depende das suas integrações. Aqui, ela 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 por item). Este é um array de variáveis de evento em event.extra.line_items, que contém as imagens deste item específico.

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. Na aba Imagem dinâmica, cole a variável da sua imagem no campo Variável dinâmica ou URL dinâmica.
5. Insira a variável de evento de imagem personalizada, {{ item.product.images.0.src }}.
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 uma largura máxima para a imagem, começando com 250–300 e ajustando conforme necessário.
9. Depois de terminar as alterações, clique em Concluído e visualize seu e-mail para garantir que ele apareça como esperado. Se uma imagem não aparecer, verifique a grafia da variável em relação à que aparece no modal de visualização.

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.

Para ver como isso ficaria com conteúdo dinâmico e garantir que os links funcionem corretamente, clique em Prévia e teste. Se houver erros, verifique a ortografia e a estrutura das suas variáveis, bem como a guia Estilos do seu bloco.

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 só puder conter um único produto, use um bloco de tabela estático. Para esses eventos, não é necessário definir uma Row collection ou um Row alias, e você pode usar variáveis não editadas 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. Escolha uma métrica de um único produto, como Produto visualizado ou Adicionado ao carrinho.
7. Clique em Concluído.
8. Arraste e solte uma ação de E-mail no fluxo.
9. Ao lado de modelo, clique em Selecionar 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 Visualizar e testar para ver as variáveis disponíveis para sua mensagem. Clique na variável de URL da imagem para copiá-la.
    

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. Copie todas as variáveis que você quer 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 que a pessoa volte ao carrinho, e personalize o estilo do e-mail como quiser.
22. Quando terminar, clique em Sair.

Recursos adicionais