Skip to content

Referência de Liquid

Liquid é uma linguagem de modelo de código aberto criada pela Shopify e usada pela Braze para possibilitar a personalização dinâmica. Em vez de enviar uma mensagem estática para todos, o Liquid permite criar modelos que alteram seu conteúdo com base nos dados de perfil, comportamento ou idioma de cada destinatário. Use os artigos desta seção para conhecer tags compatíveis, filtros, lógica condicional, valores padrão e padrões comuns de personalização.

Artigos da seção

    Sobre o Liquid

    O Liquid funciona como uma ponte entre sua mensagem e os dados do usuário. Quando você envia uma mensagem, a Braze analisa o texto em busca de sintaxe Liquid. Ao encontrar Liquid, ela extrai os dados relevantes para aquele usuário específico e substitui o código pelo valor real antes de enviar a mensagem.

    Por exemplo, você pode recuperar um atributo personalizado de um perfil de usuário que seja um tipo de dado inteiro e arredondar esse valor para o número inteiro mais próximo. Para saber mais sobre a sintaxe e o uso do Liquid, consulte Tags de personalização compatíveis.

    A linguagem de modelo Liquid é compatível com o uso de objetos, tags e filtros.

    • Objetos permitem inserir atributos personalizados nas suas mensagens.
    • Tags permitem inserir dados no envio de mensagens e usar lógica condicional para enviar mensagens quando certas condições forem atendidas. Por exemplo, você pode usar tags para incluir lógica inteligente, como instruções “if”, nas suas Campaigns.
    • Filtros permitem reformatar atributos personalizados e conteúdo dinâmico. Por exemplo, você pode usar o filtro date para converter um timestamp, como 2016-09-07 08:43:50 UTC, em uma data, como 7 de setembro de 2016.

    Compatibilidade com Liquid 5

    A Braze é compatível com Liquid até e incluindo o Liquid 5 da Shopify. A implementação do Liquid é compatível com tipos de tags de personalização de sintaxe e controle de espaços em branco. Para saber mais sobre tags específicas, consulte tags de sintaxe.

    Os seguintes filtros novos de array e matemática estão disponíveis para uso no seu Liquid ao criar seu envio de mensagens.

    • at_least
    • at_most
    • compact
    • concat
    • sort_natural
    • where

    Consulte Filtros para ver as definições.

    Termos importantes

    Esses termos são reinterpretados a partir da documentação da Shopify com base no nosso nível de suporte.

    Termo Definição Exemplo
    Liquid Uma linguagem de modelo amplamente utilizada, voltada para o cliente, criada pela Shopify e escrita em Ruby, usada para carregar e extrair conteúdo dinâmico. {{${first_name}}} inserirá o nome do usuário em uma mensagem.
    Objeto Uma referência a uma variável e à localização do nome da variável desejada, que indica ao Liquid onde exibir o conteúdo na mensagem. {{${city}}} inserirá a cidade do usuário em uma mensagem.
    Tag de lógica condicional Usada para criar lógica e controlar o fluxo do conteúdo da mensagem. Na Braze, as tags de lógica condicional são usadas para criar exceções e variações nas mensagens com base em critérios específicos e predefinidos. {% if ${language} == 'en' %} disparará sua mensagem de uma forma designada caso o usuário tenha definido “English” como seu idioma.
    Filtros Usados para alterar, restringir ou reformatar a saída do objeto Liquid. São frequentemente usados para criar operações matemáticas. {{"Big Sale" | upcase}} fará com que as palavras “Big Sale” apareçam como “BIG SALE” na mensagem.
    Operadores Usados nas mensagens para criar dependências ou critérios que podem afetar qual mensagem o usuário recebe. Se um usuário atender aos critérios definidos em uma mensagem com a tag {% custom_attribute.${Total_Revenue} > 0%}, ele receberá a mensagem. Caso contrário, receberá outra mensagem designada (ou não), dependendo do que você configurar.


    New Stuff!