Templates Liquid

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

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

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

Os templates Liquid adicionam mais lógica ao conteúdo dinâmico. Por exemplo, se a tag de assinatura de um usuário contiver “free”, você pode enviar 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

Os templates de conteúdo baseados no Liquid da Shopify usam uma combinação de tags, objetos e filtros para carregar conteúdo dinâmico. Os templates de conteúdo permitem que você acesse certas variáveis de dentro de um template 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

Hi {{Name}}! We're glad you're back!

Saída

Hi Anna! We’re glad you’re back!

Tags

tags criam a lógica e o fluxo de controle para os templates. Os delimitadores de chave e porcentagem {% e %} e o texto que eles envolvem não produzem nenhuma saída visível quando o template é 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 na 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 no 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:"Hello " }}

Saída

Hello Anna

Uso de templates Liquid

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

No Pushwoosh, os templates 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 Template Liquid à sua mensagem, insira-o no corpo da mensagem. Você pode fazer isso ao trabalhar com elementos de push ou e-mail, diretamente da interface do Customer Journey Builder.

Vá para Customer Journey Builder > Criar Campanha > arraste e solte os seguintes elementos em sua tela: Entrada Baseada em Audiência, 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 os valores das tags com a seguinte sintaxe:

{% if TagName == 'value' %}
  Content to send in this scenario
{% else %}
  Content to send otherwise
{% endif %}

Em seguida, clique em Aplicar.

As variáveis de template (Tags do Pushwoosh) não devem conter espaços e devem ter apenas valores alfanuméricos e sublinhados, por exemplo, my_tag ou myTag em vez de My Tag.

Saiba mais sobre templates Liquid em jornadas

Dica

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

Conteúdo conectado

Conteúdo conectado é um recurso nos templates 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. Esse 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 para 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. O 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 solicitaçã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 solicitações HTTP com informações específicas do usuário.

1. O Pushwoosh envia uma solicitação ao seu backend, passando identificadores específicos do usuário como parâmetros de consulta.
2. Seu backend processa a solicitação e recupera os dados solicitados.
3. Seu backend retorna uma resposta JSON.
4. Antes de enviar uma mensagem, o 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": "SPECIALOFFERFORUSER12345" }

Passo 2. Crie uma predefinição com Conteúdo conectado no Pushwoosh

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

Exemplo

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

Análise da sintaxe

connected_content	Busca dados JSON da URL de backend especificada.
http://your-backend-url.com	O endpoint de backend que retorna os dados necessários no 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 de resultado para uso em templates Liquid

Autenticação (opcional)

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

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

Usando tags em Conteúdo conectado

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

{% 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:

Hey, {{userid}}, grab your personal promo code - {{result.code}}

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

Passo 3. Envie uma mensagem usando a predefinição configurada

Envie uma mensagem com esta predefinição usando o formulário de push único ou de e-mail ou uma jornada do cliente.

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.