Utilizzare i frammenti di contenuto di Adobe Experience Manager aem-fragments

AVAILABILITY
Questa integrazione si applica a Adobe Experience Manager as a Cloud Service Sites, solo per Frammenti di contenuto. Journey Optimizer legge i frammenti dal livello Pubblica (non Autore).

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

  1. Configura Dispatcher: per consentire a Journey Optimizer di accedere ai frammenti di contenuto di Adobe Experience Manager tramite l'API di gestione dei frammenti di contenuto, è necessario prima configurare Dispatcher. Questo è un prerequisito per l’integrazione.

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

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

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

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

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

Quando un frammento di contenuto viene pubblicato in Adobe Experience Manager, viene inviato un evento per aggiornare il contenuto sul lato Journey Optimizer. Se l’aggiornamento ha esito positivo, il frammento di contenuto diventa disponibile entro circa 5 minuti per i percorsi unitari e nel batch di elaborazione successivo per i casi di utilizzo batch. Quando l’aggiornamento è disponibile in Journey Optimizer, il contenuto pubblicato più recente viene utilizzato in tutte le campagne e i percorsi applicabili.

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 Extended Security for Healthcare.

Creare e assegnare un tag in Experience Manager

IMPORTANT
Per consentire a Journey Optimizer di accedere ai frammenti di contenuto di Adobe Experience Manager tramite l'API di gestione dei frammenti di contenuto, devi prima configurare Dispatcher.

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. Sfoglia l'elenco e seleziona un frammento di contenuto da importare nel contenuto di Journey Optimizer.

    note note
    NOTE
    Se il frammento contiene una o più varianti di published, nel selettore viene visualizzato il menu a discesa Variante. Se non è selezionata alcuna variante, la variante principale viene utilizzata automaticamente. Ulteriori informazioni in Utilizzo delle varianti di frammenti di contenuto.
  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 aggiungerlo.

  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 rendere visibile un URL immagine memorizzato in un attributo del frammento di contenuto, ad esempio un percorso o un campo URL dal modello del frammento, inseriscilo nel HTML con un tag <img> e l’attributo del frammento come origine, ad esempio:

    code language-html
    <img src="[insert your AEM Content Fragment attribute here]">
    
    note note
    NOTE
    Gli URL relativi dell'immagine da Adobe Experience Manager non sono supportati, utilizza URL assoluti.
  11. Seleziona Pillole: disattivato per abilitare l'esperienza pillole per migliorare la leggibilità nascondendo percorsi attributo lunghi.

  12. Per utilizzare segnaposto di personalizzazione creati in Adobe Experience Manager all'interno del testo del frammento, definirli nel frammento di contenuto in Adobe Experience Manager nel modo seguente: {{name}}.

    In Journey Optimizer, questi token sono segnaposto. Con l'esperienza pillole attivata, vengono visualizzate nella sezione Frammento di contenuto di AEM della barra a destra insieme ai campi del frammento.

  13. 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. Mappa tali segnaposto agli attributi di profilo, agli attributi contestuali, alle stringhe statiche o alle variabili predefinite come segue:

    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 mese è mappato all'attributo profile.person.bornDate all'interno del frammento.

    {modal="regular"}

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

Utilizzo delle varianti di frammenti di contenuto aem-variations

In Adobe Experience Manager, ogni frammento di contenuto è costituito dai seguenti elementi:

  • Principale: il contenuto principale del frammento, che esiste sempre, non può essere eliminato e costituisce la base per tutte le varianti.
  • Varianti: una o più permutazioni di Principale create dagli autori per canali o scenari specifici. Le varianti risiedono all'interno del frammento non come risorse separate e possono essere confrontate e sincronizzate con Principale.

Esempi di casi di utilizzo di varianti:

  • Una versione breve della copia per una notifica push e una versione più lunga per l’e-mail.
  • Regolazioni del tono regionali senza creare un frammento separato.
  • Messaggistica specifica per il canale (ad esempio, web rispetto a mobile).

➡️ Ulteriori informazioni nella documentazione di Adobe Experience Manager

Journey Optimizer consente di scegliere la variante da utilizzare quando si inserisce un frammento, in modo che campagne o percorsi diversi possano fare affidamento su rappresentazioni diverse dello stesso contenuto sorgente in Adobe Experience Manager senza duplicare i frammenti.

Per selezionare una variante:

  1. Apri una campagna o percorso.

  2. Fai clic sull'icona Personalization in un campo di testo oppure apri l'origine HTML da un componente di contenuto HTML.

  3. Da Frammento di contenuto AEM, fare clic su Apri selettore CF.

  4. Per selezionare un frammento di contenuto di Adobe Experience Manager specifico per le impostazioni internazionali nella vista tabella, utilizzare Personalizza tabella per aggiungere la colonna Lingua. I valori delle impostazioni internazionali vengono visualizzati nella tabella, consentendo di identificare e selezionare il frammento appropriato.

  5. Seleziona il frammento di contenuto.

  6. Fai clic sull'icona informazioni per aprire il menu Dettagli. Se il frammento ha una o più varianti pubblicate, accanto ai dettagli del frammento viene visualizzato un menu a discesa Variante.

  7. Dal menu Dettagli rapidi, fai clic su Esplora riferimenti per aprire le opzioni correlate in Adobe Experience Manager per i dettagli della variante, l'anteprima e la bozza, se disponibili.

  8. Scegli la tua variante, quindi fai clic su Seleziona.

    note note
    NOTE
    Se non selezioni una variante o se il frammento è stato aggiunto prima che il supporto della variante fosse disponibile, Journey Optimizer utilizza automaticamente la variante Principale al momento della consegna.

Dopo aver inserito un frammento con una variante, la ripubblicazione in Adobe Experience Manager aggiorna automaticamente ogni variante a cui si fa riferimento nelle campagne o nei percorsi attivi. Le anteprime e le bozze utilizzano ancora la variante scelta, con il contenuto pubblicato più recente per tale variante.

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