Esportazione di frammenti di contenuto in Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • I frammenti di contenuto di 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 contenuto 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.

È disponibile l’opzione per esportare un frammento di contenuto in Adobe Target:

  • JSON: supporto per la distribuzione di contenuti headless

Per preparare l’istanza per l’esportazione di frammenti di contenuto AEM in Adobe Target, è necessario:

Dopo di che puoi:

I frammenti di contenuto 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

È necessaria l’azione seguente:

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
  • seleziona un dominio di Externalizer per riscrivere i riferimenti nel frammento di contenuto (facoltativo)

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

  1. Passa alla console Assets.

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

    note note
    NOTE
    Se aggiungi la configurazione cloud alla cartella principale del frammento di contenuto, questa viene ereditata da tutti gli elementi secondari.
    Se aggiungi la configurazione cloud al frammento di contenuto 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 in un frammento di contenuto. A questo scopo, definisci un componente di frammento di contenuto del cliente e poi annota come esportarne le proprietà nel modello Sling del componente.
    Consulta il componente core: Componenti core - Frammenti di contenuto
  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 di Externalizer sono rilevanti solo per il contenuto del frammento di contenuto 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 legacy è lo scenario di un caso speciale supportato solo per l’esportazione di frammenti di contenuto.

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 contenuto in Adobe Target exporting-a-content-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 contenuto, con tutte le relative risorse, prima di esportarlo in Target.

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

  1. Passa al frammento di contenuto nella console Assets.

  2. Seleziona il frammento di contenuto che desideri esportare in Target.

  3. Seleziona Esporta in offerte Adobe Target.

    Esporta in Adobe Target

  4. Seleziona Esporta senza pubblicare o Publish come richiesto.

    note note
    NOTE
    Le azioni effettive visualizzate dipenderanno dallo stato del frammento e delle risorse correlate.
    Se tutto è già stato pubblicato e da allora non è stato modificato nulla, questo passaggio verrà ignorato.
    note note
    NOTE
    Selezionando Pubblica, il frammento di contenuto verrà pubblicato immediatamente e verrà inviato a Target.
  5. Selezionare OK nella finestra di dialogo di conferma.

    Il frammento di contenuto ora dovrebbe trovarsi in Target.

    note note
    NOTE
    Vari dettagli dell’esportazione possono essere visualizzati nella Vista a elenco della console e nelle Proprietà.
    note note
    NOTE
    Quando visualizzi un frammento di contenuto in Adobe Target, la data dell’ultima modifica visualizzata corrisponde alla data dell’ultima modifica apportata al frammento in AEM, non alla 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 contenuto in Adobe Target using-your-content-fragments-in-adobe-target

Dopo aver eseguito le attività precedenti, il frammento di contenuto viene visualizzato nella pagina Offerte di Target. Consulta documentazione specifica di Target per scoprire cosa puoi ottenere.

NOTE
Quando visualizzi un frammento di contenuto in Adobe Target, la data dell’ultima modifica visualizzata corrisponde alla data dell’ultima modifica del frammento in AEM, non alla data dell’ultima esportazione del frammento in Adobe Target.

Eliminazione di un frammento di contenuto già esportato in Adobe Target deleting-a-content-fragment-already-exported-to-adobe-target

Come nel caso dell’esportazione, anche l’eliminazione di un frammento di contenuto da Adobe Target può essere selezionata dalla barra degli strumenti superiore della console Assets una volta selezionato il frammento:

Elimina in Adobe Target

L’eliminazione di un frammento di contenuto già esportato in Target potrebbe causare problemi se il frammento è già utilizzato in un’offerta di 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 contenuto non è attualmente utilizzato in un’attività, AEM consente all’utente di eliminarlo senza alcun messaggio di avviso.

  • Se il frammento di contenuto è 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 eliminare (anche forzatamente) il frammento di contenuto. Se il frammento di contenuto viene eliminato:

    • L’offerta Target con il frammento di contenuto di AEM potrebbe mostrare un comportamento indesiderato

      • L’offerta continuerà ad essere renderizzata, poiché il frammento di contenuto è stato inviato a Target
      • Eventuali riferimenti nel frammento di contenuto potrebbero non funzionare correttamente se le risorse a cui si fa riferimento sono state eliminate anche in AEM.
    • Naturalmente, non è possibile apportare eventuali ulteriori modifiche al frammento di contenuto in quanto questo non esiste più in AEM.

Ulteriori risorse further-resources

Per ulteriori informazioni, consulta:

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