Perguntas frequentes

Nesta página, você encontrará respostas para algumas perguntas frequentes sobre Liquid.

A Braze atualmente não oferece suporte a 100% do Liquid da Shopify, apenas a certas partes que tentamos descrever em nossa documentação. Recomendamos fortemente que você teste todas as mensagens que usam Liquid antes de enviá-las, para reduzir o risco de erros ou de uso de Liquid não suportado.

Como uso snippets de Liquid na Braze?

Em muitos casos, você pode incorporar snippets de Liquid navegando até suas Campaigns ou Canvas e inserindo Liquid no modal de personalização em áreas como o corpo do e-mail ou nos seus Segments.

Onde posso saber mais?

Para saber mais sobre Liquid, confira nosso caminho de aprendizado guiado Personalização dinâmica com Liquid no Braze Learning! Você também pode consultar a biblioteca de casos de uso de Liquid para inspiração e uma variedade de exemplos de personalização usando Liquid.

Qual é a diferença entre usar Liquid e Conteúdo conectado para personalização?

O Conteúdo conectado da Braze é um exemplo de Liquid tag. Ele também é usado para personalização, mas os dados vêm de um endpoint externo em vez de dados armazenados na Braze. Confira nossa seção dedicada de Conteúdo conectado para saber mais sobre como expandir a personalização das suas mensagens.

O que é templating de Liquid?

Essa é a forma mais comum de usar Liquid na Braze. O templating de Liquid envolve puxar dados do perfil de um usuário para uma mensagem. Esses dados podem variar desde o nome do usuário até eventos personalizados de uma mensagem disparada por evento.

Consulte Tags de personalização suportadas para uma lista completa das Liquid tags suportadas.

Como atribuo variáveis com Liquid?

Você pode criar e atribuir variáveis usando a tag assign. Isso cria uma variável no criador de mensagens que também pode ser referenciada ao longo da sua mensagem.

Usar Liquid registra pontos de dados?

Não.

Como posso usar Liquid para enviar uma saudação personalizada?

Para uma saudação personalizada usando o nome do usuário, você pode puxar os atributos padrão do perfil de usuário, como {{${first_name}}}, {{${last_name}}}.

Você também pode usar uma instrução {% if X %} de Liquid para fazer renderização condicional com base em qualquer coisa, como o dia da semana ou atributos personalizados. Para saber mais sobre os operadores de Liquid suportados que podem ser usados em instruções condicionais, confira Operadores.

Como posso personalizar uma mensagem com base no local de um cliente?

Existe um atributo padrão para o local do usuário: {{${most_recent_location}}}.

Qual é a diferença entre {{campaign.${name}}} e {{campaign.${message_name}}}?

Tanto {{campaign.${name}}} quanto {{campaign.${message_name}}} são Liquid tags de personalização suportadas. Ambas as tags fazem referência a atributos da Campaign. {{campaign.${name}}} indica o nome da sua Campaign, e {{campaign.${message_name}}} é o nome da variante da sua mensagem.

Como uso Liquid com objetos aninhados?

A Braze tem um recurso integrado que gera código Liquid para Segments que podem ser usados em uma mensagem. Especificamente, você pode criar um Segment que corresponda a múltiplos critérios em um objeto.

Para saber mais, confira Segmentação com múltiplos critérios.

Como uso atributos de evento para personalizar uma mensagem que um evento está disparando?

Você pode acessar propriedades de eventos disparados por API com a tag api_triggered_property: {{api_trigger_properties.${attribute_key}}}.

Por que meu Liquid disparado por API está falhando na Braze?

Uma causa comum é um par extra de chaves. Por exemplo, {{{api_trigger_properties.${attribute_key}}}} não é uma sintaxe de personalização válida na Braze. Use exatamente duas chaves de abertura e duas de fechamento: {{api_trigger_properties.${attribute_key}}}.

O que é lógica de cancelamento e como posso usá-la?

A lógica de cancelamento permite que você interrompa o envio de uma mensagem se as condições forem atendidas. Isso é especialmente útil para evitar que mensagens incompletas sejam enviadas aos seus usuários. Para exemplos de lógica de cancelamento nas suas Campaigns de marketing, leia mais em Cancelamento de mensagens.

O que é lógica de loop for e como posso usá-la?

Loops for também são conhecidos como tags de iteração. Usar lógica de loop for nos seus snippets de Liquid permite que você percorra blocos de Liquid até que uma condição seja atendida.

Na Braze, isso pode ser usado para verificar itens em um atributo personalizado de array, ou uma lista de valores e objetos retornados por uma chamada de catálogo, seleção ou resposta de Conteúdo conectado. Especificamente, você pode usar lógica de loop for como parte do seu envio de mensagens para verificar se um produto está em estoque ou se um produto tem uma avaliação mínima.

Por exemplo, digamos que você tenha um catálogo chamado “Games” que tem uma seleção chamada “cheap_games”. Para puxar os títulos dos jogos em “cheap_games”, você pode usar este snippet de Liquid:

1
2
3
4
{% catalog_selection_items Games cheap_games %}
{% for item in items %}
 Get this game: {{ item.title }}
{% endfor %}

Quando as condições definidas forem atendidas, sua mensagem pode prosseguir. Usar essa lógica é uma forma útil de economizar tempo, em vez de repetir blocos de Liquid para diferentes condições.

Por que há espaçamento extra em mensagens que usam Content Blocks?

Se você notar espaçamento extra em mensagens enviadas que usam Content Blocks com Liquid, pode haver quebras de parágrafo ou de linha desnecessárias dentro das suas instruções condicionais. Escreva suas instruções condicionais em uma única linha em vez de em múltiplas linhas.

Exemplo

1
{% if {{custom_attribute.${has_discount}}} == true %}Discounted Item{% elsif {{custom_attribute.${is_new_arrival}}} == true %}New Arrival{% else %}Regular Item{% endif %}

Quando devo usar assign versus capture?

Tanto assign quanto capture criam variáveis de Liquid, mas servem a propósitos diferentes:

• assign é para variáveis simples que armazenam um único valor, como um booleano, número ou string simples. Você também pode aplicar um único filtro na mesma linha.
• capture é para armazenar um bloco de texto que pode incluir múltiplas variáveis, strings ou expressões complexas.

Use capture quando o valor for complexo demais para uma única instrução assign, como URLs que utilizam outras variáveis de Liquid ou atributos personalizados como parâmetros. capture também é preferido ao implementar variáveis de Liquid no corpo de chamadas de Conteúdo conectado.

Exemplos

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{% comment %}Use assign for custom attributes{% endcomment %}
{% assign name = {{custom_attribute.${first_name}}} %}
{% assign price = {{custom_attribute.${price}}} | plus: 0 %}

{% comment %}Use assign for a simple variable{% endcomment %}
{% assign discount_label = "20% off" %}
Hello {{ customer.first_name | default: "there" }}, enjoy {{ discount_label }} on your next order!

{% comment %}Use capture for complex strings{% endcomment %}
{% capture greeting %}Hello, {{custom_attribute.${first_name}}}! Your order #{{custom_attribute.${order_id}}} is ready.{% endcapture %}
{{ greeting }}

{% comment %}Use capture to create conditional content{% endcomment %}
{% capture promo_block %}
{% if customer.vip == true %}
As a VIP member, you get free shipping.
{% else %}
Join our VIP program to unlock free shipping.
{% endif %}
{% endcapture %}