Skip to main content

Variável de Template

O item de configuração Variável de Template indica ao sistema como obter os valores que devem substituir as variáveis presentes em Templates com dados dinâmicos na Meta.

Por exemplo, suponha que você tenha um Template cadastrado na Meta com o seguinte conteúdo:

Olá, {{1}}!

Obrigado por visitar o nosso site.

Vimos que você se interessou pelo produto {{2}}.
Veja a promoção que temos para você, referente a esse produto.

Nesse exemplo, os símbolos {{1}} e {{2}} representam variáveis no seu Template Meta, correspondendo, respectivamente, ao nome do usuário e ao nome do produto pelo qual ele se interessou. Quando a mensagem for enviada, espera-se que esses dados estejam disponíveis para que a mensagem seja personalizada adequadamente.

Variáveis são essenciais para o envio de mensagens personalizadas, oferecendo uma experiência única para cada usuário.

Os valores que substituem essas variáveis são extraídos a partir das capturas de dados realizadas em seu site, baseadas na interação do usuário com a página. Portanto, é necessário informar ao sistema como localizar e extrair esses dados, ou seja, indicar para quais capturas ele deve apontar para obter as informações corretas.

O objeto Variável de Template serve exatamente para ensinar o sistema a buscar o valor correspondente dentro da estrutura da captura configurada.

Exemplo:​

Imagine que você tenha uma captura com a seguinte estrutura JSON:

{
    "usuario": {
        "nome": "João",
        "produtoInteresse": "Smartphone X"
    }
}

Para preencher as variáveis {{1}} e {{2}}, você deve configurar o caminho para extrair "usuario.nome" e "usuario.produtoInteresse", respectivamente.

Importante

Atualmente, apenas variáveis do tipo text são suportadas. Isso significa que seu template na Meta deve ser configurado para usar variáveis textuais, e não variáveis numéricas, imagens ou outros tipos.

Resumo​

  • Variável de Template: objeto que mapeia variáveis do Template para os dados capturados no seu site.

  • Captura de dados: estrutura JSON que contém as informações coletadas na interação do usuário.

  • O sistema usa a configuração para preencher as mensagens personalizadas corretamente.

Configuração​

CampoTipoObrigatórioDescrição
NomestringSimNome do objeto, usado para identificação fácil.
CapturaCapturaSimIndica qual captura deve ser utilizada.
Caminho do Campostring[]SimCaminho dentro do objeto de captura onde o valor desejado está localizado
Localização[BODY, HEADER]SimIndica em que porção do Template a variável esta localizada
PosiçãointegerSimIndica a posição da variável no template, ou seja, se ela aparece como primeira ({{1}}), segunda ({{2}}), terceira ({{3}}), e assim por diante.

Detalhes dos Campos​

Nome​

Tipo: string.

Nuleável: Não.

Descrição: Nome do objeto Variável de Template. Usado para fácil identificação no sistema.

Captura​

Tipo: Captura.

Nuleável: Não.

Descrição: Seleciona qual Captura será utilizada para extrair o dado desejado. Ou seja, você deve ter pelo menos uma Captura configurada previamente. O sistema exibirá automaticamente todas as Capturas já configuradas e disponíveis na SmartTag, permitindo que você escolha a que se aplica ao valor que deseja capturar.

Caminho do Campo​

Tipo: string[] Nuleável: Não

Descrição: Sequência de strings que define o caminho até o campo desejado dentro do objeto Captura, permitindo ao sistema extrair o valor corretamente. Por exemplo, se a Captura tiver o seguinte formato:

{
    "info": {
        "nome": "joao"
    }
}

O caminho para acessar o nome seria:

["info", "nome"]

O sistema oferece sugestões automáticas de caminhos válidos com base na captura selecionada, facilitando a seleção do caminho final para o dado desejado.

Localização​

Tipo: Enum [BODY, HEADER].

Obrigatório: Sim.

Descrição: Indica em qual parte do template a variável está localizada, podendo ser no corpo da mensagem (BODY) ou no cabeçalho (HEADER).

Posição​

Tipo: integer.

Obrigatório: Sim.

Descrição: Indica a posição da variável no template, ou seja, se ela aparece como primeira ({{1}}), segunda ({{2}}), terceira ({{3}}), e assim por diante.

Double Check

Certifique-se de que a configuração da variável na nossa plataforma corresponde exatamente àquela feita na Meta, qual seja, usando a mesma posição no template.