Esportazione di frammenti di esperienza in Adobe Target exporting-experience-fragments-to-adobe-target

CAUTION
  • I Frammenti di esperienza AEM vengono esportati nell’area di lavoro predefinita di Adobe Target.
  • AEM deve essere integrato con Adobe Target secondo le istruzioni contenute in Integrazione con Adobe Target.

Puoi esportare i Frammenti di esperienza creati in Adobe Experience Manager as a Cloud Service (AEM) in Adobe Target (Target). Puoi quindi utilizzarli come offerte nelle attività di Target, per testare e personalizzare le esperienze su larga scala.

Sono disponibili tre opzioni per esportare un Frammento di esperienza in Adobe Target:

  • HTML (predefinito): supporto per la distribuzione di contenuti web e ibridi
  • JSON: supporto per la distribuzione di contenuti headless
  • HTML e JSON

Per preparare la tua istanza per l’esportazione di Frammenti di esperienza AEM in Adobe Target, devi:

Dopo di che puoi:

I Frammenti di esperienza possono essere esportati nell’area di lavoro predefinita o in aree di lavoro definite dall’utente in Adobe Target.

NOTE
Le aree di lavoro di Adobe Target non sono già esistenti in Adobe Target. Vengono definite e gestite in Adobe IMS (Identity Management System), quindi selezionate per l’utilizzo nelle soluzioni tramite la console Adobe Developer.
NOTE
Le aree di lavoro di Adobe Target possono essere utilizzate per consentire ai membri di un’organizzazione (gruppo) di creare e gestire offerte e attività riservate all’organizzazione; senza dare accesso ad altri utenti. Ad esempio, organizzazioni specifiche per paese nell'ambito di un’azienda globale.

Prerequisiti prerequisites

Sono necessarie diverse azioni:

  1. Devi integrare AEM con Adobe Target.

  2. I Frammenti di esperienza vengono esportati dall’istanza di authoring AEM, per cui devi Configurare AEM Link Externalizer nell’istanza di authoring, per garantire che tutti i riferimenti all’interno del Frammento di esperienza siano esternalizzati per la distribuzione web.

    note note
    NOTE
    Per la riscrittura di collegamenti non coperti dall’impostazione predefinita, è disponibile il provider del rewriter di collegamento di Frammento esperienza. Con questo, è possibile sviluppare regole personalizzate per la tua istanza.

Aggiungere la configurazione cloud add-the-cloud-configuration

Prima di esportare un frammento è necessario aggiungere la Configurazione cloud di Adobe Target al frammento o alla cartella. Questo consente anche di:

  • specificare le opzioni di formato da utilizzare per l’esportazione
  • selezionare un’area di lavoro di Target come destinazione
  • selezionare un dominio esternalizzatore per riscrivere i riferimenti nel Frammento di esperienza (facoltativo)

Le opzioni richieste possono essere selezionate in Proprietà pagina della cartella e/o del frammento richiesti; la specifica viene ereditata secondo necessità.

  1. Passa alla console Frammenti di esperienza.

  2. Apri Proprietà pagina per la cartella o il frammento appropriato.

    note note
    NOTE
    Se aggiungi la configurazione cloud alla cartella principale Frammento di esperienza, questa viene ereditata da tutti gli elementi secondari.
    Se aggiungi la configurazione cloud al Frammento di esperienza stesso, questa viene ereditata da tutte le varianti.
  3. Seleziona la scheda Servizi cloud.

  4. Sotto Configurazione servizio cloud, seleziona Adobe Target dall’elenco a discesa.

    note note
    NOTE
    È possibile personalizzare il formato JSON di un’offerta Frammento di esperienza. A questo scopo, definisci un componente Frammento di esperienza cliente e poi annota come esportare le sue proprietà nel modello Sling del componente.
    Vedi il componente core: Componenti core: Frammenti esperienza
  5. Sotto Adobe Target seleziona:

    • la configurazione appropriata
    • l’opzione di formato richiesta
    • un’area di lavoro Adobe Target
    • se necessario, il dominio esternalizzatore
    note caution
    CAUTION
    Il dominio esternalizzatore è facoltativo.
    Un esternalizzatore AEM è configurato quando desideri che il contenuto esportato punti a uno specifico dominio di pubblicazione. Per ulteriori dettagli vedi Configurazione di AEM Link Externalizer.
    Inoltre, i domini esternalizzatori sono rilevanti solo per il contenuto del Frammento di esperienza inviato a Target, e non per i metadati come Visualizza contenuto offerta.

    Ad esempio, per una cartella:

    Cartella - Servizi cloud

  6. Salva e chiudi.

Aggiungere la configurazione precedente add-the-legacy-configuration

IMPORTANT
L’aggiunta di una nuova configurazione precedente è uno scenario speciale supportato solo per l’esportazione di Frammenti di esperienza.

Dopo l’aggiunta della configurazione cloud per utilizzare Experience Platform Launch, per l’integrare iniziale di AEM con Adobe Target, è inoltre necessario eseguire l’integrazione manuale con Adobe Target utilizzando una configurazione precedente.

Creazione di una configurazione cloud di Target creating-a-target-cloud-configuration

Per consentire ad AEM di interagire con Adobe Target, crea una configurazione cloud di Target. Per creare la configurazione, fornisci il codice client Adobe Target e le credenziali utente.

Puoi creare la configurazione cloud di Target una sola volta perché tale configurazione può essere associata a più campagne AEM. Se disponi di diversi codici client Adobe Target, crea una configurazione per ogni codice client.

Puoi impostare la configurazione cloud in modo da sincronizzare i segmenti da Adobe Target. Se abiliti la sincronizzazione, i segmenti vengono importati in background da Target non appena viene salvata la configurazione cloud.

Segui la procedura seguente per creare una configurazione cloud di Target in AEM:

  1. Passa a Servizi cloud precedenti tramite Logo AEM > Strumenti > Servizi cloud > Servizi cloud precedenti.
    Ad esempio: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    Viene visualizzata la pagina Adobe Experience Cloud.

  2. Nella sezione Adobe Target, fai clic su Configura ora.

  3. Nella finestra di dialogo Crea configurazione:

    1. Assegna alla configurazione un Titolo.
    2. Seleziona il modello Configurazione Adobe Target.
    3. Fai clic su Crea.

Ora puoi selezionare la nuova configurazione da modificare.

  1. Viene visualizzata la finestra di dialogo di modifica.

    config-target-settings-dialog

  2. In Impostazioni Adobe Target fornisci i valori per queste proprietà.

    • Autenticazione: per impostazione predefinita, IMS (le credenziali utente sono obsolete)

    • Codice client: il codice client dell’account di Target

    • ID tenant: ID del tenant

    • Configurazione IMS: seleziona la configurazione desiderata dall’elenco a discesa

    • Tipo di API: impostazione predefinita REST (XML è obsoleto)

    • Configurazione A4T Analytics Cloud: seleziona la configurazione cloud di Analytics utilizzata per gli obiettivi e le metriche delle attività di destinazione. È necessario se utilizzi Adobe Analytics come origine per la generazione di rapporti durante il targeting del contenuto.

    • Utilizza targeting accurato: per impostazione predefinita questa casella di controllo è selezionata. Se questa opzione è selezionata, la configurazione del servizio cloud attenderà il caricamento del contesto prima di caricare il contenuto. Vedi la nota che segue.

    • Sincronizza segmenti da Adobe Target: seleziona questa opzione per scaricare i segmenti definiti in Target e utilizzarli in AEM. Seleziona questa opzione quando la proprietà Tipo API è REST, perché i segmenti in linea non sono supportati e devi sempre utilizzare i segmenti da Target. Il termine AEM "segmento" equivale al termine Target "pubblico".

    • Libreria client: questo valore predefinito è AT.js (mbox.js è obsoleto)

      note note
      NOTE
      Il file della libreria di Target, AT.JS, è una nuova libreria di implementazione di Adobe Target progettata sia per le tipiche implementazioni web che per le applicazioni a pagina singola.
      mbox.js è stato dichiarato obsoleto e verrà rimosso in una fase successiva.
      Adobe consiglia di utilizzare AT.js invece di mbox.js come libreria client.
      AT.js offre diversi miglioramenti rispetto alla libreria mbox.js:
      • Tempi di caricamento delle pagine migliorati per le implementazioni web
      • Maggiore sicurezza
      • Migliori opzioni di implementazione per le applicazioni a pagina singola
      • AT.js contiene i componenti inclusi in target.js, quindi non effettua più chiamate a target.js
      Puoi selezionare AT.js o mbox.js nel menu a discesa Libreria client.
    • Utilizza Tag Management System per distribuire la libreria client: seleziona questa opzione per utilizzare la libreria client da Adobe Launch o da un altro sistema di gestione tag (o DTM, che è obsoleto).

    • AT.js personalizzato: sfoglia per caricare il tuo AT.js personalizzato. Lascia vuoto per utilizzare la libreria predefinita.

      note note
      NOTE
      Per impostazione predefinita, quando scegli di accedere alla procedura guidata di configurazione di Adobe Target, il targeting accurato è abilitato.
      Il targeting accurato significa che la configurazione del servizio cloud attende il caricamento del contesto prima di caricare il contenuto. Di conseguenza, in termini di prestazioni, un targeting accurato può creare un ritardo di alcuni millisecondi prima del caricamento del contenuto.
      Il targeting accurato è sempre abilitato nell’istanza di authoring. Tuttavia, nell’istanza di pubblicazione puoi scegliere di disattivare il targeting accurato a livello globale cancellando il segno di spunta accanto a Targeting accurato nella configurazione del servizio cloud (http://localhost:4502/etc/cloudservices.html). Puoi inoltre attivare e disattivare il targeting accurato per i singoli componenti indipendentemente dall’impostazione nella configurazione del servizio cloud.
      Se hai già creato i componenti di destinazione e modificato questa impostazione, le modifiche non influiscono su tali componenti. Devi apportare le modifiche direttamente a tali componenti.
  3. Fai clic su Connetti ad Adobe Target per inizializzare la connessione con Target. Se la connessione ha esito positivo, viene visualizzato il messaggio Connessione riuscita. Fai clic su OK sul messaggio e quindi OK nella finestra di dialogo.

Aggiunta di un framework Target adding-a-target-framework

Dopo aver impostato la configurazione cloud di Target, aggiungi un framework di Target. Il framework identifica i parametri predefiniti inviati ad Adobe Target dai componenti ContextHub. Target utilizza i parametri per determinare i segmenti che si applicano al contesto corrente.

Puoi creare più framework per una singola configurazione di Target. I framework multipli sono utili quando devi inviare un diverso set di parametri a Target per diverse sezioni del sito Web. Crea un framework per ogni set di parametri da inviare. Associa ogni sezione del sito Web al framework appropriato. Nota che una pagina web può utilizzare un solo framework alla volta.

  1. Nella pagina di configurazione di Target, fai clic su + (segno più) accanto a Configurazioni disponibili.

  2. Nella finestra di dialogo Crea framework, specifica un Titolo, seleziona Framework Adobe Target e fai clic su Crea.

    Viene visualizzata la pagina framework. La barra laterale fornisce componenti che rappresentano informazioni provenienti da ContextHub che puoi mappare.

  3. Trascina il componente ClientContext che rappresenta i dati da utilizzare per la mappatura sulla destinazione di rilascio. In alternativa, trascina il componente Archivio ContextHub nel framework.

    note note
    NOTE
    Durante la mappatura, i parametri vengono passati a una mbox tramite stringhe semplici. Non è possibile mappare array da ContextHub.

    Ad esempio, per utilizzare i Dati profilo relativi ai visitatori del sito per controllare la campagna di Adobe Target, trascina il componente Dati profilo nella pagina. Vengono visualizzate le variabili dei dati di profilo disponibili per la mappatura per i parametri di Adobe Target.

  4. Seleziona le variabili da rendere visibili al sistema Adobe Target selezionando la casella di selezione Condividi nelle colonne appropriate.

    note note
    NOTE
    La sincronizzazione dei parametri è solo unidirezionale, cioè da AEM ad Adobe Target.

Il framework viene creato. Per replicare il framework nell’istanza di pubblicazione, utilizza l’opzione Attiva framework dalla barra laterale.

Esportazione di un frammento di esperienza in Adobe Target exporting-an-experience-fragment-to-adobe-target

CAUTION
Per le risorse multimediali, come le immagini, viene esportato solo un riferimento in Target. La risorsa stessa rimane memorizzata in AEM Assets e viene distribuita dall’istanza di pubblicazione AEM.
Per questo motivo è necessario pubblicare il frammento di esperienza con tutte le relative risorse prima di esportarlo in Target.

Per esportare un frammento di esperienza da AEM a Target (dopo aver specificato la configurazione cloud):

  1. Passa alla console Frammenti di esperienza.

  2. Seleziona il frammento di esperienza da esportare in Target.

    note note
    NOTE
    Deve essere una variante Web del frammento di esperienza.
  3. Seleziona Esporta in Adobe Target.

    note note
    NOTE
    Se il frammento di esperienza è già stato esportato, seleziona Aggiorna in Adobe Target.
  4. Seleziona Esporta senza pubblicare o Pubblica secondo necessità.

    note note
    NOTE
    Selezionando Pubblica pubblicherà immediatamente il frammento di esperienza e lo invierà in Target.
  5. Seleziona OK nella finestra di dialogo di conferma.

    Il frammento di esperienza deve ora essere in Target.

    note note
    NOTE
    Vari dettagli dell'esportazione sono visibili in Vista a elenco della console e Proprietà.
    note note
    NOTE
    Quando visualizzi un frammento di esperienza in Adobe Target, la data dell'ultima modifica visualizzata è la data dell’ultima modifica apportata al frammento in AEM, non la data dell’ultima esportazione del frammento in Adobe Target.
NOTE
In alternativa, è possibile eseguire l’esportazione dall’editor di pagine utilizzando comandi comparabili nel menu Informazioni pagina.

Utilizzo dei frammenti di esperienza in Adobe Target using-your-experience-fragments-in-adobe-target

Dopo aver eseguito le attività precedenti, il frammento di esperienza viene visualizzato nella pagina Offerte di Target. Per scoprire come potrai usarlo, consulta la documentazione specifica di Target.

NOTE
Quando visualizzi un frammento di esperienza in Adobe Target, la data dell'ultima modifica visualizzata è la data dell’ultima modifica apportata al frammento in AEM, non la data dell’ultima esportazione del frammento in Adobe Target.

Eliminazione di un frammento di esperienza già esportato in Adobe Target deleting-an-experience-fragment-already-exported-to-adobe-target

L’eliminazione di un frammento di esperienza già esportato in Target potrebbe causare problemi se il frammento è già utilizzato in un’offerta in Target. L’eliminazione del frammento renderebbe l’offerta inutilizzabile mentre il contenuto del frammento è distribuito da AEM.

Per evitare tali situazioni:

  • Se il frammento di esperienza non è attualmente utilizzato in un’attività, AEM consente all’utente di eliminarlo senza un messaggio di avviso.

  • Se il frammento di esperienza è attualmente utilizzato da un’attività in Target, un messaggio di errore avvisa l’utente AEM delle possibili conseguenze che l’eliminazione del frammento avrà sull’attività.

    Il messaggio di errore in AEM non impedisce all’utente di (forzare) eliminare il frammento di esperienza. Se il frammento di esperienza viene eliminato:

    • L’offerta Target con il frammento di esperienza AEM può mostrare un comportamento indesiderato

      • L'offerta sarà probabilmente ancora visualizzata, poiché l'HTML del frammento di esperienza è stato inviato su Target
      • Eventuali riferimenti nel frammento di esperienza potrebbero non funzionare correttamente se le risorse di riferimento sono state eliminate anche in AEM.
    • Naturalmente, eventuali ulteriori modifiche al frammento di esperienza sono impossibili in quanto questo non esiste più in AEM.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab