Extras de mensagem Liquid tag

Use a tag message_extras Liquid para anotar seus eventos de envio com dados dinâmicos de Connected Content, Catálogos, atributos personalizados (como idioma, país), propriedades de entrada do Canvas ou outras fontes de dados.

A tag message_extras Liquid anexa pares de valores-chave ao evento de envio correspondente no Currents e no Snowflake Data Sharing.

Para enviar dados dinâmicos ou extras de volta ao evento de envio do Currents ou do Snowflake Data Sharing, insira a tag Liquid adequada no corpo da mensagem.

Aqui está um exemplo do formato de tag Liquid padrão para message_extras:

1
{% message_extras :key test :value 123 %}

Você pode adicionar essas tags conforme necessário para seus pares de valores-chave no corpo da mensagem. No entanto, o comprimento de todas as chaves e valores não deve exceder 1 KB. No Currents e no Snowflake Data Sharing, você verá um novo campo de evento chamado message_extras para seus eventos de envio. Isso gerará uma string serializada JSON em um campo.

Canais suportados

A tag message_extras é compatível com todos os tipos de mensagem com um evento de envio, juntamente com eventos de impressão de mensagens in-app. O uso do site message_extras com mensagens no aplicativo requer o cumprimento de determinadas versões mínimas do SDK.

Como usar a tag message_extras

1. No corpo da mensagem do canal, insira a tag message_extras Liquid. Ou então, você pode usar o modal Add Personalization e selecionar Message Extras para o tipo de personalização.

O modal Add Personalization com Message Extras selecionado como o tipo de personalização.](/docs/pt-br/assets/img_archive/message_extras1.png?69c737d3137bb3531879416fae77dfcb){: style=”max-width:35%;”}

2. Digite o par chave-valor para cada tag message_extras.

!Um exemplo de pares de valores-chave para a tag de extras de mensagem. O campo de título diz “Seus novos favoritos”. A mensagem lê pares de valores-chave para a tag de extras da mensagem e a frase a seguir: “Estamos entusiasmados em oferecer uma seleção de produtos novos e interessantes que certamente se tornarão seus novos favoritos”

3. Depois que sua campanha ou Canvas for enviado, o Braze anexará os dados dinâmicos no momento do envio por meio dos eventos de envio Currents ou Snowflake Data Sharing ao campo message_extras.

Verificação da sintaxe

Qualquer outra entrada que não corresponda ao padrão de tag discutido acima pode não ser transmitida ao Currents ou ao Snowflake. Verifique se sua sintaxe ou formatação não inclui nenhum dos seguintes itens:

• Delimitadores inexistentes, vazios ou com erros de digitação
• Chaves duplicadas (o Braze enviará por padrão o par chave-valor que for encontrado primeiro)
• Texto extra antes da definição de chaves ou valores
• Chaves e valores fora de ordem
  • Por exemplo, {% message_extras :value 123 :key test %}

Envio de informações sobre códigos promocionais para o Currents

Você pode combinar message_extras com códigos promocionais para enviar informações sobre códigos promocionais ao Currents. Use a tag capture para armazenar o código de promoção em uma variável e, em seguida, faça referência a essa variável em message_extras:

1
2
3
4
5
{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}

Considerações

• Se seus valores-chave excederem 1 KB, eles serão truncados.
• Os espaços em branco contarão para a contagem de caracteres. Observe que o Braze omite os espaços em branco à esquerda e à direita.
• O JSON resultante produzirá apenas valores de cadeia de caracteres.
• Você pode incluir variáveis do Liquid como chave ou valor, mas não pode usar outras tags do Liquid em message_extras.
  • Por exemplo, você poderia usar o seguinte Liquid: {% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

Perguntas frequentes

Como posso associar o campo message_extras nos eventos de envio aos meus eventos de engajamento, como aberturas e cliques?

Um dispatch_id é gerado e fornecido em seus eventos de envio, que pode ser usado como um identificador exclusivo para vincular a eventos específicos de clique, abertura ou entrega. Você poderá usar e consultar esse campo no Currents ou no Snowflake. Saiba mais sobre o comportamento dodispatch_id .

Posso usar o message_extras com mensagens no aplicativo?

Sim, você pode usar o message_extras em suas mensagens in-app, desde que os dispositivos de seus usuários tenham as seguintes versões mínimas de SDK: