Considérations et résolution des problèmes aem-fragments-limitations

Sur cette page : passez en revue les principales considérations et étapes de dépannage pour les fragments de contenu Adobe Experience Manager dans Journey Optimizer, notamment les types de fragment, le contenu multilingue, l’accès au référentiel, la personnalisation et les erreurs courantes.

Considérations principales considerations

Tenez compte des points suivants lors de l’utilisation de fragments de contenu Adobe Experience Manager dans Journey Optimizer :

  • Types de fragment de contenu

    • Les fragments de contenu simples, les fragments de contenu imbriqués et les variations de fragment de contenu sont pris en charge. Sélectionnez la variation lorsque vous insérez le fragment dans Journey Optimizer. Si vous ne sélectionnez pas de variation, la variation Contenu principal (le contenu principal du fragment dans Adobe Experience Manager) est utilisée.
  • Contenu multilingue

    • Chaque variation doit être créée, balisée et publiée dans Adobe Experience Manager. Dans Journey Optimizer, sélectionnez la variation de fragment correspondant à chaque langue ou paramètre régional du message.
    • La langue n’est pas résolue automatiquement et aucun contenu de remplacement n’est utilisé entre les variations.
  • Accès au référentiel

    • Journey Optimizer s’intègre uniquement au niveau Adobe Experience Manager Publier (sites, fragments de contenu). Les fragments de contenu sont disponibles via un point d’entrée public non authentifié.
    • Les référentiels de création peuvent apparaître dans le sélecteur de référentiels, mais seuls les fragments publiés sur Publier peuvent être utilisés dans Journey Optimizer.
  • Statut du fragment de contenu

    • Les fragments peuvent afficher le statut Publié ou Modifié. Journey Optimizer utilise toujours la dernière version publiée.
    • Les modifications apportées après la publication ne sont pas répercutées dans Journey Optimizer tant que le fragment n’a pas été republié dans Adobe Experience Manager. Il n’existe pas de réconciliation de version automatique entre les deux produits.
  • Personnalisation

    • Pris en charge : attributs de profil, attributs contextuels, chaînes statiques et variables prédéclarées.
    • Non pris en charge : attributs dérivés ou calculés.
  • Mises à jour et contrôle de version

    • Les mises à jour nécessitent une republication manuelle à partir de Adobe Experience Manager. Il n’existe pas de réconciliation de version automatique.
    • Lorsqu’un fragment de contenu est publié ou republié dans Adobe Experience Manager, Journey Optimizer le met à jour et actualise toutes les variations de ce fragment qui sont référencées dans les campagnes actives ou les parcours actifs.
    • L’action de publication Adobe Experience Manager peut être retardée. Une fois l’opération terminée, Journey Optimizer reçoit un événement et actualise le contenu.
    • Après la mise à jour, les modifications sont généralement disponibles dans les 5 minutes environ pour les parcours unitaires, et lors du prochain lot pour les cas d’utilisation par lots.
  • Mise en cache et relecture

    • Lorsqu’un fragment est ajouté pour la première fois à une campagne ou un parcours, Journey Optimizer le met en cache. Si vous sélectionnez un fragment qui a déjà été utilisé ailleurs via Ouvrir le conseiller en contenu AEM, il est chargé à partir du cache Journey Optimizer.
    • Après avoir republié un fragment modifié dans Adobe Experience Manager, Journey Optimizer écoute l’événement et met à jour le cache.
    • Les BAT reflètent toujours la version la plus récemment publiée. Vous ne pouvez pas verrouiller une version historique pour la relecture.

Résolution des problèmes troubleshooting

Si vous rencontrez des problèmes lors de l’utilisation de fragments de contenu Adobe Experience Manager dans Journey Optimizer, reportez-vous aux problèmes/résolutions suivants :

Problème
Cause
Résolution
Balise introuvable ou fragment de contenu non visible dans le sélecteur
La syntaxe de la balise Adobe Experience Manager ne correspond pas au format requis ajo-enabled:{OrgId}/{SandboxName}.
Vérifiez que l’ID de balise utilise l’ID d’organisation et le Nom de sandbox corrects. Vérifiez qu’il n’y a pas d’espaces ou de séparateurs incorrects. Republiez le fragment de contenu après avoir corrigé la balise.
Le fragment de contenu n’apparaît pas dans la liste.
Le fragment de contenu est à l’état de brouillon ou n’est pas publié.
Seuls les fragments de contenu approuvés et publiés s’affichent dans le sélecteur Journey Optimizer. Publiez le fragment de contenu dans Adobe Experience Manager et assurez-vous que son statut est Publié.
Erreur de variable non définie
Espace réservé de personnalisation non déclaré dans la balise d’assistant de fragment
Ajoutez tous les paramètres requis dans la balise d’assistant de fragment. Chaque espace réservé utilisé dans le fragment de contenu doit être explicitement déclaré avec son mappage.
Le BAT affiche un contenu inattendu.
Le BAT utilise la dernière version publiée d’Adobe Experience Manager.
Les BAT reflètent toujours la publication la plus récente du fragment de contenu dans Adobe Experience Manager. Si vous avez récemment apporté des modifications à Adobe Experience Manager, republiez le fragment et actualisez votre BAT.
Erreur de refus d’accès (CPES)
Rôle d’utilisateur ou d’utilisatrice non autorisé à accéder à certains attributs
Contactez votre administrateur ou administratrice système pour vérifier que votre rôle dispose des autorisations appropriées pour le profil ou les attributs contextuels utilisés dans la personnalisation.
Le fragment affiche du contenu vide ou manquant.
Paramètres de personnalisation requis ou valeurs de secours manquants
Assurez-vous que tous les paramètres requis sont fournis et envisagez d’ajouter des valeurs de secours pour les attributs facultatifs.
Le rendu de l’image n’est pas générée ou l’image semble endommagée.
L’URL de l’image dans le fragment de contenu est un chemin relatif ou est inaccessible à partir du canal.
Utilisez des URL absolues (https://...) pour les champs d’image. Les chemins relatifs depuis Adobe Experience Manager ne sont pas pris en charge. Confirmez l’URL dans un navigateur ou un aperçu du message.
Le lien Experience League AEM renvoie 404.
Signet obsolète, version d’aperçu ou page d’aide d’AEM dépubliée
Ouvrez la rubrique Fragments de contenu avec Adobe Journey Optimizer de la documentation Experience Manager active et accédez à la table des matières de la page, ou recherchez le nom de la section (par exemple, Configuration de Dispatcher).

Si le problème persiste, contactez votre représentant ou représentante Adobe avec des détails sur votre identifiant de fragment de contenu, votre identifiant de campagne ou de parcours, ainsi que tout message d’erreur affiché.

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