DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Sintaxe de personalização

5 de maio de 2025
  • Tópicos:

Criado para:

  • Intermediário
  • Desenvolvedor

O Personalization em Journey Optimizer é baseado na sintaxe de modelo chamada Handlebars. Para obter uma descrição completa da sintaxe Handlebars, consulte a documentação de HandlebarsJS.

Ele usa um modelo e um objeto de entrada para gerar HTML ou outros formatos de texto. Os modelos de Handlebars parecem texto regular com expressões Handlebars incorporadas.

Exemplo de expressão simples:

{{profile.person.name}}

em que:

  • profile é um namespace.
  • person.name é um token composto por atributos. A estrutura de atributos é definida em um Esquema XDM do Adobe Experience Platform. Saiba mais.

Regras gerais de sintaxe

  • Os identificadores podem ser qualquer caractere unicode, exceto para o seguinte:

    Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

  • A sintaxe diferencia maiúsculas de minúsculas.

  • As palavras true, false, null e undefined só são permitidas na primeira parte de uma expressão de caminho.

  • Em Handlebars, os valores retornados por {{expression}} são HTML-escaped. Se a expressão contiver &, a saída HTML-escaped retornada será gerada como &amp;. Se você não quiser que o Handlebars escape um valor, use o "triple-stash".

  • Em relação a argumentos de funções literais, o analisador de linguagem de modelo não oferece suporte ao símbolo único de barra invertida sem escape (\). Este caractere deve ser evitado com um símbolo de barra invertida adicional (\). Exemplo:

    {%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

Namespaces disponíveis

  • Perfil

    Este namespace permite referenciar todos os atributos definidos no esquema de perfil descrito na documentação do Adobe Experience Platform Data Model (XDM).

    Os atributos precisam ser definidos no esquema antes de serem referenciados em um bloco de personalização Journey Optimizer.

    Para obter mais informações sobre como utilizar atributos de perfil em condições, consulte esta seção.

    Exemplos de referências
    • {{profile.person.name.fullName}}
    • {{profile.person.name.firstName}}
    • {{profile.person.gender}}
    • {{profile.personalEmail.address}}
    • {{profile.mobilePhone.number}}
    • {{profile.homeAddress.city}}
    • {{profile.faxPhone.number}}

  • Público-alvo

    Para saber mais sobre o serviço de segmentação, consulte esta documentação.

  • Ofertas

    Esse namespace permite fazer referência às decisões de ofertas existentes.

    Para fazer referência a uma oferta, é necessário declarar um caminho com as diferentes informações que definem uma oferta. Esse caminho tem a seguinte estrutura:

    offers.Type.[Placement Id].[Activity Id].Attribute

    em que:

    • offers identifica a expressão de caminho pertencente ao namespace da oferta
    • Type determina o tipo de representação da oferta. Os valores possíveis são: image, html e text
    • Placement Id e Activity Id são identificadores de posicionamento e atividade
    • Attributes são atributos específicos da oferta que dependem do tipo de oferta. Exemplo: deliveryUrl para imagens

    Para obter mais informações sobre a API de Decisões e representações de Oferta, consulte esta página

    Todas as referências são validadas em relação ao Esquema de Ofertas com um mecanismo de validação descrito em esta página

    Exemplos de referências

    • Local onde a imagem está hospedada:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl

    • URL do Target ao clicar na imagem:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl

    • Conteúdo de texto da oferta proveniente do mecanismo de decisão:

      offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

    • Conteúdo HTML da oferta proveniente do mecanismo de decisão:

      offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

Auxiliares

Um auxiliar do Handlebars é um identificador simples que pode ser seguido por parâmetros. Cada parâmetro é uma expressão Handlebars. Esses auxiliares podem ser acessados de qualquer contexto em um modelo.

Esses auxiliares de bloco são identificados por um # precedendo o nome do auxiliar e exigem um / de fechamento correspondente, do mesmo nome.

Blocos são expressões que têm um bloco abrindo ({{# }}) e fechando ({{/}}).

Para obter mais informações sobre funções auxiliares, consulte esta seção.

Tipos literais

Adobe Journey Optimizer dá suporte aos seguintes tipos literais:

Literal
Definição
String
Um tipo de dados composto de caracteres entre aspas duplas.
Exemplos: "prospect", "jobs", "articles"
Booleano
Um tipo de dados que é verdadeiro ou falso.
Número inteiro
Um tipo de dados que representa um número inteiro. Pode ser positivo, negativo ou zero.
Exemplos: -201, 0, 412
Matriz
Um tipo de dados que é composto como um grupo de outros valores literais. Ela usa colchetes para agrupar e vírgulas para delimitar entre valores diferentes.
Observação: não é possível acessar diretamente as propriedades dos itens em uma matriz.
Exemplos: [1, 4, 7], ["US", "FR"]
CAUTION
O uso da variável xEvent não está disponível em expressões de personalização. Qualquer referência a xEvent resultará em falhas de validação.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76