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.

Artigos da seção

    Sobre o Liquid

    O Liquid funciona como uma ponte entre sua mensagem e os dados dos seus usuários. Quando você envia uma mensagem, a Braze analisa o texto em busca de sintaxe Liquid. Ao encontrá-la, ela busca os dados relevantes daquele usuário específico e substitui o código pelo valor real antes de a mensagem ser enviada.

    Por exemplo, você pode recuperar um atributo personalizado de um perfil de usuário que seja do tipo 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 suporta o uso de objetos, tags e filtros.

    • Objetos permitem inserir atributos personalizados nas suas mensagens.
    • Tags permitem inserir dados nas mensagens e usar lógica condicional para enviar mensagens quando determinadas condições são atendidas. Por exemplo, você pode usar tags para incluir lógica inteligente, como instruções “if”, nas suas campanhas.
    • 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.

    Suporte ao Liquid 5

    A Braze oferece suporte ao Liquid até e incluindo o Liquid 5 da Shopify. A implementação do Liquid suporta 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áticos estão disponíveis para uso no seu Liquid ao criar suas mensagens.

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

    Consulte Filtros para ver as definições.

    Termos importantes

    Estes 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 voltada ao cliente, amplamente utilizada, criada pela Shopify e escrita em Ruby, usada para carregar e exibir conteúdo dinâmico. {{${first_name}}} insere o nome do usuário em uma mensagem.
    Objeto Uma indicação de variável e localização do nome da variável pretendida que diz ao Liquid onde exibir o conteúdo na mensagem. {{${city}}} insere 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 determinados critérios predefinidos. {% if ${language} == 'en' %} acionará sua mensagem de uma forma específica caso o usuário tenha definido “Inglês” como idioma.
    Filtros Usados para alterar, restringir ou reformatar a saída do objeto Liquid. Frequentemente utilizados 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 marcada com {% custom_attribute.${Total_Revenue} > 0%}, ele receberá a mensagem. Caso contrário, receberá outra mensagem designada (ou não), dependendo do que você configurou.


    New Stuff!