Personalize mensagens do OneSignal usando propriedades predefinidas e tags de dados personalizadas. Acesse dados de usuário, subscription, journey, mensagem, template e app com sintaxe Liquid em e-mail, push, SMS e webhooks.
Use propriedades (como tags de usuário e identificadores como External ID) para personalizar mensagens e payloads de entrega com sintaxe Liquid.O OneSignal renderiza os placeholders Liquid no momento do envio, usando dados já armazenados no usuário, subscription, Journey, mensagem, template, app ou organização. Você pode usar esses dados para personalizar mensagens, webhooks de Journey e Event Streams.
Use a personalização com propriedades para renderizar conteúdo no momento do envio usando dados que já existem no OneSignal — mais comumente tags de usuário, External ID e campos de subscription como e-mail ou número de telefone.Esta é a abordagem correta quando:
Os dados já estão armazenados no OneSignal
Você quer que os placeholders Liquid sejam substituídos automaticamente quando a mensagem for enviada
Você não precisa buscar ou calcular dados frescos no momento da entrega
Se o valor precisa ser buscado ou calculado no momento do envio (por exemplo, preços ou estoque em tempo real), use Data Feeds ou nossa API com custom_data.Se o valor vem do evento que fez o usuário entrar ou progredir em um Journey, use a personalização com Custom Events.
Use user para dados no nível do usuário. Use subscription quando precisar de valores específicos do canal, como endereço de e-mail ou número de telefone.
O objeto message fornece acesso ao ID da mensagem, nome e ID do template, o que pode ser útil para Event Streams, além de acesso ao custom_data para personalizar mensagens enviadas pelo seu backend.
Este exemplo mostra como personalizar mensagens de carrinho abandonado usando tags de usuário. Ele se baseia no tutorial de Carrinho Abandonado.Exemplo de tags definidas:
Notificações push têm espaço limitado, então exiba um item e mencione a contagem total.Campo de mensagem:Exiba o item e a contagem com gramática correta usando declarações condicionais.
Liquid
{% assign item_count = cart_items_count | plus: 0 %}{% if item_count == 1 %}You left {{product_name}} in your cart.{% endif %}{% if item_count == 2 %}You left {{product_name}} and {{item_count | minus: 1}} more item in your cart.{% endif %}{% if item_count > 2 %}You left {{product_name}} and {{item_count | minus: 1}} more items in your cart.{% endif %}
Exemplo: Personalizar uma mensagem in-app com tags
Este exemplo mostra uma mensagem in-app de recompensa personalizada com Tags. A mensagem in-app substitui valores de Tag em vários tipos de blocos.Na mensagem configurada:
Bloco de texto — exibe o nível concluído e a recompensa para esse nível
Bloco de imagem — exibe a imagem para essa recompensa, com uma imagem padrão como fallback
Texto do botão 2 — exibe o valor da recompensa, com um padrão de 100
Imagem de fundo — definida a partir de um valor de Tag
Editor de mensagem in-app com substituição de Tag configurada em blocos de texto, imagem e botão
A mensagem é renderizada no início da sessão usando os valores de Tag atuais do usuário:
Mensagem in-app exibida ao usuário com valores substituídos a partir de Tags
Consulte a aba Mensagens in-app em Suporte de canal acima para conhecer os blocos, atributos e regras de tempo suportados. Dois lembretes que vale a pena reforçar dali:
As Tags devem ser definidas antes do usuário iniciar uma nova sessão do app. Tags atualizadas no meio da sessão não são renderizadas em mensagens in-app exibidas nessa sessão.
A substituição de Tags não é renderizada nos envios de “Enviar Mensagem de Teste”. Acione a mensagem a partir de uma sessão real para verificar a substituição.
