DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Adicionar personalização build-personalization-expressions

Last update: Fri Aug 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Intermediário
  • Desenvolvedor

O editor de personalização é a peça central da personalização em Journey Optimizer. Ele está disponível em todos os contextos em que você precisa definir a personalização, como emails, push e ofertas.

Na interface do editor de personalização, você pode selecionar, organizar, personalizar e validar todos os dados para criar uma personalização personalizada para seu conteúdo.

Onde posso adicionar personalização where

Você pode adicionar personalização em Journey Optimizer em todos os campos com o ícone adicionar personalização . Expanda as seções abaixo para obter mais detalhes.

Mensagens

Nas mensagens, a personalização pode ser adicionada em locais diferentes, como o campo Linha de assunto.

Ele também pode ser adicionado em outras seções do seu conteúdo. Por exemplo, para notificações por push, a personalização pode ser adicionada nos campos Título, Corpo, Som personalizado, Medalhas e Dados personalizados.

Email Designer

Ao editar o conteúdo de email na Designer de email, você pode adicionar personalização em blocos de texto e em URLs usando o ícone na barra de ferramentas contextual.

Ofertas
Você pode adicionar personalização ao usar conteúdo do tipo texto em suas representações de ofertas. Saiba como criar ofertas personalizadas
URLs

O Journey Optimizer também permite personalizar URLs em sua mensagem. Os URLs personalizados levam os destinatários para páginas específicas de um site ou para um microsite personalizado, dependendo dos atributos do perfil. A personalização de URL está disponível para estes tipos de links: Link externo, Link de unsubscription e Opt-Out.

Amostra de URLs personalizados:

  • https://www.adobe.com/users/{{profile.person.name.lastName}}
  • https://www.adobe.com/users?uid={{profile.person.name.firstName}}
  • https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
  • https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}

{width="50%"}

note note
NOTE
Ao editar um URL personalizado no editor de personalização, as funções auxiliares e a associação de públicos-alvo são desativadas por motivos de segurança.
Não há suporte para espaços nos tokens de personalização usados em urls.
Configuração de email
Ao criar uma configuração de canal de email, você pode definir valores personalizados para subdomínios, cabeçalhos e parâmetros de rastreamento de URL. Saiba mais

Fontes do Personalization sources

O painel de navegação permite selecionar a origem para personalização. As fontes disponíveis são:

  • Atributos do perfil : lista todas as referências associadas ao esquema de perfil descrito na documentação do Adobe Experience Platform Data Model (XDM).
  • Atributos do público-alvo: esta pasta é específica para campanhas orquestradas. Ele contém atributos calculados diretamente na tela da campanha. Saiba como adicionar personalização em campanhas orquestradas
  • Públicos-alvo : lista todos os públicos-alvo criados no serviço de Segmentação do Adobe Experience Platform. Mais informações sobre segmentação estão disponíveis aqui.
  • Decisões de oferta : lista todas as ofertas associadas a uma disposição específica. Selecione o posicionamento e insira as ofertas no conteúdo. Para obter uma documentação completa sobre como gerenciar ofertas, consulte esta seção.
  • Atributos contextuais: quando uma atividade de ação de canal (email, push, SMS) é usada em uma jornada ou campanha, os atributos contextuais relacionados a eventos e propriedades ficam disponíveis para personalização. Um exemplo de personalização que utiliza atributos contextuais é apresentado em esta seção.
NOTE
Se você estiver direcionando um público-alvo com atributos de enriquecimento gerados usando um fluxo de trabalho de composição, poderá aproveitar esses atributos de enriquecimento para personalizar sua mensagem. Saiba como usar atributos de enriquecimento de públicos-alvo

Adicionar personalização add

O espaço de trabalho central é onde você cria sua sintaxe de personalização. Para usar um atributo para personalizar sua mensagem, localize-o no painel de navegação esquerdo e clique no botão + para adicioná-lo à expressão.

O menu de reticências ao lado do ícone + permite obter mais detalhes para cada atributo e adicionar os atributos usados com mais frequência aos favoritos. Os atributos adicionados aos favoritos podem ser acessados pelo menu Favoritos no painel de navegação.

NOTE
Por padrão, o painel de atributos mostra apenas atributos preenchidos. Para exibir todos os atributos, selecione o botão localizado acima do campo de pesquisa e desative a opção Mostrar apenas atributos preenchidos.

Além disso, você pode definir um texto de fallback padrão que será exibido se um atributo de perfil do tipo string estiver vazio. Para fazer isso, clique no botão de reticências ao lado do atributo e selecione Inserir com texto alternativo. Escreva o texto que deve ser exibido por padrão se o valor do atributo estiver vazio para um perfil e clique em Adicionar.

No exemplo a seguir, o editor de personalização permite selecionar os perfis que fazem aniversário hoje e, em seguida, concluir a personalização inserindo uma oferta específica correspondente a este dia.

Opções para edição de expressão options

O espaço de trabalho central fornece várias ferramentas para ajudar você a escrever sua expressão de personalização.

As opções disponíveis são:

  1. Localizar / Localizar e substituir: pesquise pela expressão e substitua automaticamente partes do código.

  2. Desfazer / Refazer: Desfazer / Refazer a última operação.

  3. Preenchimento automático: sugere e conclui automaticamente o código à medida que você digita. Esse recurso está disponível somente para os formatos HTML e Texto e é compatível com os atributos de Perfil e Contexto. Se desabilitado por meio do botão de alternância, o editor fornecerá preenchimento automático do código HTML nativo.

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / Text: identifique o formato do seu código. Isso permite que o sistema adapte a validação e o recurso de preenchimento automático com base no idioma selecionado.

  5. Validar: verifique a sintaxe da sua expressão. Saiba mais nesta seção.

  6. Salvar como fragmento: salve sua expressão como um fragmento de expressão. Saiba mais nesta seção

  7. Tamanho da fonte: ajusta o tamanho da fonte do conteúdo dentro do editor para melhorar a leitura.

  8. Quebra de texto: habilita ou desabilita a quebra automática de linha, permitindo que expressões longas sejam exibidas em uma única linha ou quebra automática no editor. As opções incluem:

    • Desativado (Padrão) - Sem quebra automática de linha. As linhas longas se estendem além da exibição do editor e exigem rolagem horizontal.
    • Em - Quebra linhas na largura do editor.
    • Coluna de quebra automática de linha - Quebra as linhas quando os caracteres de linha atingem 80 caracteres.
    • Limitado - Quebra as linhas na largura do editor ou em 80 caracteres, o que for menor.

  9. Pills: exibir atributos como "pílulas" compactas para melhorar a legibilidade, ocultando caminhos de atributos longos. Clique em um atributo para exibir seu caminho completo.

    note note
    NOTE
    A exibição de pílulas será gradualmente lançada em todos os ambientes nos próximos 30 dias.
    Essa opção só está disponível para atributos de perfil, atributos contextuais e mídia dinâmica.

No painel de navegação, recursos adicionais estão disponíveis para ajudar você a criar sua expressão de personalização.

  • Funções auxiliares - As funções auxiliares permitem executar operações em dados, como cálculos, formatação de dados ou conversões, condições e manipulá-las no contexto da personalização. Saiba mais sobre as funções auxiliares disponíveis

  • Favoritos - Os atributos adicionados aos favoritos são exibidos nesta lista. Isso permite acessar rapidamente os itens usados com mais frequência. Para adicionar um atributo aos favoritos, clique no menu de reticências e escolha Adicionar aos favoritos.

  • Condições - Aproveite as regras condicionais criadas na biblioteca para adicionar conteúdo dinâmico às suas mensagens. Isso permite criar várias variantes da mensagem com base em condições. Saiba como criar conteúdo dinâmico

  • Fragmentos - Aproveite fragmentos de expressão que foram criados ou salvos na sandbox atual. Um fragmento é um componente reutilizável que pode ser referenciado em Journey Optimizer campanhas e jornadas. Essa funcionalidade permite pré-construir vários blocos de conteúdo personalizado que podem ser usados por usuários de marketing para reunir conteúdo rapidamente em um processo de design aprimorado. Saiba como usar fragmentos de expressão para personalização

Quando a expressão de personalização estiver pronta, será necessário validá-la pelo editor de personalização. Saiba mais nesta seção.

Mecanismos de validação validation-mechanisms

A validação da sua expressão é executada automaticamente quando você clica no botão Adicionar para fechar a janela do editor. Você também pode usar o botão Validar para verificar sua sintaxe de personalização.

Expanda a seção abaixo para ver erros comuns que podem ocorrer ao validar a personalização.

Erros comuns
  • Caminho "XYZ" não encontrado

Ao tentar referenciar um campo que não está definido no esquema.

Nesse caso, firstName1 não está definido como atributo no esquema de perfil:

code language-none 
{{profile.person.name.firstName1}}
  • Incompatibilidade de tipo para a variável "XYZ". Matriz esperada. Cadeia de caracteres encontrada.

Ao tentar iterar sobre uma cadeia de caracteres em vez de uma matriz.

Neste caso, o produto não é uma matriz:

code language-none 
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • Sintaxe de manipuladores inválida. Encontrado'[XYZ}}'

Quando a sintaxe de manipuladores inválidos é usada.

Expressões Handlebars cercadas por {{expression}}

code language-none 
   {{[profile.person.name.firstName}}
  • Definição de segmento inválida
code language-none 
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

Para ofertas, podem ocorrer erros específicos. Expanda a seção abaixo para obter mais detalhes:

Erros específicos relacionados às ofertas

Os erros relacionados à integração de ofertas em uma mensagem de email ou push têm o seguinte padrão:

code language-none 
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

A validação é executada durante a validação do conteúdo de personalização no editor de personalização.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Título de erro Validação/Resolução
Recurso com id placementID e tipo OfferPlacement não encontrado
Recurso com id activityID e tipo OfferActivity não encontrado		 Verificar se ActivityID e/ou PlacementID estão disponíveis
O recurso não pôde ser validado. O componentType no Posicionamento deve corresponder à oferta offerType
O URL público não está presente em offerId. As Ofertas de imagem (todas as Personalizadas e substitutas associadas ao par de decisão e posicionamento) devem ter o URL público preenchido (deliveryURL não deve estar vazio).
A decisão contém atributos que não são de perfil. O uso do modelo de ofertas deve conter somente os atributos do perfil.
Ocorreu um erro ao buscar o uso de decisão. Esse erro pode ocorrer quando a API está tentando buscar o modelo de oferta.
Atributo de oferta atributo de oferta inválido. Verifique se o atributo de oferta referenciado na queda da oferta é válido. A seguir estão os atributos válidos:
Imagem: deliveryURL, linkURL
Texto: conteúdo
HTML: content
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76