Usando Liquid

Este artigo mostrará como usar uma variedade de atribuições do usuário para inserir dinamicamente informações pessoais no envio de mensagens.

O 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, é possível usar Liquid tags para criar mensagens condicionais, como o envio de ofertas diferentes com base na data de aniversário da inscrição 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 ativar a personalização e as práticas de envio de mensagens relevantes.

No bloco a seguir, é possível ver o 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 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 do dispositivo usado mais recentemente
• Informações do dispositivo de direcionamento

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

Usando Liquid

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

Sintaxe Liquid

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 na 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 dashboard do Braze, não haverá problema!
2. As chaves vêm em pares: Abra e feche chaves, { }. Não deixe de usar chaves!
3. Se as declarações vierem em pares: Para cada if, você precisa de um endif para indicar que a declaração if terminou.

Atributos padrão e atributos personalizados

Se você incluir o seguinte texto em sua mensagem: {{${first_name}}}, o 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 outras atribuições padrão do usuário.

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” (CEP), você deve incluir {{custom_attribute.${zip code}}} em sua mensagem.

Inserção de tags

Você pode inserir tags digitando duas chaves abertas {{ em qualquer mensagem, o que disparará 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, poderá copiar e colar a tag em qualquer mensagem que desejar.

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

Você pode inserir variáveis pré-formatadas com padrões por meio do modal Add Personalization (Adicionar personalização ), localizado no canto superior direito de qualquer campo de texto modelado.

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 prévia, que tem o texto antes e depois. Se um bloco de texto for destacado, o texto destacado será substituído.

Atribuindo variáveis

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

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

Exemplo de Liquid 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árias atribuições 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 de LINE: 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: 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 das 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!