Using Liquid

Este artigo mostrará como você pode usar uma variedade de atributos de usuário para inserir dinamicamente informações pessoais em suas mensagens.

Liquid é uma linguagem de modelo de código aberto desenvolvida pela Shopify e escrita em Ruby. Você pode usá-lo no Braze para extrair dados do perfil do usuário para suas mensagens e personalizar esses dados. Por exemplo, você pode usar Liquid tags para criar mensagens condicionais, como o envio de diferentes ofertas com base na data de aniversário da assinatura de um usuário. Além disso, os filtros podem manipular dados, como formatar a data de registro de um usuário a partir de um carimbo de data/hora em um formato mais legível, como “15 de janeiro de 2022”. Para obter mais detalhes sobre a sintaxe do Liquid e seus recursos, consulte Tags de personalização compatíveis.

Como funciona

As Liquid tags funcionam como espaços reservados em suas mensagens que podem extrair informações consentidas da conta do usuário e permitir a personalização e práticas de mensagens relevantes.

No bloco a seguir, você pode ver que há um uso duplo de uma tag Liquid para chamar o primeiro nome do usuário, bem como uma tag padrão no caso de um usuário não ter seu primeiro nome registrado.

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

Para um usuário chamado Janet Doe, a mensagem apareceria para o usuário como

1
Hi Janet, thanks for using the App!

Ou…

1
Hi Valued User, thanks for using the App!

Valores suportados para substituição

Os valores a seguir podem ser substituídos em uma mensagem, dependendo de sua disponibilidade:

• Informações básicas do usuário (por exemplo, first_name, last_name, email_address)
• Atributos personalizados
  • Atributos personalizados aninhados
• Propriedades de eventos personalizados
• Informações sobre o dispositivo usado mais recentemente
• Informações do dispositivo de destino

Você também pode extrair conteúdo diretamente de um servidor da Web por meio do Braze Connected Content.

Usando líquido

Usando as Liquid tags, você pode elevar a qualidade das suas mensagens enriquecendo-as com um toque pessoal.

Sintaxe líquida

O Liquid segue uma estrutura específica, ou sintaxe, que você precisará ter em mente ao criar uma personalização dinâmica. Aqui estão algumas regras básicas que você deve ter em mente:

1. Use aspas retas no Braze: Há uma diferença entre aspas curvas (‘’) e aspas retas (‘’). Use aspas retas (‘’) em seu Liquid no Braze. Você pode ver aspas curvas ao copiar e colar de determinados editores de texto, o que pode causar problemas em seu Liquid. Se estiver inserindo cotações diretamente no painel do Braze, não haverá problema!
2. Os suportes vêm em pares: Cada colchete deve abrir e fechar { }. Certifique-se de usar colchetes!
3. Se as declarações vierem em pares: Para cada if, você precisa de um endif para indicar que a declaração if foi encerrada.

Atributos padrão e atributos personalizados

Se você incluir o seguinte texto em sua mensagem: {{${first_name}}}, o primeiro nome do usuário (extraído do perfil do usuário) será substituído quando a mensagem for enviada. É possível usar o mesmo formato com outros atributos de usuário padrão.

Se quiser usar o valor de um atributo personalizado, você deverá adicionar o namespace “custom_attribute” à variável. Por exemplo, para usar um atributo personalizado chamado “zip code” (código postal), você deve incluir {{custom_attribute.${zip code}}} em sua mensagem.

Inserção de tags

Você pode inserir tags digitando dois colchetes abertos {{ em qualquer mensagem, o que acionará um recurso de preenchimento automático que continuará a ser atualizado à medida que você digitar. Você pode até mesmo selecionar uma variável nas opções que aparecem à medida que você digita.

Se estiver usando uma tag personalizada, você pode copiar e colar a tag em qualquer mensagem que desejar.

Exceções para colchetes duplos

Se estiver usando uma tag dentro de outra tag do Liquid, como {{ em qualquer mensagem, o que acionará um recurso de preenchimento automático que continuará a ser atualizado à medida que você digitar. Você pode até mesmo selecionar uma variável nas opções que aparecem à medida que você digita.

Se estiver usando uma tag personalizada, você pode copiar e colar a tag em qualquer mensagem que desejar.

Exceções para colchetes duplos

Se estiver usando uma tag dentro de outra tag do Liquid, como {% assign %} ou {% if %}, você pode usar colchetes duplos ou nenhum colchete. Somente quando a tag é isolada é que ela deve ser colocada entre colchetes duplos. Para simplificar, você sempre pode usar colchetes duplos.

As tags a seguir estão todas corretas:

1
2
3
4
5
{% if custom_attribute.${Number_Game_Attended} == 1 %}
{% if {{custom_attribute.${Number_Game_Attended}}} == 1 %}

{% assign value_one = {{custom_attribute.${one}}} %}
{% assign value_one = custom_attribute.${one} %}

Inserção de variáveis pré-formatadas

Você pode inserir variáveis pré-formatadas com padrões por meio do modal Add Personalization localizado próximo a qualquer campo de texto de modelo.

O modal Add Personalization que aparece após a seleção de inserir personalização. O modal tem campos para o tipo de personalização, atributo, valor padrão opcional e exibe uma visualização da sintaxe do Liquid.](/docs/pt-br/assets/img_archive/insert_liquid_var_arrow.png?b9fe52fd1f178d3fe9c1a3bca45eec73){: style=”max-width:90%;”}

O modal inserirá o Liquid com o valor padrão especificado no ponto em que o cursor estava. O ponto de inserção também é especificado pela caixa de visualização, que tem o texto antes e depois. Se um bloco de texto for destacado, o texto destacado será substituído.

Um GIF do modal Add Personalization que mostra o usuário inserindo “fellow traveler” (companheiro de viagem) como um valor padrão e o modal substituindo o texto destacado “name” (nome) no compositor pelo snippet Liquid.](/docs/pt-br/assets/img_archive/insert_var_shot.gif?498223ac1dd3a3dab9e1da5eccdf9626)

Atribuição de variáveis

Algumas operações no Liquid exigem que você armazene o valor que deseja manipular como uma variável. Isso geralmente ocorre se a instrução Liquid incluir vários atributos, propriedades de eventos ou filtros.

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

Exemplo de líquido incorreto

Você não pode usar:

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

Esse Liquid não funciona porque não é possível fazer referência a vários atributos em uma linha; é necessário atribuir uma variável a pelo menos um desses valores antes que as funções matemáticas sejam executadas. A adição de dois atributos personalizados exigiria duas linhas do Liquid: uma para atribuir o atributo personalizado a uma variável e outra para realizar a adição.

Exemplo de líquido correto

Você pode usar:

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

Tutorial: Uso de variáveis para calcular um saldo

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

Primeiro, use a tag assign para substituir o atributo personalizado de 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 seu saldo de recompensas, indicado por {{balance}}.

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