Show Menu
ARGOMENTI×

Integrazione dei visualizzatori Dynamic Media con Adobe Analytics e Adobe Launch

Cos’è l’integrazione dei visualizzatori per contenuti multimediali dinamici con Adobe Analytics e Adobe Launch?

The new Dynamic Media Viewers extension for Adobe Launch, along with the recent release of Dynamic Media Viewers 5.13, lets customers of Dynamic Media, Adobe Analytics, and Adobe Launch to use events and data specific for the Dynamic Media Viewers in their Adobe Launch configuration.
Questa integrazione consente di monitorare l’utilizzo dei visualizzatori per contenuti multimediali dinamici sul sito Web con Adobe Analytics. Allo stesso tempo, potete utilizzare gli eventi e i dati esposti dai visualizzatori con qualsiasi altra estensione Launch proveniente da Adobe o da terzi.
Per ulteriori informazioni sulle estensioni, consulta Adobe Extension nella Guida utente di avvio della piattaforma Experience.
​Chi dovrebbe leggere questa documentazione: Amministratori di siti, sviluppatori sulla piattaforma AEM e quelli nelle operazioni.

Limitazioni dell'integrazione

  • L’integrazione di Adobe Launch per i visualizzatori per contenuti multimediali dinamici non funziona nel nodo di creazione di AEM. Non è possibile visualizzare alcun tracciamento da una pagina WCM finché non viene pubblicata.
  • L’integrazione di Adobe Launch per visualizzatori per contenuti multimediali dinamici non è supportata per la modalità di funzionamento a comparsa, in cui l’URL del visualizzatore viene ottenuto utilizzando il pulsante "URL" nella pagina Dettagli risorsa.
  • L'integrazione di Adobe Launch non può essere utilizzata simultaneamente con l'integrazione dei visualizzatori precedenti di Analytics (tramite il config2= parametro).
  • Il supporto per il tracciamento video è limitato solo al tracciamento della riproduzione di base, come descritto in Panoramica track-core-overview.htmltracciamento. In particolare, il monitoraggio di QoS, Annunci, Capitolo/Segmenti o Errori non è supportato.
  • La configurazione della durata dell'archiviazione per gli elementi dati non è supportata per gli elementi dati che utilizzano l'estensione Dynamic Media Viewers . La durata dell'archiviazione deve essere impostata su Nessuno .

Casi di utilizzo per l'integrazione

L’integrazione con Adobe Launch è un caso d’uso principale per i clienti che utilizzano AEM Assets e AEM Sites. In questi scenari, puoi impostare un’integrazione standard tra il nodo di creazione di AEM e Adobe Launch, quindi associare l’istanza di Siti alla proprietà Adobe Launch. In seguito, qualsiasi componente WCM per contenuti multimediali dinamici aggiunto a una pagina Siti terrà traccia dei dati e degli eventi dei visualizzatori.
Un caso d’uso secondario supportato dall’integrazione sono i clienti che utilizzano solo Risorse AEM o Dynamic Media Classic. In questi casi, potete ottenere il codice da incorporare per il visualizzatore e aggiungerlo alla pagina del sito Web. Quindi, ottenete l’URL di produzione della libreria Adobe Launch da Adobe Launch e aggiungetelo manualmente al codice della pagina Web.

Funzionamento del tracciamento dei dati e degli eventi nell'integrazione

L’integrazione sfrutta due tipi distinti e indipendenti di tracciamento dei visualizzatori per contenuti multimediali dinamici: Adobe Analytics e Adobe Analytics per audio e video .

Informazioni sul tracciamento con Adobe Analytics

Adobe Analytics consente di tenere traccia delle azioni eseguite dall’utente finale quando interagisce con i visualizzatori per contenuti multimediali dinamici presenti sul sito Web. Adobe Analytics consente inoltre di tenere traccia dei dati specifici del visualizzatore. Ad esempio, potete tenere traccia e registrare gli eventi di caricamento della visualizzazione insieme al nome della risorsa, le azioni di zoom che si sono verificate, le azioni di riproduzione video e così via.
In Adobe Launch, i concetti di Elementi ** dati e Regole lavorano insieme per abilitare il tracciamento di Adobe Analytics.

Informazioni su Data Elements in Adobe Launch

Un elemento dati in Adobe Launch è una proprietà denominata il cui valore è definito in modo statico o calcolato in modo dinamico in base allo stato di una pagina Web o ai dati di visualizzatori di contenuti multimediali dinamici.
Le opzioni disponibili per una definizione di elemento dati dipendono dall'elenco delle estensioni installate nella proprietà Adobe Launch. L'estensione "Core" è preinstallata ed è disponibile in qualsiasi configurazione. Questa estensione "Core" consente di definire un elemento dati che proviene da cookie, codice JavaScript, stringa di query e molte altre origini.
Per il tracciamento di Adobe Analytics è necessario installare diverse estensioni aggiuntive, come descritto in Installazione e configurazione delle estensioni . L’estensione dei visualizzatori per contenuti multimediali dinamici consente di definire un elemento dati che rappresenta un argomento dell’evento per visualizzatori dinamici. Ad esempio, è possibile fare riferimento al tipo di visualizzatore, o al nome della risorsa riportato dal visualizzatore al momento del caricamento, al livello di zoom riportato quando l’utente finale effettua uno zoom e molto altro.
Con l’estensione Dynamic Media Viewer i valori degli elementi dati restano automaticamente aggiornati.
Dopo averlo definito, un elemento dati può essere utilizzato in altre aree dell'interfaccia utente di Adobe Launch utilizzando il widget del selettore Elemento dati. In particolare, agli elementi dati definiti ai fini del tracciamento dei visualizzatori per contenuti multimediali dinamici verrà fatto riferimento da Imposta azione variabili dell’estensione Adobe Analytics nella regola (vedi sotto).
Per ulteriori informazioni, consulta Elementi di dati nella Guida utente di Launch della piattaforma Experience.

Informazioni sulle regole in Adobe Launch

Una regola in Adobe Launch è una configurazione agnostica che definisce tre aree che compongono una regola: Eventi , Condizioni e Azioni :
  • Gli eventi (se) informano Adobe Launch quando attivare una regola.
  • Le condizioni (se presente) indicano ad Adobe Launch quali ulteriori restrizioni consentire o rifiutare quando si attiva una regola.
  • Azioni (quindi) per comunicare ad Adobe Launch cosa fare quando si attiva una regola.
Le opzioni disponibili nella sezione Eventi, Condizioni e Azioni dipendono dalle estensioni installate in Adobe Launch Property. L’estensione Core è preinstallata ed è disponibile out-of-the-box in qualsiasi configurazione. L'estensione offre diverse opzioni per gli eventi, ad esempio azioni di base a livello di browser che includono la modifica dello stato attivo, la pressione di tasti, l'invio di moduli e così via. Include inoltre opzioni per Condizioni, come il valore del cookie, il tipo di browser e altro. Per le azioni, è disponibile solo l'opzione Codice personalizzato.
Per il tracciamento di Adobe Analytics, è necessario installare diverse estensioni aggiuntive, come descritto in Installazione e configurazione delle estensioni . In particolare:
  • L’estensione dei visualizzatori per contenuti multimediali dinamici estende l’elenco degli eventi supportati agli eventi specifici per i visualizzatori per contenuti multimediali dinamici quali caricamento del visualizzatore, sostituzione delle risorse, zoom avanti e riproduzione video.
  • L'estensione Adobe Analytics estende l'elenco delle azioni supportate con due azioni necessarie per inviare dati ai server di tracciamento: Imposta variabili e Invia beacon .
Per tenere traccia dei visualizzatori per contenuti multimediali dinamici, è possibile utilizzare uno dei seguenti tipi:
  • Eventi dai visualizzatori per contenuti multimediali dinamici, dalle estensioni core o da qualsiasi altra estensione.
  • Condizioni nella definizione della regola. In alternativa, è possibile lasciare vuota l'area delle condizioni.
Nella sezione Azioni è necessaria un'azione Imposta variabili . Questa azione indica ad Adobe Analytics come compilare le variabili di tracciamento con i dati. Allo stesso tempo, l’azione Imposta variabili non invia nulla al server di tracciamento.
L'azione Imposta variabili deve essere seguita da un'azione Invia beacon . L'azione Invia beacon invia in realtà dati al server di tracciamento analisi. Entrambe le azioni, Set Variables e Send Beacon , provengono dall'estensione Adobe Analytics.
Per ulteriori informazioni, consulta Regole nella Guida utente di Launch della piattaforma Experience.

Configurazione di esempio

La seguente configurazione di esempio in Adobe Launch illustra come tenere traccia del nome di una risorsa al caricamento del visualizzatore.
  1. Dalla scheda Elementi dati, definite un elemento dati AssetName che faccia riferimento asset al parametro dell’ LOAD evento dall’estensione visualizzatori per elementi multimediali dinamici.
  2. Dalla scheda Regole , definire una regola TrackAssetOnLoad .
    In questa regola, il campo Evento utilizza l’evento LOAD dell’estensione dei visualizzatori per contenuti multimediali dinamici.
  3. La configurazione Azione include due tipi di azioni dall'estensione Adobe Analytics:
    Impostate Variabili , che associano una variabile di analisi di vostra scelta al valore di Elemento AssetName dati.
    Invia beacon , che invia informazioni di tracciamento ad Adobe Analytics.
  4. La configurazione della regola risultante sarà simile alla seguente:

Informazioni su Adobe Analytics per audio e video

Quando un account Experience Cloud è sottoscritto per utilizzare Adobe Analytics per audio e video, è sufficiente per abilitare il tracciamento video nelle impostazioni di estensione dei visualizzatori per contenuti multimediali dinamici. Le metriche video diventano disponibili in Adobe Analytics. Il tracciamento video dipende dalla presenza di Adobe Media Analytics per l’estensione Audio e Video.
Al momento, il supporto per il tracciamento video è limitato solo al tracciamento della "riproduzione di base", come descritto in Panoramica track-core-overview.htmltracciamento. In particolare, il monitoraggio di QoS, Annunci, Capitolo/Segmenti o Errori non è supportato.

Utilizzo dell’estensione visualizzatori per contenuti multimediali dinamici

Come indicato in Casi d’uso per l’integrazione , è possibile monitorare i visualizzatori per contenuti multimediali dinamici con la nuova integrazione Adobe Launch in AEM Sites e utilizzando il codice da incorporare.

Tracciamento dei visualizzatori per contenuti multimediali dinamici in AEM Sites

Per tenere traccia dei visualizzatori per contenuti multimediali dinamici in AEM Sites, è necessario eseguire tutti i passaggi elencati nella sezione Configurazione di tutti i componenti di integrazione. In particolare, devi creare la configurazione IMS e Adobe Launch Cloud Configuration.
In base alla configurazione corretta, qualsiasi visualizzatore per contenuti multimediali dinamici aggiunto a una pagina Siti tramite un componente WCM supportato da Dynamic Media tiene traccia automaticamente dei dati in Adobe Analytics, Adobe Analytics per video o entrambi.

Tracciamento dei visualizzatori per contenuti multimediali dinamici tramite codice da incorporare

I clienti che non utilizzano AEM Sites o che incorporano visualizzatori per contenuti multimediali dinamici in pagine Web esterne ad AEM Sites o a entrambi possono comunque utilizzare l'integrazione Adobe Launch.
Devi completare i passaggi di configurazione dalle sezioni Configurazione di Adobe Analytics e Configurazione di Adobe Launch . Tuttavia, i passaggi di configurazione relativi ad AEM non sono necessari.
Dopo la corretta configurazione, potete aggiungere il supporto per Adobe Launch a una pagina Web con un visualizzatore per contenuti multimediali dinamici.
Consultate Aggiungere il codice di incorporamento di Launch per ulteriori informazioni sull’utilizzo del codice di incorporamento della libreria Adobe Launch.
Consultate Incorporamento di video o visualizzatori di immagini in una pagina Web per ulteriori informazioni sull’utilizzo della funzione codice da incorporare di AEM Dynamic Media.
Per tenere traccia dei visualizzatori per contenuti multimediali dinamici mediante il codice incorporato
  1. Tenete pronta una pagina Web per incorporare un visualizzatore per contenuti multimediali dinamici.
  2. Ottenete il codice da incorporare per la libreria Adobe Launch effettuando il login ad Adobe Launch (consultate Configurazione di Adobe Launch ).
  3. Fate clic su Proprietà , quindi sulla scheda Ambienti .
  4. Consente di alzare il livello Ambiente in base all'ambiente della pagina Web. Quindi, nella colonna Installa , fate clic sull'icona della casella.
  5. Nella finestra di dialogo Istruzioni per l'installazione Web, copiate il codice da incorporare della libreria Adobe Launch, insieme ai <script/> tag circostanti.

Guida di riferimento per l’estensione dei visualizzatori per contenuti multimediali dinamici

Informazioni sulla configurazione dei visualizzatori per contenuti multimediali dinamici

L’estensione Dynamic Media Viewer si integra automaticamente con la libreria Adobe Launch se tutte le seguenti condizioni sono soddisfatte:
  • L'oggetto globale della libreria Adobe Launch ( _satellite ) è presente nella pagina.
  • La funzione di estensione dei visualizzatori per contenuti multimediali dinamici _dmviewers_v001() è definita in _satellite .
  • config2= il parametro del visualizzatore non è specificato, il che significa che il visualizzatore non utilizza l'integrazione Analytics precedente.
Inoltre, è disponibile un’opzione per disabilitare esplicitamente l’integrazione di Adobe Launch nel visualizzatore specificando launch=0 i parametri nella configurazione del visualizzatore. Il valore predefinito di questo parametro è 1 .

Configurazione dell’estensione visualizzatori per contenuti multimediali dinamici

L’unica opzione di configurazione per l’estensione dei visualizzatori per contenuti multimediali dinamici è Abilita Adobe Media Analytics per audio e video .
Quando selezionate (attivate o "attivate") questa opzione e se Adobe Media Analytics for Audio and Video extension è installato e configurato correttamente, le metriche di riproduzione video vengono inviate alla soluzione Adobe Analytics per Audio e Video. La disattivazione di questa opzione disattiva il tracciamento video.
Tenete presente che se abilitate questa opzione senza l'installazione dell'estensione Adobe Media Analytics for Audio e Video, l'opzione non ha effetto.

Gli elementi dati nell’estensione dei visualizzatori per contenuti multimediali dinamici

L’unico tipo di elemento dati fornito dall’estensione visualizzatori per contenuti multimediali dinamici è Evento ​visualizzatore dall’elenco a discesa Tipo elemento dati.
Quando è selezionato, l'Editor elemento dati esegue il rendering di un modulo con due campi:
  • Tipo di dati evento visualizzatori DM - un elenco a discesa che identifica tutti gli eventi visualizzatore supportati dall'estensione visualizzatori Dynamic Media Viewer con argomenti, più un elemento COMMON speciale. Una voce COMUNE rappresenta un elenco di parametri evento comuni a tutti i tipi di eventi inviati dai visualizzatori.
  • Parametro di tracciamento - argomento dell'evento del visualizzatore per elementi multimediali dinamici selezionato.
Consultate la guida di riferimento dei visualizzatori per contenuti multimediali dinamici per l’elenco degli eventi supportati per ciascun tipo di visualizzatore; andate a una sezione specifica del visualizzatore, quindi fate clic sulla sottosezione Supporto per il tracciamento di Adobe Analytics. Attualmente, la guida di riferimento dei visualizzatori per contenuti multimediali dinamici non documenta gli argomenti relativi agli eventi.
Consideriamo ora il ciclo di vita dei visualizzatori dati multimediali dinamici . Il valore di tale elemento dati viene popolato dopo che l'evento visualizzatore per elementi multimediali dinamici corrispondente si verifica sulla pagina. Ad esempio, se l'elemento dati punta all'evento LOAD e al relativo argomento "asset", il valore di tale elemento dati riceverà dati validi dopo che il visualizzatore avrà eseguito per la prima volta l'evento LOAD. Se l'elemento dati punta all'evento ZOOM e al relativo argomento "scala", il valore di tale elemento dati resterà vuoto finché il visualizzatore non invia per la prima volta un evento ZOOM .
Allo stesso modo, i valori di Elementi dati vengono aggiornati automaticamente quando il visualizzatore invia un evento corrispondente sulla pagina. L'aggiornamento del valore si verifica anche se l'evento specifico non è specificato nella configurazione Regola. Ad esempio, se l'elemento dati ZoomScale è definito per il parametro "scala" dell'evento ZOOM, ma l'unica regola presente nella configurazione Regola è attivata dall'evento LOAD , il valore di ZoomScale viene ancora aggiornato ogni volta che un utente esegue uno zoom all'interno del visualizzatore.
Qualsiasi visualizzatore per contenuti multimediali dinamici ha un identificatore univoco sulla pagina Web. L’elemento dati tiene traccia del valore stesso e del visualizzatore che lo ha popolato. Ciò significa che se sulla stessa pagina sono presenti diversi visualizzatori ed è presente un elemento dati AssetName che punta all’evento LOAD e al relativo argomento "asset", l’elemento dati AssetName mantiene una raccolta di nomi di risorse associate a ciascun visualizzatore caricato sulla pagina.
Il valore esatto restituito dall'elemento dati dipende dal contesto. Se l'elemento dati è richiesto in una regola attivata da un evento visualizzatore per elementi multimediali dinamici, il valore dell'elemento dati viene restituito per il visualizzatore che ha avviato la regola. Inoltre, se l'elemento dati è richiesto in una regola attivata da un evento da un'altra estensione di Adobe Launch, il valore dell'elemento dati è il valore del visualizzatore che è stato l'ultimo ad aggiornare l'elemento dati.
Considerate la seguente impostazione di esempio:
  • Una pagina Web con due visualizzatori di zoom per contenuti multimediali dinamici; verranno utilizzati come visualizzatore1 e visualizzatore2 .
  • Elemento dati ZoomScale punta all’evento ZOOM e al relativo argomento "scala".
  • Regola TrackPan con le seguenti caratteristiche:
    • Utilizza l’evento PAN del visualizzatore per contenuti multimediali dinamici come attivatore.
    • Invia il valore di ZoomScale Data Element ad Adobe Analytics.
    • Regola TrackKey con le seguenti caratteristiche:
    • Utilizza l'evento di pressione tasti dell'estensione Core Adobe Launch come attivatore.
    • Invia il valore di ZoomScale Data Element ad Adobe Analytics.
A questo punto, si supponga che l’utente finale carichi la pagina Web con i due visualizzatori. Nel visualizzatore1 , viene applicato lo zoom in una scala del 50%; quindi, in viewer2 , viene applicato lo zoom in una scala del 25%. Nel visualizzatore1 , l'immagine viene ingrandita e infine viene premuto un tasto sulla tastiera.
L'attività dell'utente finale determina l'effettuazione delle due seguenti chiamate di tracciamento ad Adobe Analytics:
  • La prima chiamata si verifica perché la regola TrackPan viene attivata quando l'utente esegue il panning nel visualizzatore1 . Tale chiamata invia il 50% come valore dell'elemento dati ZoomScale perché l'elemento dati sa che la regola viene attivata da viewer1 e recupera il valore di scala corrispondente;
  • La seconda chiamata si verifica perché la regola TrackKey viene attivata quando l'utente preme un tasto sulla tastiera. Tale chiamata invia il 25% come valore dell’elemento dati ZoomScale perché la regola non è stata attivata dal visualizzatore. Di conseguenza, l'elemento dati restituisce il valore più aggiornato.
Il campione impostato sopra incide anche sulla durata del valore Data Element. Il valore dell’elemento dati gestito da Dynamic Media Viewer è memorizzato nel codice della libreria Adobe Launch anche dopo che il visualizzatore stesso è stato eliminato dalla pagina Web. Questo significa che se è presente una regola attivata da un’estensione del visualizzatore di contenuti multimediali non dinamici e fa riferimento a tale elemento dati, l’elemento dati restituisce l’ultimo valore noto, anche se il visualizzatore non è più presente sulla pagina Web.
In ogni caso, i valori degli elementi dati guidati dai visualizzatori per contenuti multimediali dinamici non sono memorizzati nell’archivio locale o sul server; vengono invece conservati solo nella libreria Adobe Launch lato client. I valori di tale Data Element scompaiono quando la pagina Web viene ricaricata.
In genere, l'editor Data Element supporta la selezione della durata dell'archiviazione . Tuttavia, gli elementi dati che utilizzano l’estensione visualizzatori per contenuti multimediali dinamici supportano solo l’opzione di durata dell’archiviazione Nessuno . L'impostazione di qualsiasi altro valore è possibile nell'interfaccia utente, ma in questo caso il comportamento Elemento dati non è definito. L'estensione gestisce il valore dell'elemento dati autonomamente: l'elemento dati che mantiene il valore dell'argomento evento del visualizzatore durante l'intero ciclo di vita del visualizzatore.

Informazioni sulle regole nell’estensione dei visualizzatori per contenuti multimediali dinamici

Nell'editor Regola, l'estensione aggiunge nuove opzioni di configurazione per l'editor Eventi. Inoltre, fornisce un'opzione per fare riferimento manualmente ai parametri dell'evento nell'Editor azione come opzione di breve durata, anziché utilizzare elementi dati preconfigurati.

Informazioni sull'editor Eventi

Nell’editor evento, l’estensione dei visualizzatori per contenuti multimediali dinamici aggiunge un nuovo tipo di evento denominato Evento ​visualizzatore.
Quando è selezionato, l’editor evento esegue il rendering degli eventi del visualizzatore Dynamic Media Viewer a discesa, elencando tutti gli eventi disponibili supportati dai visualizzatori Dynamic Media.

Informazioni sull'editor Azioni

L’estensione Visualizzatori per contenuti multimediali dinamici consente di utilizzare i parametri evento dei visualizzatori per contenuti multimediali dinamici per mappare le variabili di analisi nell’editor Imposta variabili dell’estensione Adobe Analytics.
Il metodo più semplice per farlo consiste nel completare il seguente processo in due fasi:
  • Innanzitutto, definite uno o più elementi di dati, in cui ogni elemento di dati rappresenta un parametro di un evento di visualizzatore di contenuti multimediali dinamici.
  • Infine, nell’editor Imposta variabili dell’estensione Adobe Analytics, fai clic sull’icona del selettore degli elementi dati (tre dischi sovrapposti) per aprire la finestra di dialogo Seleziona elemento dati, quindi seleziona un elemento dati da esso.
È tuttavia possibile utilizzare un approccio alternativo e bypassare la creazione di elementi dati. Potete fare riferimento direttamente a un argomento di un evento Visualizzatore elementi multimediali dinamici immettendo il nome completo dell'argomento dell'evento nel campo di immissione del valore dell'assegnazione della variabile Analytics, circondato dai segni di percentuale (%). Esempio,
%event.detail.dm.LOAD.asset%
Si noti che esiste una differenza importante tra l'utilizzo di Elementi dati e il riferimento dell'argomento evento diretto. Per l'elemento dati, non importa quale evento attivi l'azione Imposta variabili, l'evento che attiva la regola può essere correlato al visualizzatore dinamico (come un clic del mouse sulla pagina Web dall'estensione Core). Tuttavia, quando si utilizza un riferimento a un argomento diretto, è importante garantire che l'evento che attiva la regola corrisponda all'argomento evento a cui fa riferimento.
Ad esempio, se la regola viene attivata dall’evento %event.detail.dm.LOAD.asset% LOAD dell’estensione del visualizzatore di contenuti multimediali dinamici, il riferimento restituisce il nome corretto. Tuttavia, restituisce un valore vuoto per qualsiasi altro evento.
Nella tabella seguente sono elencati gli eventi del visualizzatore di contenuti multimediali dinamici e i relativi argomenti supportati:
Nome evento visualizzatore Riferimento argomento
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

Configurazione di tutti gli elementi di integrazione

PRIMA DI INIZIARE
Se non lo avete ancora fatto, Adobe consiglia di consultare tutta la documentazione fornita prima di questa sezione per comprendere l'integrazione completa.
Questa sezione descrive i passaggi di configurazione necessari per integrare i visualizzatori per contenuti multimediali dinamici con Adobe Analytics e Adobe Analytics per audio e video. Anche se è possibile utilizzare l’estensione visualizzatori per contenuti multimediali dinamici per altri scopi in Adobe Launch, scenari non descritti in questa documentazione.
L'integrazione verrà configurata nei seguenti prodotti Adobe:
  • Adobe Analytics - configurerai il tracciamento di variabili e rapporti.
  • Adobe Launch: definirete una proprietà, una o più regole e uno o più elementi dati per abilitare il tracciamento del visualizzatore.
Inoltre, se questa soluzione di integrazione viene utilizzata con AEM Sites, è necessario eseguire anche la seguente configurazione:
  • Adobe I/O Console: l'integrazione viene creata per Adobe Launch.
  • Nodo autore AEM - Configurazione IMS e configurazione cloud Adobe Launch.
Come parte della configurazione, accertati di avere accesso a una società in Adobe Experience Cloud in cui sono già abilitati Adobe Analytics e Adobe Launch.

Configurazione di Adobe Analytics per l'integrazione

Dopo aver configurato Adobe Analytics, per l'integrazione verrà impostato quanto segue:
  • Una suite di rapporti è inserita e selezionata.
  • Le variabili di Analytics sono disponibili per ricevere i dati di tracciamento.
  • I report sono disponibili per visualizzare i dati raccolti in Adobe Analytics.
Consultate anche Guida all'implementazione di Analytics .
Per configurare Adobe Analytics per l'integrazione :
  1. Per iniziare, accedi ad Adobe Analytics dalla home page di Experience Cloud. Nella barra dei menu, fai clic sull'icona Soluzioni (una tabella di punti tre per tre) accanto all'angolo superiore destro della pagina, quindi fai clic su Analytics .
    Ora selezionerete una suite di rapporti.

Selezione di una suite di rapporti

  1. Nell’angolo in alto a destra della pagina Adobe Analytics, a destra del campo Cerca rapporti , selezionate la suite di rapporti corretta dall’elenco a discesa. Se sono disponibili più suite di rapporti e non sei sicuro di quale utilizzarne, contatta il tuo amministratore Adobe Analytics per aiutarti a selezionare la suite di rapporti da utilizzare.
    Nell'illustrazione seguente, un utente ha creato una suite di rapporti denominata DynamicMediaViewersExtensionDoc e l'ha selezionata dall'elenco a discesa. Il nome della suite di rapporti è solo a scopo illustrativo; il nome della suite di rapporti selezionata differisce.
    Se non è disponibile alcuna suite di rapporti, devi crearne una o più prima di procedere con la configurazione.
    Consulta Report e suite di rapporti e Crea una suite di rapporti.
    In Adobe Analytics, le suite di rapporti sono gestite in Amministratore > Suite di rapporti.
    Verranno ora configurate le variabili di Adobe Analytics.

Impostazione delle variabili Adobe Analytics

  1. Ora specificate una o più variabili di Adobe Analytics da usare per monitorare il comportamento dei visualizzatori per file multimediali dinamici nella pagina Web.
    È possibile utilizzare qualsiasi tipo di variabile supportata da Adobe Analytics. La decisione relativa al tipo di variabile (come #Traffico personalizzato, #conversione) deve essere determinata da esigenze specifiche dell'implementazione di Analytics.
    Ai fini di questa documentazione, verrà utilizzata solo una variabile Traffico personalizzato (prop), poiché diventano disponibili in un report di Analytics entro pochi minuti dal verificarsi di un'azione in una pagina Web.
    Per abilitare una nuova variabile Custom Traffic (Traffico personalizzato), in Adobe Analytics, sulla barra degli strumenti fate clic su Admin (Amministratore) > Report Suites (Suite di rapporti) .
  2. Nella pagina Report Suite Manager (Gestione suite di rapporti), selezionate il rapporto corretto, quindi fate clic su Edit Settings (Modifica impostazioni) > Traffic (Traffico) > Traffic (Variabili traffico).
  3. Qui, individuate la variabile non utilizzata, assegnatele un nome descrittivo (risorsa Visualizzatore (prop 30) ) e modificate la casella combinata in "Abilitato" nella colonna Abilitato.
    La schermata seguente è un esempio di variabile Traffico personalizzato ( prop30 ) per tenere traccia del nome di una risorsa utilizzata dal visualizzatore:
  4. In fondo all’elenco delle variabili, fate clic su Salva .

Impostazione di un rapporto

  1. In genere, l'impostazione di un report in Adobe Analytics è guidata da esigenze specifiche del progetto. Di conseguenza, la configurazione dettagliata dei report non rientra nell'ambito di questa integrazione.
    È tuttavia sufficiente sapere che i report Traffico personalizzato diventano automaticamente disponibili in Adobe Analytics dopo l'impostazione delle variabili Traffico personalizzato in Impostazione delle variabili ​Adobe Analytics.
    Ad esempio, il rapporto per la variabile della risorsa Visualizzatore (prop 30) è disponibile dal menu Rapporti in Custom Traffic (Traffico personalizzato) > Custom Traffic 21-30 > Viewer asset (prop 30) .
    Visitando questo rapporto subito dopo la creazione della risorsa del visualizzatore (prop 30) non vengono visualizzati dati; a questo punto è previsto l'integrazione.

Configurazione di Adobe Launch per l'integrazione

Dopo aver configurato Adobe Launch, per l'integrazione verranno configurate le seguenti impostazioni:
  • La creazione di una nuova proprietà per mantenere tutte le configurazioni unite.
  • Installazione e configurazione delle estensioni. Il codice lato client di tutte le estensioni installate nella proprietà viene compilato insieme in una libreria. Questa libreria viene utilizzata dalla pagina Web in un secondo momento.
  • Configurazione di elementi e regole dati. Questa configurazione definisce i dati da acquisire dai visualizzatori per contenuti multimediali dinamici, quando attivare la logica di tracciamento e dove inviare i dati del visualizzatore in Adobe Analytics.
  • Pubblicazione della libreria.
Per configurare Adobe Launch per l'integrazione :
  1. Per iniziare, accedi ad Adobe Launch dalla home page di Experience Cloud. Nella barra dei menu, fate clic sull'icona Soluzioni (tre per tre tabelle di punti) vicino all'angolo superiore destro della pagina, quindi fate clic su Avvia .

Creazione di una proprietà in Adobe Launch

Una proprietà in Adobe Launch è una configurazione denominata che mantiene tutte le impostazioni insieme. Una libreria delle impostazioni di configurazione viene generata e pubblicata su diversi livelli di ambiente (sviluppo, staging e produzione).
Consultate anche Creare una proprietà .
  1. In Adobe Launch, fai clic su Nuova proprietà .
  2. Nella finestra di dialogo Crea proprietà , digitate nel campo Nome un nome descrittivo, ad esempio il titolo del sito Web. Esempio, DynamicMediaViewersProp.
  3. Nel campo Domini , immetti il dominio del tuo sito Web.
  4. Nel menu a discesa Opzioni ​avanzate, abilitate Configura per lo sviluppo dell’estensione (non può essere modificato in seguito) se l’estensione da utilizzare, in questo caso i visualizzatori per file multimediali dinamici, non è ancora stata rilasciata.
  5. Fai clic su Salva .
    Fare clic sulla proprietà appena creata, quindi procedere all' installazione e all'impostazione delle estensioni .

Installazione e configurazione delle estensioni

Tutte le estensioni disponibili in Adobe Launch sono elencate in Estensioni > Catalogo .
Per installare un’estensione, fate clic su Installa . Se necessario, eseguite una configurazione di estensione una tantum, quindi fate clic su Salva .
Se necessario, devono essere installate e configurate le seguenti estensioni:
  • (Obbligatorio) Estensione del servizio ** Experience Cloud ID
Non è necessaria alcuna configurazione aggiuntiva, accettare per eventuali valori proposti. Al termine, fate clic su Salva .
Consulta Estensione del servizio Experience Cloud ID.
  • (Obbligatorio) Estensione Adobe Analytics
Per configurare questa estensione, è innanzitutto necessario disporre dell’ID suite di rapporti disponibile in Adobe Analytics, in Admin (Amministratore) > Report Suite (Suite di rapporti), nell’intestazione della colonna ID suite di rapporti.
(Solo a scopo dimostrativo, l’ID Suite di rapporti della suite di rapporti DynamicMediaViewersExtensionDoc viene utilizzato nelle schermate seguenti. Questo ID è stato creato e utilizzato in Selezione di una suite di rapporti precedente.
Nella pagina Installa estensione, immetti l’ID Suite di rapporti nel campo Suite di rapporti di sviluppo, nel campo Suite di rapporti di staging e nel campo Suite di rapporti di produzione.
Configurate il seguente elemento solo se intendete utilizzare il tracciamento video:
Nella pagina Installa estensione , espandete Generale , quindi specificate il server di tracciamento. Il server di tracciamento segue il modello <trackingNamespace>.sc.omtrdc.net , dove <trackingNamespace> sono le informazioni ottenute nel messaggio e-mail di provisioning.
Fai clic su Salva .
  • (Facoltativo. Richiesto solo se è necessario il tracciamento video) Adobe Media Analytics per l’estensione Audio e Video
Compilare il campo del server di tracciamento. Il server di tracciamento per l’estensione Adobe Media Analytics per audio e video è diverso dal server di tracciamento utilizzato per Adobe Analytics. Segue il modello <trackingNamespace>.hb.omtrdc.net , dove <trackingNamespace> sono le informazioni contenute nel messaggio e-mail di provisioning.
Tutti gli altri campi sono facoltativi.
  • (Obbligatorio) Estensione visualizzatori per contenuti multimediali dinamici
Selezionate Abilita Adobe Analytics per video per attivare il tracciamento heartbeat video.
Al momento di questa scrittura, l’estensione Dynamic Media Viewers è disponibile solo se per lo sviluppo è stata creata la proprietà Adobe Launch.
Dopo che le estensioni sono installate e configurate, almeno, le seguenti cinque estensioni (quattro se non si sta monitorando video) saranno elencate nell'area Estensioni > Installate.

Impostazione di elementi e regole dati

In Adobe Launch, crea elementi dati e regole necessari per tenere traccia dei visualizzatori per file multimediali dinamici.
Per una panoramica del tracciamento con Adobe Launch, vedi Come funziona il tracciamento di dati e eventi nell'integrazione .
Consultate Configurazione di esempio per una configurazione di esempio in Adobe Launch che illustra come tenere traccia del nome di una risorsa al caricamento del visualizzatore.
Consultate Configurazione dell’estensione dei visualizzatori per contenuti multimediali dinamici per informazioni approfondite sulle capacità dell’estensione.

Pubblicazione di una libreria

Per apportare modifiche alla configurazione di Adobe Launch (inclusa la configurazione di proprietà, estensioni, regole ed elementi dati), è necessario pubblicare tali modifiche. La pubblicazione in Adobe Launch viene eseguita dalla scheda Pubblicazione nella configurazione Proprietà.
Adobe Launch può disporre di più ambienti di sviluppo, un ambiente di gestione temporanea e un ambiente di produzione. Per impostazione predefinita, Adobe Launch Cloud Configuration in AEM punta il nodo di creazione AEM all’ambiente Stage di Adobe Launch e il nodo di pubblicazione AEM all’ambiente Produzione di Adobe Launch. Questo significa che con le impostazioni predefinite di AEM, è necessario pubblicare la libreria Adobe Launch nell'ambiente di gestione temporanea in modo da utilizzarla per l'authoring di AEM, quindi pubblicarla nell'ambiente di produzione in modo che possa essere utilizzata nella pubblicazione AEM.
Consulta Ambienti per ulteriori informazioni sugli ambienti Adobe Launch.
La pubblicazione di una libreria comporta i due passaggi seguenti:
  • Aggiunta e creazione di una nuova libreria, includendo tutte le modifiche necessarie (nuove e aggiornate) nella libreria.
  • Spostamento della libreria verso l'alto nei diversi livelli di ambiente (dallo sviluppo allo sviluppo allo sviluppo e alla produzione)

Aggiunta e creazione di una nuova libreria

  1. La prima volta che aprite la scheda Pubblicazione in Adobe Launch, l’elenco della libreria è vuoto.
    Nella colonna sinistra, fate clic su Aggiungi nuova libreria .
  2. Nella pagina Crea nuova libreria, nel campo Nome , immettete un nome descrittivo per la nuova libreria. Esempio,
    DynamicMediaViewersLib
    Dall’elenco a discesa Ambiente, scegliete il livello Ambiente. Inizialmente, solo il livello Sviluppo è disponibile per la selezione. Nell’area in basso a sinistra della pagina, fate clic su Aggiungi tutte le risorse modificate.
  3. Nell’angolo superiore destro della pagina, fate clic su Salva e crea per lo sviluppo .
    In pochi minuti la libreria viene creata e pronta per l'uso.
    Alla successiva modifica della configurazione di Adobe Launch, andate alla scheda Pubblicazione nella configurazione delle proprietà e fate clic sulla libreria creata in precedenza.
    Dalla schermata di pubblicazione della libreria, fate clic su Aggiungi tutte le risorse modificate, quindi fate clic su Salva e crea per lo sviluppo .

Spostamento di una libreria verso l'alto attraverso i livelli dell'ambiente

  1. Dopo l'aggiunta di una nuova libreria, questa si trova inizialmente nell'ambiente di sviluppo. Per spostarlo a livello di ambiente di gestione temporanea (corrispondente alla colonna Inviato), scegliere Invia per approvazione dal menu a discesa della libreria .
  2. Nella finestra di dialogo di conferma, fare clic su Invia .
    Quando la libreria si sposta sulla colonna Inviato, dal menu a discesa della libreria, fate clic su Genera per stato .
  3. Seguite un processo simile per spostare la libreria dall'ambiente di gestione temporanea all'ambiente di produzione (colonna Pubblicato).
    Innanzitutto, dal menu a discesa, fate clic su Approva per la pubblicazione .
  4. Dal menu a discesa, fate clic su Genera e pubblica in produzione .
    Consultate Pubblicazione per ulteriori informazioni sul processo di pubblicazione in Adobe Launch.

Configurazione di Adobe Experience Manager per l'integrazione

Prerequisiti:
  • AEM esegue le istanze Author e Publish.
  • Il nodo di authoring di AEM è configurato in Contenuti multimediali dinamici.
  • I componenti WCM per elementi multimediali dinamici sono abilitati in AEM Sites.
La configurazione di AEM comprende i due passaggi principali seguenti:
  • Configurazione di AEM IMS.
  • Configurazione di Adobe Launch Cloud.

Configurazione di AEM IMS

  1. In AEM Author, fai clic sull’icona Strumenti (martello), quindi fai clic su Protezione > Adobe IMS Configurations .
  2. Nella pagina Configurazione Adobe IMC, nell’angolo in alto a sinistra, fate clic su Crea .
  3. Nella pagina Configurazione account tecnico Adobe IMS, nell'elenco a discesa Soluzione ​Cloud, fai clic su Adobe Launch .
  4. Abilita Crea nuovo certificato , quindi nel campo di testo immetti qualsiasi valore significativo per il certificato. Ad esempio, AdobeLaunchIMSCert . Fate clic su Crea certificato .
    Viene visualizzato il seguente messaggio Informazioni:
    Per recuperare un token di accesso valido, la nuova chiave pubblica del certificato deve essere aggiunta all'account tecnico in Adobe I/O! .
    Fate clic su OK per chiudere la finestra di dialogo Informazioni.
  5. Fate clic su Scarica chiave pubblica per scaricare un file di chiave pubblica ( *.crt ) nel sistema locale.
    A questo punto, lasciate aperta la pagina Configurazione account tecnico Adobe IMS; non chiudere la pagina e non fare clic su Avanti. Tornerai a questa pagina più avanti nei passaggi.
  6. In una nuova scheda del browser, andate alla console I/O di Adobe.
  7. Dalla pagina Adobe I/O Console Integrations (Integrazioni console I/O Adobe), fate clic su Nuova integrazionein alto a destra.
  8. Nella finestra di dialogo Crea una nuova integrazione , accertatevi che Accesso a un pulsante di scelta API sia selezionato, quindi fate clic su Continua .
  9. Nella seconda pagina Crea una nuova pagina di integrazione , abilita (attiva) il pulsante di scelta API Launch della piattaforma Experience. Nell’angolo inferiore destro della pagina, fate clic su Continua .
  10. Nella terza pagina di integrazione , effettuate le seguenti operazioni:
    • Nel campo Nome , inserite un nome descrittivo. Ad esempio, DynamicMediaViewersIO .
    • Nel campo Descrizione , immettere la descrizione per l'integrazione.
    • Nell’area Certificati di chiave pubblica, caricate il file di chiave pubblica ( *.crt ) scaricato in precedenza in questi passaggi.
    • In Seleziona un ruolo per l&#39;intestazione API di avvio della piattaforma esperienza, seleziona Amministratore .
    • In Seleziona uno o più profili di prodotto per l&#39;API di avvio della piattaforma Experience, seleziona il profilo di prodotto Launch - &lt;nome_azienda> .
  11. Fate clic su Crea integrazione .
  12. Nella pagina Integrazione creata , fate clic su Continua per i dettagli di integrazione.
  13. Viene visualizzata una pagina dei dettagli relativi alle integrazioni, simile alla seguente:
    Lascia aperta la pagina dei dettagli di integrazione. Avrete bisogno di varie informazioni dalle schede Panoramica e JWT in un attimo.
    Pagina dei dettagli dell'integrazione
  14. Tornate alla pagina Configurazione account tecnico Adobe IMS che avete lasciato aperta in precedenza. Nell’angolo superiore destro della pagina, fate clic su Avanti per aprire la pagina Account nella finestra Configurazione account tecnico Adobe IMS.
    Se la pagina è stata chiusa accidentalmente, tornate all’autore di AEM e fate clic su Strumenti > Protezione > Configurazioni Adobe IMS. Fai clic su Crea . Nell'elenco a discesa Soluzione ​Cloud, seleziona Adobe Launch . Nell'elenco a discesa Certificato , selezionate il nome del certificato creato in precedenza.
    Pagina Configurazione account tecnico Adobe IMS - Certificato
  15. La pagina Account include cinque campi che dovranno essere compilati utilizzando le informazioni contenute nella pagina dei dettagli Integrazione del passaggio precedente.
    Configurazione account tecnico Adobe IMS - Pagina Account
  16. Nella pagina Account , compila i campi seguenti:
    • Titolo - Immettete un titolo di account descrittivo.
    • Server autorizzazioni - Torna alla pagina dei dettagli dell'integrazione aperta in precedenza. Click the JWT tab. Copiate il nome del server, senza il percorso, come evidenziato di seguito.
    Tornate alla pagina Account , quindi incollate il nome nel relativo campo. Ad esempio, https://ims-na1.adobelogin.com/ (il nome del server di esempio è solo a scopo illustrativo)
    Pagina dei dettagli dell'integrazione - scheda JWT
  17. Chiave API - Torna alla pagina Dettagli integrazione. Fate clic sulla scheda Panoramica , quindi, a destra del campo Chiave API (ID client) , fate clic su Copia .
    Tornate alla pagina Account , quindi incollate la chiave nel relativo campo.
    Pagina dei dettagli dell'integrazione
  18. Segreto cliente - Torna alla pagina dei dettagli dell'integrazione. Dalla scheda Panoramica , fate clic su Recupera Segreto cliente. A destra del campo Segreto ​cliente, fate clic su Copia .
    Tornate alla pagina Account , quindi incollate la chiave nel relativo campo.
  19. Payload - Torna alla pagina dei dettagli dell'integrazione. Dalla scheda JWT , nel campo Payload JWT, copiare l'intero codice oggetto JSON.
    Tornate alla pagina Account , quindi incollate il codice nel relativo campo.
    Pagina dei dettagli dell'integrazione - scheda JWT
    La pagina Account, con tutti i campi compilati, avrà un aspetto simile al seguente:
  20. Nell’angolo superiore destro della pagina Account , fate clic su Crea .
    Con AEM IMS configurato, ora è presente un nuovo account IMSA elencato in Adobe IMS Configurations .

Configurazione di Adobe Launch Cloud per l'integrazione

  1. In AEM Author, accanto all’angolo in alto a sinistra, fai clic sull’icona Strumenti (martello), quindi fai clic su Servizi cloud > Adobe Launch Configurations (Configurazioni di avvio Adobe).
  2. Nella pagina Configurazioni di Adobe Launch, nel pannello a sinistra, seleziona un sito AEM per il quale vuoi applicare la configurazione di Adobe Launch.
    Solo a scopo illustrativo, il sito We.Retail è selezionato nella schermata sottostante.
  3. Nell’angolo in alto a sinistra della pagina, fate clic su Crea .
  4. Nella pagina Generale (1/3 pagine) della finestra Crea configurazione Adobe Launch, compila i campi seguenti:
    • Titolo - Immettete un titolo di configurazione descrittivo. Esempio, We.Retail Launch cloud configuration .
    • Configurazione Adobe IMS associata - Selezionate la configurazione IMS creata in precedenza in Configurazione di AEM IMS .
    • Società - Dall’elenco a discesa Società , seleziona la tua società Experience Cloud. L'elenco viene compilato automaticamente.
    • Proprietà - Dall'elenco a discesa Proprietà, selezionate la proprietà Adobe Launch creata in precedenza. L'elenco viene compilato automaticamente.
    Dopo aver completato tutti i campi, la pagina Generale avrà un aspetto simile al seguente:
  5. Nell'angolo superiore sinistro, fare clic su Avanti .
  6. Nella pagina Staging (2/3 pagine) della finestra Crea configurazione Adobe Launch, compila il campo seguente:
    Nel campo URI ​libreria, verificate il percorso della versione di verifica della libreria Adobe Launch. AEM compila automaticamente questo campo.
    Solo a scopo illustrativo, questo passaggio utilizza le librerie Adobe Launch distribuite in Adobe CDN.
    Verificare che l'URI della libreria popolata automaticamente (Uniform Resource Identifier) non sia danneggiato. Se necessario, correggetelo in modo che l'URI rappresenti un URI relativo al protocollo. Ovvero, inizia da una doppia barra.
    Esempio: //assets.adobetm.com/launch-xxxx .
    La pagina Staging deve essere simile a quella riportata di seguito. Le opzioni Archivia e Carica libreria in modo asincrono non sono impostate:
  7. Nell'angolo superiore destro, fate clic su Avanti .
  8. Nella pagina Produzione (3/3 pagine) della finestra Crea configurazione di avvio Adobe, se necessario, correggete l’URI di produzione con compilazione automatica in modo simile a come era stato fatto nella pagina Staging precedente.
  9. Nell'angolo superiore destro, fate clic su Crea .
    La nuova configurazione di Adobe Launch Cloud ora viene creata ed elencata accanto al sito Web.
  10. Seleziona la nuova configurazione di Adobe Launch Cloud (quando è selezionata, viene visualizzato un segno di spunta a sinistra del titolo della configurazione). Nella barra degli strumenti, fate clic su Pubblica .
Al momento, AEM Author non supporta l’integrazione dei visualizzatori per contenuti multimediali dinamici con Adobe Launch.
È tuttavia supportato nel nodo AEM Publish. Utilizzando le impostazioni predefinite di Adobe Launch Cloud Configuration, AEM Publish utilizza l'ambiente di produzione di Adobe Launch. Di conseguenza, durante il test è necessario inviare gli aggiornamenti della libreria Adobe Launch dallo sviluppo all'ambiente di produzione ogni volta.
È possibile ovviare a questo limite specificando l'URL di sviluppo o di gestione temporanea della libreria Adobe Launch nella configurazione Adobe Launch Cloud per la pubblicazione AEM di cui sopra. In questo modo il nodo AEM Publish utilizza la versione Sviluppo o Gestione temporanea della libreria Adobe Launch.
Consultate Integrare AEM con Adobe Launch tramite Adobe I/O per ulteriori informazioni sulla configurazione di Adobe Launch Cloud.