Considerações e solução de problemas aem-fragments-limitations

Nesta página: analise as principais considerações e etapas de solução de problemas dos Fragmentos de conteúdo do Adobe Experience Manager no Journey Optimizer, abrangendo tipos de fragmento, conteúdo multilíngue, acesso a repositório, personalização e erros comuns.

Principais considerações considerations

Lembre-se do seguinte ao usar Fragmentos de conteúdo de Adobe Experience Manager em Journey Optimizer:

  • Tipos de fragmento de conteúdo

    • Fragmentos de conteúdo simples, fragmentos de conteúdo aninhados e variações de fragmento de conteúdo são suportados. Escolha a variação ao inserir o fragmento em Journey Optimizer. Se você não selecionar uma variação, a variação Principal (o conteúdo principal do fragmento em Adobe Experience Manager) será usada.
  • Conteúdo multilíngue

    • Cada variação deve ser criada, marcada e publicada em Adobe Experience Manager. Em Journey Optimizer, selecione a variação de fragmento que corresponde a cada idioma ou localidade da mensagem.
    • Não há resolução automática de idioma ou fallback entre variações.
  • Acesso ao repositório

    • Journey Optimizer integra-se somente à camada Adobe Experience Manager Publicar (Sites, Fragmentos de conteúdo). Os fragmentos de conteúdo estão disponíveis por meio de um endpoint público não autenticado.
    • Repositórios de autor podem aparecer no seletor de repositório, mas somente fragmentos publicados em Publicar podem ser usados em Journey Optimizer.
  • Status do fragmento de conteúdo

    • Os fragmentos podem mostrar o status Publicado ou Modificado; Journey Optimizer sempre usa a última versão publicada.
    • As alterações feitas após a publicação não são refletidas em Journey Optimizer até que o fragmento seja republicado em Adobe Experience Manager. Não há reconciliação automática de versão entre os dois produtos.
  • Personalização

    • Compatível: atributos de perfil, atributos contextuais, cadeias de caracteres estáticas e variáveis pré-declaradas.
    • Não suportado: atributos derivados ou computados.
  • Atualizações e controle de versão

    • As atualizações exigem republicação manual de Adobe Experience Manager. Não há reconciliação automática de versão.
    • Quando um Fragmento de Conteúdo é publicado ou republicado em Adobe Experience Manager, o Journey Optimizer atualiza esse fragmento e atualiza todas as variações desse fragmento referenciadas em campanhas ou jornadas ativas.
    • A Adobe Experience Manager ação de publicação pode ser atrasada. Quando a tarefa for concluída, Journey Optimizer receberá um evento e atualizará o conteúdo.
    • Após uma atualização bem-sucedida, as alterações normalmente ficam disponíveis em cerca de 5 minutos para jornadas unitárias e no próximo lote para casos de uso em lote.
  • Armazenamento em cache e revisão de texto

    • Quando um fragmento é adicionado pela primeira vez a uma campanha ou jornada, o Journey Optimizer o armazena em cache. Se você selecionar um fragmento que já foi usado em outro lugar por meio do Abrir Supervisor de Conteúdo do AEM, ele será carregado do cache do Journey Optimizer.
    • Depois de republicar um fragmento modificado no Adobe Experience Manager, o Journey Optimizer acompanha o evento e atualiza o cache.
    • As provas sempre refletem a versão publicada mais recentemente; não é possível bloquear uma versão histórica para revisão.

Solução de problemas troubleshooting

Se você encontrar problemas ao trabalhar com fragmentos de conteúdo do Adobe Experience Manager no Journey Optimizer, consulte os seguintes problemas e resoluções comuns:

Problema
Causa
Resolução
Tag não encontrada ou Fragmento de Conteúdo não visível no seletor
A sintaxe da marca Adobe Experience Manager não corresponde ao formato necessário ajo-enabled:{OrgId}/{SandboxName}
Valide se a ID da marca usa a ID da Organização e o Nome da Sandbox corretos. Verifique se não há espaços ou separadores incorretos. Publique novamente o fragmento de conteúdo depois de corrigir a tag.
O fragmento do conteúdo não aparece na lista
O fragmento de conteúdo está em estado de rascunho ou não foi publicado
Somente os Fragmentos de conteúdo aprovados e publicados são exibidos no seletor do Journey Optimizer. Publique o fragmento de conteúdo no Adobe Experience Manager e verifique se ele tem o status publicado.
Erro indefinido de variável
Espaço reservado do Personalization não declarado na tag auxiliar do fragmento
Adicione todos os parâmetros necessários na tag auxiliar do fragmento. Cada espaço reservado usado no fragmento de conteúdo deve ser declarado explicitamente com seu mapeamento.
A prova exibe um conteúdo inesperado
A prova usa a versão publicada mais recente do Adobe Experience Manager
As provas sempre refletem a publicação mais recente do fragmento de conteúdo no Adobe Experience Manager. Se você tiver feito alterações recentes no Adobe Experience Manager, republique o fragmento e atualize a prova.
Erro de CPES (Acesso negado)
Função de usuário não autorizada a acessar determinados atributos
Entre em contato com o administrador do sistema para verificar se sua função tem as permissões apropriadas para o perfil ou atributos contextuais usados na personalização.
O fragmento exibe conteúdo em branco ou ausente
Parâmetros de personalização obrigatórios ou valores de fallback ausentes
Verifique se todos os parâmetros necessários foram fornecidos e considere adicionar valores de fallback para atributos opcionais.
A imagem não é renderizada ou parece corrompida
O URL da imagem no fragmento de conteúdo é um caminho relativo ou não está acessível pelo canal
Use URLs absolutos (https://...) para campos de imagem. Os caminhos relativos do Adobe Experience Manager não são compatíveis. Confirme o URL em um navegador ou pré-visualização de mensagem.
O link do Experience League AEM retorna 404
Favorito obsoleto, pré-visualização da criação ou página de ajuda não publicada do AEM
Abra o tópico Fragmentos de conteúdo com o Adobe Journey Optimizer da documentação do Live Experience Manager e navegue a partir do sumário na página ou pesquise o nome da seção (por exemplo, Configuração do Dispatcher).

Se o problema persistir, entre em contato com o representante da Adobe com detalhes sobre a ID do fragmento de conteúdo, a campanha ou a ID da jornada e quaisquer mensagens de erro exibidas.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page lists the key considerations and troubleshooting steps for Adobe Experience Manager Content Fragments in Journey Optimizer, covering fragment types, multilingual content, repository access, personalization, updates, caching, and common errors.

Intents:

  • Understand which Content Fragment types and variations are supported
  • Plan multilingual content when there is no automatic language fallback
  • Know that Journey Optimizer integrates with the Publish tier only
  • Identify which personalization inputs are supported
  • Understand update, versioning, caching, and proofing behavior
  • Diagnose common errors such as missing tags, undefined variables, and broken images

Glossary:

  • Content Fragment variation: An alternative version of a fragment selected when inserting it; if none is selected, the Main variation is used (product-specific)
  • Main variation: The fragment’s primary content in Adobe Experience Manager, used when no variation is selected (product-specific)
  • Publish tier: The Adobe Experience Manager tier Journey Optimizer integrates with, exposing Content Fragments through a public, unauthenticated endpoint (product-specific)
  • Access denied (CPES) error: An error indicating the user role is not authorized to access certain profile or contextual attributes used in personalization (product-specific)
  • Proof: A preview that always reflects the most recently published version of the Content Fragment (product-specific)

Guardrails:

  • Journey Optimizer integrates with the Adobe Experience Manager Publish tier only; Content Fragments are available through a public, unauthenticated endpoint. Author repositories may appear in the selector, but only fragments published to Publish can be used.
  • Personalization supports profile attributes, contextual attributes, static strings, and pre-declared variables; derived or computed attributes are not supported.
  • There is no automatic language resolution or fallback between variations; each variation must be authored, tagged, and published in Adobe Experience Manager.
  • Updates require manual republication from Adobe Experience Manager; there is no automatic version reconciliation.
  • After a successful update, changes are typically available within about 5 minutes for unitary journeys and in the next batch for batch use cases.
  • Proofs always reflect the most recently published version; you cannot lock a historical version for proofing.
  • Only approved and published Content Fragments are displayed in the Journey Optimizer selector.
  • The Adobe Experience Manager tag must use the format ajo-enabled:{OrgId}/{SandboxName} with the correct Organization ID and Sandbox Name and no spaces or incorrect separators.
  • Image fields must use absolute URLs (https://...); relative paths from Adobe Experience Manager are not supported.

Terminology:

  • Canonical name: Content Fragment — Acronym: n/a — variants: AEM Content Fragment, fragment
  • Synonyms: “Main” = “Main variation”
  • Do not confuse: “Published” (a Content Fragment status Journey Optimizer surfaces) ≠ “Modified” (a status Journey Optimizer also surfaces, still using the latest published version)

FAQ:

  • Q: Which Adobe Experience Manager tier does Journey Optimizer use for Content Fragments? — The Publish tier only; fragments are available through a public, unauthenticated endpoint, and only fragments published to Publish can be used.
  • Q: What personalization is not supported in Content Fragments? — Derived or computed attributes; supported inputs are profile attributes, contextual attributes, static strings, and pre-declared variables.
  • Q: How long after publishing are changes available? — Typically within about 5 minutes for unitary journeys and in the next batch for batch use cases, after manual republication in Adobe Experience Manager.
  • Q: Why is my Content Fragment not visible in the selector? — The tag syntax may not match ajo-enabled:{OrgId}/{SandboxName}, or the fragment may be in draft or unpublished state; correct the tag and republish, and ensure the fragment is approved and published.
  • Q: Why does an image in my Content Fragment not render? — The image URL may be a relative path; use absolute URLs (https://...), since relative paths from Adobe Experience Manager are not supported.
  • Q: Can I proof a specific historical version of a fragment? — No; proofs always reflect the most recently published version and you cannot lock a historical version for proofing.
recommendation-more-help
journey-optimizer-help