Modelos Liquid

Vídeo do YouTube: Aprenda a usar modelos de conteúdo em Customer Journeys

Os modelos Liquid ampliam significativamente as capacidades de personalização da Pushwoosh ao implementar lógica sofisticada, além do uso regular de Conteúdo Dinâmico.

A personalização de mensagens na Pushwoosh é baseada em Tags (dados do usuário). A Pushwoosh oferece uma variedade de Tags padrão e Tags personalizadas. Usando-as, você pode especificar o nome, a cidade, o histórico de compras de um usuário, etc., para enviar uma mensagem mais personalizada. Por exemplo: Olá {{First_name}}, obrigado por pedir {{item}}.

Os modelos Liquid adicionam mais lógica ao conteúdo dinâmico. Por exemplo, se a tag de assinatura de um usuário contiver “gratuito”, você pode enviar a ele uma mensagem: “Aproveite seu desconto de 10%”.

Modificar o conteúdo da mensagem de acordo com os IDs, comportamentos e preferências dos usuários é a maneira mais eficiente de aumentar a relevância e obter resultados mais impressionantes de suas campanhas de marketing.

Sintaxe

Modelos de conteúdo baseados em Liquid da Shopify usam uma combinação de tags, objetos e filtros para carregar conteúdo dinâmico. Os modelos de conteúdo permitem que você acesse certas variáveis de dentro de um modelo e exiba seus dados sem precisar saber nada sobre os dados em si.

Nota

Para saber mais sobre a sintaxe, consulte a documentação do Liquid.

Objetos

objects definem o conteúdo que será exibido para um usuário. objects devem ser colocados entre chaves duplas: {{ }}

Por exemplo, ao personalizar uma mensagem, envie {{Name}} em seu corpo para adicionar os nomes dos usuários ao conteúdo da mensagem. O nome do usuário (valor da tag Name) substituirá o objeto Liquid em uma mensagem que o usuário verá.

Entrada

Olá {{Name}}! Estamos felizes que você voltou!

Saída

Olá Anna! Estamos felizes que você voltou!

Tags

tags criam a lógica e o fluxo de controle para os modelos. Os delimitadores de porcentagem e chaves {% e %} e o texto que eles envolvem não produzem nenhuma saída visível quando o modelo é renderizado. Isso permite que você atribua variáveis e crie condições ou loops sem mostrar nenhuma lógica Liquid para o usuário.

Por exemplo, usando a tag if, você pode variar o idioma da mensagem com base no idioma definido no dispositivo do usuário:

Entrada

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

Saída (fr)

Salut!

Saída (es)

Hello!

Operadores de tags

Operador	Descrição
==	igual a
!=	diferente de
>	maior que
<	menor que
>=	maior ou igual a
<=	menor ou igual a
or	ou lógico
and	e lógico
contains	verifica a presença de uma substring dentro de uma string ou array de strings

Nota

Em tags com mais de um operador and ou or, os operadores são verificados em ordem da direita para a esquerda. Você não pode alterar a ordem das operações usando parênteses — parênteses são caracteres inválidos em Liquid e impedirão que suas tags funcionem.

Filtros

filters modificam a saída de um objeto ou variável Liquid. Eles são usados dentro de chaves duplas {{ }} e na atribuição de variáveis, e são separados por um caractere de pipe |. Vários filtros podem ser usados em uma única saída e são aplicados da esquerda para a direita.

Entrada

{{ Name | capitalize | prepend:"Olá " }}

Saída

Olá Anna

Uso de modelos Liquid

Os modelos Liquid estão disponíveis tanto para mensagens enviadas do Painel de Controle quanto para requisições de API.

Na Pushwoosh, os modelos Liquid são aplicáveis a todos os campos de conteúdo de qualquer mensagem de canal:

• Notificações push
• E-mails

Para adicionar um Modelo Liquid à sua mensagem, insira-o no corpo da mensagem. Você pode fazer isso ao trabalhar com os elementos de push ou e-mail, diretamente da interface do Construtor de Customer Journey.

Vá para Construtor de Customer Journey > Criar Campanha > arraste e solte os seguintes elementos em sua tela: Entrada Baseada em Público, Push (ou E-mail) e Saída. Conecte os elementos. Em seguida, clique no ícone Push, escolha Conteúdo personalizado e insira seu texto.

Para adicionar lógica Liquid, use valores de tag com a seguinte sintaxe:

{% if TagName == 'value' %}
  Conteúdo a ser enviado neste cenário
{% else %}
  Conteúdo a ser enviado caso contrário
{% endif %}

Em seguida, clique em Aplicar.

As variáveis de modelo (Tags da Pushwoosh) não devem conter espaços e devem ter apenas valores alfanuméricos e sublinhados, por exemplo, minha_tag ou minhaTag em vez de Minha Tag.

Saiba mais sobre modelos Liquid em jornadas

Dica

Você também pode usar a sintaxe Liquid em requisições /createMessage para implementar modelos Liquid. Para isso, você precisará da ajuda de sua equipe de desenvolvimento. Compartilhe o guia de modelos Liquid com eles para orientações detalhadas.

Conteúdo conectado

O conteúdo conectado é um recurso nos modelos Liquid que permite recuperar e usar dinamicamente dados de uma fonte externa, como um serviço web, diretamente em suas mensagens de e-mail ou notificação push. Este recurso permite a personalização em tempo real, buscando dados JSON de uma URL especificada e salvando-os em uma variável que pode ser utilizada em seu conteúdo.

Principais casos de uso

• Recomendações de produtos: Exiba listas de produtos personalizadas e adaptadas a cada usuário.

• Códigos promocionais: Insira códigos promocionais exclusivos gerados por um serviço de backend.

Pré-requisitos

• Para usar o Conteúdo Conectado, você deve ter seu próprio serviço de backend que gera e fornece os dados necessários (por exemplo, códigos promocionais, recomendações de produtos) com base no ID do Usuário, HWID ou tags personalizadas. A Pushwoosh então busca esses dados antes de enviar uma mensagem.

Guia de implementação passo a passo

Assistência de desenvolvedor necessária

Você precisará da ajuda de sua equipe de desenvolvedores para usar o Conteúdo Conectado. Compartilhe este guia com eles para começar.

Passo 1. Configure o serviço de backend

O serviço de backend deve:

• Aceitar uma requisição contendo parâmetros específicos do usuário (por exemplo, userId). O Conteúdo Conectado suporta UserID, HWID ou quaisquer tags personalizadas que você tenha configurado em seu projeto.
• Retornar uma resposta JSON com os dados necessários. Este conteúdo pode então ser inserido dinamicamente nas mensagens.

Como funciona

O serviço de backend atua como um provedor de dados, respondendo a requisições HTTP com informações específicas do usuário.

1. A Pushwoosh envia uma requisição para o seu backend, passando identificadores específicos do usuário como parâmetros de consulta.
2. Seu backend processa a requisição e recupera os dados solicitados.
3. Seu backend retorna uma resposta JSON.
4. Antes de enviar uma mensagem, a Pushwoosh busca a resposta JSON do serviço de backend e usa os valores retornados (por exemplo, o code) no conteúdo da mensagem dinamicamente.

Exemplo de resposta

{ "code": "OFERTAESPECIALPARAUSUARIO12345" }

Passo 2. Crie um preset com Conteúdo Conectado na Pushwoosh

1. No editor de conteúdo Push ou de E-mail, insira a sintaxe do Conteúdo Conectado no campo da mensagem.

Exemplo

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

Detalhamento da sintaxe

connected_content	Busca dados JSON da URL de backend especificada.
http://your-backend-url.com	O endpoint do backend que retorna os dados necessários em formato JSON.
userId={{ ${userid} }}	Um parâmetro de consulta dinâmico que passa o ID do usuário para o backend.
:save result	Armazena a resposta JSON buscada na variável result para uso em modelos Liquid.

Autenticação (opcional)

Se o seu serviço de backend exigir autenticação, você pode incluir uma chave de API ou token na requisição do Conteúdo Conectado para garantir o acesso seguro.

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=SUA_CHAVE_DE_API :save result %}

Usando tags no Conteúdo Conectado

Para incluir tags personalizadas, insira-as como parâmetros de consulta na requisição do Conteúdo Conectado ({{ nome_da_tag }}).

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}

2. Em seguida, adicione o texto da mensagem incorporando os dados recuperados, assim:

Ei, {{userid}}, pegue seu código promocional pessoal - {{result.code}}

3. Após finalizar o conteúdo da mensagem e configurar as definições do preset, salve-o para reutilização em campanhas.

Passo 3. Envie uma mensagem usando o preset configurado

Envie uma mensagem com este preset usando o formulário de push único ou e-mail ou uma customer journey.

Importante

Se o serviço retornar um status diferente de HTTP 200 OK, o e-mail ou a notificação push não será enviado. Isso garante que sua comunicação só seja enviada se os dados necessários forem recuperados com sucesso.