Configurazione manuale dell'integrazione con Adobe Target

È possibile modificare le configurazioni della procedura guidata di consenso o integrare manualmente Adobe Target senza ricorrere alla procedura guidata.

Modifica delle configurazioni della procedura guidata di consenso

La procedura guidata di consenso che integra AEM con Adobe Target crea automaticamente una configurazione cloud Target denominata Provisioning Target Configuration (Configurazione di destinazione con provisioning). La procedura guidata crea inoltre un framework Target per la configurazione cloud denominato Provisioning Target Framework. Se necessario, potete modificare le proprietà della configurazione e della struttura del cloud.

Potete anche configurare Adobe Target per utilizzare Adobe Target come origine di reporting per il targeting del contenuto configurando la configurazione A4T Analytics Cloud Configuration.

Per individuare la configurazione cloud e il framework, andate agli Cloud Services tramite Strumenti > Distribuzione > Cloud. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)Sotto Adobe Target, fate clic o toccate Mostra configurazioni.

Proprietà di configurazione Target con provisioning

I seguenti valori di proprietà vengono utilizzati nella configurazione cloud di configurazione di Target con provisioning creata dalla procedura guidata di consenso:

  • Codice client: Come immesso nella procedura guidata di consenso.

  • E-mail: Come immesso nella procedura guidata di consenso.

  • Password: Come immesso nella procedura guidata di consenso.

  • Tipo API: REST

  • Sincronizza Segmenti Da Adobe Target: Selezionato.

  • Libreria client: mbox.js.

  • Utilizzate DTM per distribuire la libreria client: Non selezionato. Selezionate questa opzione se utilizzate DTM o un altro sistema di gestione tag per ospitare il file mbox.js o AT.js. Adobe consiglia di utilizzare Gestione dinamica dei tag anziché AEM per distribuire la libreria.

  • Custom mbox.js: Nessuno specificato in modo che venga utilizzato il file mbox.js predefinito. Specificate un file mbox.js personalizzato da utilizzare come necessario. Viene visualizzato solo se avete selezionato mbox.js.

  • AT.js personalizzato: Nessuno specificato in modo che venga utilizzato il file AT.js predefinito. Specificate un file AT.js personalizzato da utilizzare come necessario. Viene visualizzato solo se avete selezionato AT.js.

Nota

In AEM 6.3, è possibile selezionare il file della libreria Target, AT.JS, una nuova libreria di implementazione per Adobe Target, progettata sia per implementazioni Web tipiche che per applicazioni a pagina singola.

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 che erano inclusi in target.js, pertanto non esiste più una chiamata a target.js

Proprietà Framework Target con provisioning

Il framework di destinazione con provisioning creato dalla procedura guidata di consenso è configurato per l'invio di dati contestuali dall'archivio dati profilo. Per impostazione predefinita, gli elementi relativi a età e genere dello store vengono inviati a Target. Probabilmente la soluzione richiede l'invio di parametri aggiuntivi.

chlimage_1-158

Potete configurare il framework per inviare ulteriori informazioni di contesto a Target come descritto in Aggiunta di un frameworkTarget.

Configuring A4T Analytics Cloud Configuration

Potete configurare Adobe Target per utilizzare Adobe Analytics come origine di reporting per il targeting del contenuto.

A tal fine, dovete specificare quale configurazione cloud A4T collegare la configurazione cloud Adobe Target con:

  1. Andate agli Cloud Services tramite il logo AEM > Strumenti > Distribuzione > Cloud Services.

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

  3. Riconnettersi alla configurazione Adobe Target .

  4. Nel menu a discesa A4T Configurazione Analytics Cloud, selezionate il framework.

    Nota

    Sono disponibili solo le configurazioni di analisi abilitate per A4T.

    Durante la configurazione di A4T con AEM, potrebbe essere presente una voce di riferimento alla configurazione mancante. Per poter selezionare il framework di analisi, effettuate le seguenti operazioni:

    1. Passare a Strumenti > Generale > CRXDE Lite.
    2. Passa a /libs/cq/analytics/components/testandtargetpage/dialog/items/tab/items/tab1_general/items/a4tAnalyticsConfig
    3. Impostate la proprietà disable su false.
    4. Tap or click Save All.

    chlimage_1-159

    Fai clic su OK. Quando eseguite il targeting del contenuto con Adobe Target, potete selezionare l'originedel rapporto.

Manually Integrating with Adobe Target

Effettuate l'integrazione manuale con Adobe Target invece di utilizzare la procedura guidata di consenso.

Nota

Il file della libreria Target, AT.JS, è una nuova libreria di implementazione per Adobe Target, progettata sia per le implementazioni Web tipiche che per le applicazioni a pagina singola. 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 che erano inclusi in target.js, pertanto non esiste più una chiamata a target.js

Potete selezionare AT.js o mbox.js nel menu a discesa Libreria ​client.

Creazione di una configurazione di Target Cloud

Per abilitare AEM a interagire con Adobe Target, crea una configurazione cloud di Target. Per creare la configurazione, dovete fornire il codice client Adobe Target e le credenziali utente.

Potete creare la configurazione cloud di Target solo una volta, perché potete associare la configurazione a più campagne AEM. Se avete diversi codici client Adobe Target , create una configurazione per ciascun codice client.

Puoi configurare la configurazione cloud per sincronizzare i segmenti da Adobe Target. Se abilitate la sincronizzazione, i segmenti vengono importati in background da Target non appena viene salvata la configurazione cloud.

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

  1. Andate agli Cloud Services tramite il logo AEM > Strumenti > Distribuzione > Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    Viene visualizzata la pagina della panoramica Adobe Marketing Cloud .

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

  3. Nella finestra di dialogo Crea configurazione :

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

    Viene visualizzata la finestra di dialogo di modifica.

    chlimage_1-160

    Nota

    Durante la configurazione di A4T con AEM, potrebbe essere presente una voce di riferimento alla configurazione mancante. Per poter selezionare il framework di analisi, effettuate le seguenti operazioni:

    1. Passare a Strumenti > Generale > CRXDE Lite.
    2. Passa a /libs/cq/analytics/components/testandtargetpage/dialog/items/tab/items/tab1_general/items/a4tAnalyticsConfig
    3. Impostate la proprietà disable su false.
    4. Tap or click Save All.
  4. Nella finestra di dialogo, inserite i valori per queste proprietà.

    • Codice client: il codice client dell'account di destinazione

    • E-mail: l'e-mail dell'account Target.

    • Password: la password dell'account Target.

    • Tipo API: REST o XML

    • Configurazione A4T Analytics Cloud: Seleziona la configurazione cloud di Analytics utilizzata per gli obiettivi e le metriche dell'attività di destinazione. Questo è necessario se utilizzate Adobe Analytics come origine di reporting quando eseguite il targeting del contenuto. Se non visualizzate la configurazione cloud, consultate la nota in Configurazione di A4T configurazioneAnalytics Cloud.

    • Utilizzate targeting accurato: Per impostazione predefinita questa casella di controllo è selezionata. Se selezionata, la configurazione del servizio cloud attende il caricamento del contesto prima di caricare il contenuto. Vedere la nota che segue.

    • Sincronizza segmenti da Adobe Target: Selezionate questa opzione per scaricare i segmenti definiti in Target per utilizzarli in AEM. Devi selezionare 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" è equivalente al termine "audience" di Target.

    • Libreria client: Specificate se desiderate la libreria client mbox.js o AT.js.

    • Utilizza DTM per distribuire la libreria client - Seleziona questa opzione per utilizzare AT.js o mbox.js da DTM o un altro sistema di gestione tag. Per utilizzare questa opzione è necessario configurare l'integrazione di Gestione dinamica dei tag. Adobe consiglia di utilizzare Gestione dinamica dei tag anziché AEM per distribuire la libreria.

    • Custom mbox.js: Lasciate vuoto se avete selezionato la casella Gestione dinamica dei tag o per utilizzare il file mbox.js predefinito. In alternativa, caricate il mbox.js personalizzato. Viene visualizzato solo se avete selezionato mbox.js.

    • AT.js personalizzato: Lasciate vuoto se avete selezionato la casella Gestione dinamica dei tag o per utilizzare il file AT.js predefinito. In alternativa, caricate il vostro AT.js personalizzato. Viene visualizzato solo se avete selezionato AT.js.

    Nota

    Per impostazione predefinita, quando si sceglie di accedere alla procedura guidata di configurazione di Adobe Target, viene attivato il targeting accurato.
    Con targeting accurato, la configurazione del servizio cloud attende che il contesto venga caricato prima di caricare il contenuto. Di conseguenza, in termini di prestazioni, un targeting accurato potrebbe creare un ritardo di alcuni millisecondi prima del caricamento del contenuto.
    Il targeting accurato è sempre abilitato nell'istanza di creazione. Tuttavia, nell’istanza di pubblicazione potete scegliere di disattivare il targeting accurato a livello globale deselezionando il segno di spunta accanto a Accurate Targeting (Impostazione destinazione accurata) nella configurazione del servizio cloud (http://localhost:4502/etc/cloudservices.html). Potete inoltre attivare e disattivare il targeting accurato per i singoli componenti, indipendentemente dall'impostazione nella configurazione del servizio cloud.
    Se avete già creato componenti con targeting e modificate questa impostazione, le modifiche apportate non influiscono su tali componenti. È necessario apportare direttamente modifiche a tali componenti.

  5. Fate clic su Connetti a Target per inizializzare la connessione con Target. Se la connessione ha esito positivo, viene visualizzato il messaggio Connessione riuscita . Fare clic su OK sul messaggio, quindi su OK nella finestra di dialogo.

    Se non riuscite a connettervi a Target, consultate la sezione Risoluzione dei problemi .

Aggiunta di un framework di Target

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

Potete creare più framework per una singola configurazione di Target. Più framework sono utili quando è necessario inviare a Target un set diverso di parametri per diverse sezioni del sito Web. Create un framework per ciascun set di parametri da inviare. Associate ogni sezione del sito Web al framework appropriato. Una pagina Web può utilizzare un solo framework per volta.

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

  2. Nella finestra di dialogo Crea framework, specificate un Titolo, selezionate Adobe Target Framework e fate clic su Crea.

    chlimage_1-161

    Viene visualizzata la pagina del framework. La barra laterale fornisce componenti che rappresentano le informazioni Client Context o ContextHub mappabili dall'utente.

    chlimage_1-162

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

    Nota

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

    Ad esempio, per utilizzare Dati ​profilo sui visitatori del sito per controllare la campagna Target, trascinate il componente Dati ​profilo sulla pagina. Vengono visualizzate le variabili di dati del profilo disponibili per la mappatura ai parametri di Target.

    chlimage_1-163

  4. Selezionate le variabili che desiderate rendere visibili al sistema Adobe Target selezionando la casella di controllo Condividi nelle colonne appropriate.

    chlimage_1-164

    Nota

    La sincronizzazione dei parametri è solo unidirezionale, da AEM a Adobe Target.

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

Associazione di attività con la configurazione di Target Cloud

Associate le attività AEM con la configurazione cloud di Target in modo da poter eseguire il mirroring delle attività in Adobe Target.

Nota

Il tipo di attività disponibile viene stabilito in base ai seguenti elementi:

  • Se l'opzione xt_only è abilitata sul tenant di Adobe Target (clientcode) utilizzato sul lato AEM per connettersi ad Adobe Target, puoi creare solo attività XT in AEM.
  • Se le opzioni xt_only non sono abilitate sul tenant di Adobe Target (clientcode), puoi creare sia le attività XT che A/B in AEM.

Nota aggiuntiva: le opzioni xt_only sono un'impostazione applicata a un determinato tenant Target (clientcode) e possono essere modificate solo direttamente in Adobe Target. Non puoi attivare o disattivare questa opzione da AEM.

Associazione del framework di Target al sito

Dopo aver creato un framework Target in AEM, associate le pagine Web al framework. I componenti di destinazione nelle pagine inviano i dati definiti dal framework a Adobe Target per il tracciamento. Consultate Targeting dei contenuti.

Quando associate una pagina al framework, le pagine figlie ereditano l'associazione.

  1. Nella console Siti , individuate il sito da configurare.

  2. Utilizzando le azioni rapide o la modalità diselezione, selezionate Visualizza proprietà.

  3. Selezionate la scheda Cloud Services .

  4. Tap/click Edit.

  5. Toccate o fate clic su Aggiungi configurazione in Configurazioni ​Cloud Service e selezionate Adobe Target.

    chlimage_1-165

  6. Selezionate il framework desiderato in Riferimento ​configurazione.

    Nota

    Accertatevi di selezionare il framework specifico creato e non la configurazione cloud di Target in cui è stato creato.

  7. Toccate o fate clic su Fine.

  8. Attivate la pagina principale del sito Web per replicarla sul server di pubblicazione. (See How To Publish Pages.)

    Nota

    Se il framework allegato alla pagina non è stato ancora attivato, si apre una procedura guidata che consente di pubblicarlo.

Risoluzione dei problemi di connessione a Target

Per risolvere i problemi che si verificano durante la connessione a Target, effettuate le seguenti operazioni:

  • Verificate che le credenziali utente fornite siano corrette.
  • Assicuratevi che l'istanza AEM possa connettersi al server di Target. Ad esempio, accertatevi che le regole del firewall non blocchino le connessioni AEM in uscita o che AEM configurato per utilizzare i proxy necessari.
  • Cercare messaggi utili nel registro errori AEM. Il file error.log si trova nella directory crx-quickstart/logs in cui è installato AEM.
  • Quando modificate l'attività in Adobe Target, l'URL punta a localhost. Per ovviare a questo problema, impostate l'esternalizzatore AEM sull'URL corretto.

In questa pagina