Como usar o painel de visualização para personalizar mensagens

O que você vai aprender

Saiba como usar o painel de visualização para entender os dados de personalização disponíveis para suas mensagens e como acessar tags de modelo. Use o modal de visualização como sua fonte de verdade para opções de personalização.

Painel de pré-visualização para modelos, campanhas e fluxos

Abra o painel de pré-visualização de qualquer mensagem clicando em Pré-visualizar e testar. Aqui, você tem a opção de escolher sua fonte de dados. Dependendo de onde a mensagem estiver, você terá opções um pouco diferentes.

Modelos

Se você editar um modelo acessando Conteúdo > Modelos, poderá alternar entre os dados de perfil e de evento. Para dados de perfil, você pode selecionar um perfil específico. Para dados de evento, você pode selecionar um evento específico.

Campanhas

Se você editar uma mensagem de campanha, terá acesso apenas à personalização de perfil, não à personalização de evento. Os dados de evento não são compatíveis com campanhas, porque as campanhas não podem ser associadas a um evento específico.

Fluxos

Se você editar uma mensagem que faz parte de um fluxo acionado por uma métrica, queda de preço, estoque baixo ou reposição de estoque, o painel de visualização incluirá tags de personalização de perfil e de evento. A personalização de perfil é compatível com todos os fluxos; use o botão Adicionar personalização em um bloco de texto para adicionar essas tags.

Selecionar um perfil para visualizar

Ao revisar as opções de personalização de perfil no modal de pré-visualização, o perfil padrão é o perfil de usuário associado ao seu login da Klaviyo. Observe que isso é diferente do perfil do seu e-mail na sua própria conta da Klaviyo e tem um conjunto muito limitado de opções de tags de personalização, como nome e sobrenome.

Para ver todos os dados disponíveis em uma conta de cliente real, selecione outro perfil.

Saiba como alterar o perfil de pré-visualização para diferentes mensagens:

• Modelos, campanhas e mensagens de fluxo (não acionadas por evento)
  Use o campo Pesquisar perfis no modal de visualização.
  

• Mensagens de fluxo disparadas por evento
  Os dados de perfil nas mensagens de fluxo disparadas por evento vêm dos perfis que mais recentemente realizaram a ação de disparo. Use as setas para alternar entre até 10 eventos recentes e selecione o perfil associado.
  

Escolha um evento para visualizar

Ao editar um e-mail navegando até Conteúdo > Modelos, você tem a opção de selecionar um evento para visualizar. Ao editar uma mensagem de fluxo acionada por evento, o evento é selecionado automaticamente.

Em ambos os cenários, você pode alternar entre as últimas 10 instâncias do evento para escolher uma para visualizar na prévia como. Use as setas para navegar por elas até encontrar uma que você queira usar para a prévia.

Tags básicas de personalização

Depois de selecionar um perfil ou evento para pré-visualizar, passe o cursor sobre qualquer dado para ver a tag de personalização. Clique para copiá-la para a área de transferência e depois cole-a na sua mensagem.

Essas tags podem ser usadas como estão ou você pode usar filtros para ajustar como elas são exibidas. Cada variável que você copia do modal de pré-visualização inclui o filtro padrão, |default:''. Você pode excluir esse filtro, deixá-lo como está ou preenchê-lo para definir um valor padrão. Os valores padrão aparecem quando não há dados disponíveis para um determinado destinatário. Se você não definir um valor padrão, a variável não será exibida se os dados não estiverem disponíveis.

Tags de personalização avançadas

Se você estiver analisando dados de eventos, pode haver uma quantidade enorme para analisar. Os eventos costumam conter uma grande quantidade de metadados, que são informações sobre a ação que alguém realizou para acionar o evento.

Geralmente, parte desses dados é “aninhada”, o que significa que ela é armazenada dentro de outra variável. Os dados aninhados são usados para organizar informações relacionadas.

O evento Pedido Realizado é um evento que usa dados aninhados. Os metadados do evento provavelmente incluem detalhes sobre a pessoa que fez o pedido, além dos itens que ela pediu. Confira um exemplo de alguns dos dados que você pode ver:

• Endereço
  Os detalhes de endereço do cliente ficam aninhados no cabeçalho shipping_address, que contém o endereço, a cidade, o estado e o país.
  

• Produtos comprados
  Os itens que a pessoa comprou estão listados sob o título line_items. Imediatamente abaixo do título line_items há outro título, 0. Dentro do título 0 estão os detalhes sobre o primeiro produto solicitado. Se você rolar mais para baixo, talvez veja um segundo título, 1, que representa o segundo item solicitado. Em dados numerados como esse, a estrutura de cada entrada geralmente é a mesma, mas cada entrada conterá detalhes sobre um item diferente (por exemplo, um produto no pedido).
  

Os dados aninhados são indicados por um pequeno ícone de seta. Clique nesse ícone para recolher uma entrada e ocultar o conteúdo dela, para facilitar a navegação pelos dados.

A tag de personalização sempre representa o caminho que você usa para encontrá-la nos dados. Por exemplo, uma variável de evento não aninhada seguirá uma estrutura como esta: {{ event.source }}. No entanto, uma variável aninhada encontrada navegando até extra > customer > default_address > address1 teria esta aparência: {{ event.extra.customer.default_address.address1 }}.

Iteração em variáveis aninhadas

Se você selecionar uma variável que contém um número, como {{ event.extra.line_items.0.product.title }}, isso significa que é possível iterar por cada item na lista. Você pode iterar pelos itens da lista com um loop for, uma repetição de conteúdo ou um bloco de tabela dinâmica.

Se você optar por não usar uma dessas ferramentas de iteração, certifique-se de sempre usar o primeiro item de uma lista, já que alguns destinatários podem ter apenas um item. Você pode saber se uma variável faz referência ao primeiro item da lista conferindo o número na própria variável:

• {{ event.extra.line_items.0.product.title }} é a variável do título do primeiro item de um pedido.
• {{ event.extra.line_items.1.product.title }} é a variável para o título do segundo item em um pedido.
• {{ event.extra.line_items.2.product.title }} é a variável do título do terceiro item em um pedido.

Resultado

Depois de ler este artigo e testar estas etapas na sua própria conta, você vai entender como navegar no modal de prévia e encontrar os dados de personalização de que precisa para suas mensagens.

Recursos adicionais