Skip to content

Ferramentas do dashboard para personalização

Use as ferramentas do dashboard da Braze para inserir personalização com Liquid sem precisar escrever cada tag manualmente. O fluxo Adicionar Personalização cria a sintaxe correta para você, e o editor de Liquid ajuda a ler e estender modelos rapidamente.

Para regras de sintaxe Liquid, tags compatíveis e padrões avançados, consulte Usando Liquid e Tags de personalização compatíveis.

Adicionar Personalização em criadores e configurações

A ferramenta Adicionar Personalização aparece próxima a campos de texto com suporte a modelos em todo o dashboard, incluindo:

  • Etapas de Campanha e Canvas para canais que suportam Liquid no corpo ou nos cabeçalhos (por exemplo, e-mail, push, SMS, mensagens no app, Cartões de conteúdo e webhooks).
  • Editores de arrastar e soltar, onde o controle geralmente está na barra de ferramentas do bloco ou do editor. Por exemplo, em mensagens no app de arrastar e soltar, você pode selecionar Adicionar Personalização, escolher um tipo de personalização e então inserir o snippet gerado no seu conteúdo antes de pré-visualizar em Pré-visualização e teste. Para notas específicas de cada canal, consulte o artigo de arrastar e soltar ou do criador do seu canal (como Configurações de estilo de mensagens no app ou Criar um e-mail com arrastar e soltar).
  • Criadores especializados que expõem um seletor de personalização — por exemplo, recomendações de itens usam opções de Tipo de Personalização como Recomendação de Item dentro do mesmo estilo de janela.
  • Landing pages, onde você pode adicionar personalização com Liquid no editor de arrastar e soltar ou nas configurações de página e bloco. Para mais detalhes, consulte Personalizar landing pages.

Inserir variáveis pré-formatadas e valores padrão

A ferramenta Adicionar Personalização ajuda você a inserir Liquid com valores padrão opcionais para que dados de perfil vazios não quebrem seu texto.

O modal Adicionar Personalização que aparece após selecionar inserir personalização. O modal possui campos para tipo de personalização, atributo, valor padrão opcional e exibe uma pré-visualização da sintaxe Liquid.

A ferramenta insere o Liquid com o valor padrão especificado no ponto onde seu cursor estava. O ponto de inserção também é indicado pela caixa de pré-visualização, que mostra o texto antes e depois. Se um bloco de texto estiver destacado, o texto destacado será substituído.

Um GIF do modal Adicionar Personalização mostrando o usuário inserindo "fellow traveler" como valor padrão, e o modal substituindo o texto destacado "name" no criador pelo snippet Liquid.

Você ainda pode digitar {{ em muitos criadores para usar o autocompletar, ou colar tags de outro lugar. Para mais detalhes, consulte Inserindo tags em Usando Liquid.

Atribuir variáveis

Algumas operações em Liquid exigem que você armazene o valor que deseja manipular como uma variável. Isso é comum quando sua instrução Liquid inclui múltiplos atributos, propriedades de eventos ou filtros.

Por exemplo, digamos que você queira somar dois inteiros de dados personalizados.

Exemplo incorreto de Liquid

Você não pode usar:

1
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}

Esse Liquid não funciona porque você não pode referenciar múltiplos atributos em uma única linha. É necessário atribuir uma variável a pelo menos um desses valores antes que as funções matemáticas sejam executadas. Somar dois atributos personalizados requer duas linhas de Liquid: uma para atribuir o atributo personalizado a uma variável e outra para realizar a adição.

Exemplo correto de Liquid

Você pode usar:

1
2
{% assign value_one = {{custom_attribute.${one}}} %}
{% assign result = value_one | plus: {{custom_attribute.${two}}} %}

Tutorial: usando variáveis para calcular um saldo

Vamos calcular o saldo atual de um usuário somando o saldo do cartão-presente com o saldo de recompensas:

Primeiro, use a tag assign para substituir o atributo personalizado current_rewards_balance pelo termo “balance”. Isso significa que agora você tem uma variável chamada balance, que pode ser manipulada.

1
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}

Em seguida, usaremos o filtro plus para combinar o saldo do cartão-presente de cada usuário com o saldo de recompensas, representado por {{balance}}.

1
2
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!

Melhorias do editor de Liquid

Esses comportamentos do dashboard facilitam o trabalho com Liquid enquanto você compõe mensagens.

Rótulos de cores

Cada elemento Liquid corresponde a uma cor, permitindo que você diferencie seu Liquid rapidamente no editor de Liquid.

Diagrama de vários rótulos de cores para diferentes elementos Liquid.

Liquid preditivo

Você também pode usar o Liquid preditivo para atributos personalizados, nomes de atributos e mais enquanto cria suas mensagens personalizadas.

A Braze recomendando diferentes atributos Liquid conforme mais texto é digitado em um campo.

Próximas etapas

New Stuff!