DocumentazioneJourney OptimizerGuida di Journey Optimizer

Frammenti di contenuto di Adobe Experience Manager aem-fragments

Last update: Tue Dec 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Utente

Integrando Adobe Experience Manager as a Cloud Service con Adobe Journey Optimizer, ora puoi incorporare facilmente i frammenti di contenuto AEM nei contenuti Journey Optimizer. Questa connessione diretta facilita il processo di accesso e utilizzo dei contenuti AEM, consentendo la creazione di campagne e percorsi personalizzati e dinamici.

Per ulteriori informazioni sui frammenti di contenuto di AEM, consulta Utilizzo dei frammenti di contenuto nella documentazione di Experience Manager.

Prima di iniziare start

AVAILABILITY
Per i clienti del settore sanitario, l'integrazione è abilitata solo dopo aver concesso in licenza le offerte aggiuntive Journey Optimizer Healthcare Shield e Adobe Experience Manager Enhanced Security.

Limitazioni limitations

Quando si lavora con frammenti di contenuto Adobe Experience Manager in Journey Optimizer, tieni presente le seguenti limitazioni:

  • Tipi di frammenti di contenuto: sono supportati solo frammenti di contenuto semplici. Le varianti e i frammenti nidificati non sono attualmente supportati.

  • Contenuto multilingue: è supportato solo il flusso manuale.

  • Personalization: sono supportati solo gli attributi di profilo, gli attributi contestuali, le stringhe statiche e le variabili predichiarate. Gli attributi derivati o calcolati non sono supportati.

  • Aggiornamenti e controllo delle versioni: gli aggiornamenti dei frammenti di contenuto richiedono la ripubblicazione manuale da Adobe Experience Manager. Non esiste riconciliazione automatica delle versioni tra Adobe Experience Manager e Journey Optimizer.

  • Memorizzazione in cache: Journey Optimizer recupera i frammenti di contenuto in tempo reale da Adobe Experience Manager Publish. Non esiste alcun caching pre-rendering.

  • Strumenti di correzione: la bozza per campagne e percorsi pubblicati riflette i dati della pubblicazione più recente dei frammenti di contenuto di Experience Manager. Nessun blocco di versione cronologico.

  • Accesso utente: si consiglia di limitare il numero di utenti con accesso alla pubblicazione di frammenti di contenuto per ridurre il rischio di errori accidentali.

Flusso di sincronizzazione dei contenuti content-sync-flow

L’integrazione tra Adobe Experience Manager e Journey Optimizer segue questo flusso di dati:

  1. Crea e crea: il contenuto viene creato e configurato in Adobe Experience Manager come frammenti di contenuto.

  2. Assegnazione tag: i frammenti di contenuto devono essere contrassegnati con il tag specifico di Journey Optimizer (ajo-enabled:{OrgId}/{SandboxName}).

  3. Pubblicazione: i frammenti di contenuto vengono pubblicati in Adobe Experience Manager, rendendoli disponibili in Journey Optimizer.

  4. Accesso: Journey Optimizer recupera e visualizza in tempo reale i frammenti di contenuto disponibili dall'istanza Adobe Experience Manager Publish.

  5. Integrazione: i frammenti di contenuto sono selezionati e integrati in campagne o percorsi.

Creare e assegnare un tag in Experience Manager

Prima di utilizzare il frammento di contenuto in Journey Optimizer, è necessario creare un tag specifico per Journey Optimizer:

  1. Accedi al tuo ambiente Experience Manager.

  2. Dal menu Strumenti, seleziona Assegnazione tag.

  3. Fare clic su Crea tag.

  4. Verificare che l'ID sia conforme alla sintassi seguente: ajo-enabled:{AJO-OrgId}/{AJO-SandboxName}.

  5. Fai clic su Crea.

  6. Definisci il modello per frammenti di contenuto come descritto nella documentazione di Experience Manager e assegna il nuovo tag Journey Optimizer creato.

Questa connessione in tempo reale garantisce che il contenuto sia sempre aggiornato, ma significa anche che eventuali modifiche ai frammenti pubblicati influiranno immediatamente sulle campagne e sui percorsi attivi.

Ora puoi iniziare a creare e configurare il frammento di contenuto per un utilizzo successivo in Journey Optimizer. Ulteriori informazioni sono disponibili nella documentazione di Experience Manager.

Aggiungere frammenti di contenuto Experience Manager aem-add

Dopo aver creato e personalizzato i frammenti di contenuto di AEM, puoi importarli nella campagna o nel percorso di ottimizzazione del Percorso.

  1. Crea la tua campagna o Percorso.

  2. Per accedere al frammento di contenuto AEM, fai clic sull' icona Personalization in un campo di testo qualsiasi oppure apri il codice sorgente tramite un componente di contenuto HTML.

  3. Dal menu Frammento di contenuto di AEM nel riquadro a sinistra, fare clic su Apri selettore CF di AEM.

  4. Seleziona un frammento di contenuto dall'elenco disponibile per l'importazione nel contenuto di Journey Optimizer.

  5. Fai clic su Mostra filtri per ottimizzare l'elenco dei frammenti di contenuto.

    Per impostazione predefinita, il filtro Frammento di contenuto è predefinito per visualizzare solo il contenuto approvato.

  6. Dopo aver selezionato il frammento di contenuto, fai clic su Seleziona per aprirlo.

  7. Fai clic su Visualizza frammento per visualizzare le informazioni sul frammento. L'apertura del menu Informazioni frammento comporta l'attivazione della modalità di sola lettura per l'editor.

    Seleziona Anteprima dal menu di destra per visualizzare il frammento in Adobe Experience Manager.

  8. Fai clic sull' icona Altre azioni per accedere al menu avanzato del frammento:

    • Scambia frammento
    • Esplora riferimenti
    • Apri in AEM

  9. Scegli i campi desiderati dal frammento da aggiungere al contenuto.

  10. Per abilitare la personalizzazione in tempo reale, tutti i segnaposto utilizzati all'interno di un frammento di contenuto devono essere dichiarati esplicitamente dall'utente come parametri nel tag helper del frammento. Puoi mappare questi segnaposto ad attributi di profilo, attributi contestuali, stringhe statiche o variabili predefinite utilizzando i metodi seguenti:

    1. Mappatura attributi contestuali o di profilo: assegnare il segnaposto a un attributo contestuale o di profilo, ad esempio nome = profile.person.name.firstName.

    2. Mappatura stringa statica: assegna un valore stringa fisso inserendolo tra virgolette doppie, ad esempio nome = "John".

    3. Mappatura variabile: fare riferimento a una variabile dichiarata in precedenza all'interno dello stesso HTML, ad esempio name = 'variableName'.
      In questo caso, assicurati che variableName sia dichiarato prima di aggiungere l'ID frammento, utilizzando la seguente sintassi:

      code language-html 
      {% let variableName = attribute name %}

    Nell'esempio seguente, il segnaposto name è mappato all'attributo profile.person.name.firstName all'interno del frammento.

    {modal="regular"}

  11. Fai clic su Salva. Ora puoi testare e controllare il contenuto del messaggio come descritto in questa sezione.
    Dopo aver eseguito i test e convalidato il contenuto, puoi inviare la tua campagna o pubblicare il percorso al tuo pubblico.

Adobe Experience Manager consente di identificare le campagne o i percorsi Journey Optimizer in cui viene utilizzato un frammento di contenuto. Ulteriori informazioni sono disponibili nella documentazione di Adobe Experience Manager.

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 approvato
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 approvato.
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.

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.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76