Considerazioni e risoluzione dei problemi aem-fragments-limitations

In questa pagina: rivedi le considerazioni chiave e i passaggi per la risoluzione dei problemi relativi ai frammenti di contenuto Adobe Experience Manager in Journey Optimizer, con informazioni sui tipi di frammenti, sul contenuto multilingue, sull’accesso all’archivio, sulla personalizzazione e sugli errori più comuni.

Considerazioni chiave considerations

Quando si utilizzano frammenti di contenuto di Adobe Experience Manager in Journey Optimizer, tenere presente quanto segue:

  • Tipi di frammenti di contenuto

    • Sono supportati frammenti di contenuto semplici, frammenti di contenuto nidificati e varianti di frammenti di contenuto. Scegliere la variante quando si inserisce il frammento in Journey Optimizer. Se non selezioni una variante, viene utilizzata la variante Main (il contenuto principale del frammento in Adobe Experience Manager).
  • Contenuto multilingue

    • Ogni variante deve essere creata, contrassegnata e pubblicata in Adobe Experience Manager. In Journey Optimizer, selezionare la variante di frammento che corrisponde a ogni lingua o lingua del messaggio.
    • Non esiste alcuna risoluzione automatica della lingua o fallback tra varianti.
  • Accesso all’archivio

    • Journey Optimizer si integra solo con il livello Adobe Experience Manager Pubblica (Sites, Frammenti di contenuto). I frammenti di contenuto sono disponibili tramite un endpoint pubblico non autenticato.
    • Gli archivi dell’autore possono essere visualizzati nel selettore dell’archivio, ma solo i frammenti pubblicati in Pubblica possono essere utilizzati in Journey Optimizer.
  • Stato frammento di contenuto

    • I frammenti possono mostrare lo stato Pubblicato o Modificato; Journey Optimizer utilizza sempre la versione pubblicata più recente.
    • Le modifiche apportate dopo la pubblicazione non verranno applicate in Journey Optimizer finché il frammento non verrà ripubblicato in Adobe Experience Manager. Non è disponibile la riconciliazione automatica delle versioni tra i due prodotti.
  • Personalizzazione

    • Supportato: attributi di profilo, attributi contestuali, stringhe statiche e variabili predichiarate.
    • Non supportato: attributi derivati o calcolati.
  • Aggiornamenti e controllo delle versioni

    • Gli aggiornamenti richiedono la ripubblicazione manuale da Adobe Experience Manager. Non è disponibile la riconciliazione automatica delle versioni.
    • Quando un frammento di contenuto viene pubblicato o ripubblicato in Adobe Experience Manager, Journey Optimizer lo aggiorna e aggiorna tutte le varianti del frammento a cui si fa riferimento nelle campagne o nei percorsi attivi.
    • L’Adobe Experience Manager azione di pubblicazione può essere posticipata. Al termine, Journey Optimizer riceve un evento e aggiorna il contenuto.
    • Dopo un aggiornamento riuscito, le modifiche sono generalmente disponibili entro circa 5 minuti per i percorsi unitari e nel batch successivo per i casi di utilizzo batch.
  • Memorizzazione in cache e verifica

    • Quando un frammento viene aggiunto per la prima volta a una campagna o a un percorso, Journey Optimizer lo memorizza in cache. Se si seleziona un frammento già utilizzato altrove tramite Apri AEM Content Advisor, verrà caricato dalla cache di Journey Optimizer.
    • Dopo aver ripubblicato un frammento modificato in Adobe Experience Manager, Journey Optimizer ascolta l’evento e aggiorna la cache.
    • Le bozze riflettono sempre la versione pubblicata più di recente; non è possibile bloccare una versione cronologica per le bozze.

Risoluzione dei problemi troubleshooting

In caso di problemi durante l’utilizzo di Frammenti di contenuto Adobe Experience Manager in Journey Optimizer, consulta i problemi e le risoluzioni comuni seguenti:

Problema
Causa
Risoluzione
Tag non trovato o Frammento di contenuto non visibile nel selettore
La sintassi del tag Adobe Experience Manager non corrisponde al formato richiesto ajo-enabled:{OrgId}/{SandboxName}
Verificare che l’ID tag utilizzi l’ID organizzazione e il Nome sandbox corretti. Verificare che non siano presenti spazi o separatori non corretti. Ripubblica il frammento di contenuto dopo aver corretto il tag.
Frammento di contenuto non visualizzato nell’elenco
Il frammento di contenuto è in stato Bozza o non pubblicato
Nel selettore Journey Optimizer vengono visualizzati solo i frammenti di contenuto approvati e pubblicati. Pubblica il frammento di contenuto in Adobe Experience Manager e assicurati che abbia lo stato pubblicato.
Errore variabile non definita
Segnaposto Personalization non dichiarato nel tag helper per frammenti
Aggiungi tutti i parametri richiesti nel tag helper per frammenti. Ogni segnaposto utilizzato nel frammento di contenuto deve essere dichiarato in modo esplicito con il relativo mapping.
La bozza visualizza contenuto imprevisto
La bozza utilizza la versione pubblicata più recente da Adobe Experience Manager
Le bozze riflettono sempre la pubblicazione più recente del frammento di contenuto in Adobe Experience Manager. Se hai apportato modifiche recenti in Adobe Experience Manager, ripubblica il frammento e aggiorna la bozza.
Errore di accesso negato (CPES)
Ruolo utente non autorizzato ad accedere ad alcuni attributi
Contatta l’amministratore di sistema per verificare che il tuo ruolo disponga delle autorizzazioni appropriate per gli attributi di profilo o contestuali utilizzati nella personalizzazione.
Il frammento visualizza contenuto vuoto o mancante
Parametri di personalizzazione o valori di fallback richiesti mancanti
Assicurati che siano forniti tutti i parametri richiesti e prendi in considerazione l’aggiunta di valori di fallback per gli attributi facoltativi.
L’immagine non viene riprodotta o appare interrotta
L’URL immagine nel frammento di contenuto è un percorso relativo o non è raggiungibile dal canale
Utilizza URL assoluti (https://...) per i campi immagine. I percorsi relativi da Adobe Experience Manager non sono supportati. Conferma l’URL in un browser o nell’anteprima di un messaggio.
Il collegamento Experience League AEM restituisce 404
Segnalibro non aggiornato, build di anteprima o pagina della guida di AEM non pubblicata
Apri l’argomento Frammenti di contenuto con Adobe Journey Optimizer dalla documentazione live di Experience Manager e passa dal sommario nella pagina oppure cerca il nome della sezione (ad esempio Configurazione Dispatcher).

Se il problema persiste, contatta il rappresentante Adobe con i dettagli relativi all’ID del frammento di contenuto, alla campagna o all’ID percorso ed eventuali messaggi di errore visualizzati.

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