Integrare i visualizzatori Dynamic Media con i tag di Adobe Analytics e Experience Platform integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch
Cos’è l’integrazione dei visualizzatori Dynamic Media con i tag di Adobe Analytics e Experience Platform? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch
L'estensione Dynamic Media Viewers per i tag Experience Platform funziona con Dynamic Media Viewers 5.13. Consente ai clienti dei tag di Adobe Analytics e Experience Platform di utilizzare gli eventi e i dati dei visualizzatori Dynamic Media nelle loro configurazioni di tag.
Grazie a questa integrazione è possibile monitorare l’utilizzo dei visualizzatori Dynamic Media sul sito web con Adobe Analytics. Allo stesso tempo, puoi utilizzare gli eventi e i dati esposti dai visualizzatori con qualsiasi altra estensione Tag di Experience Platform proveniente da Adobe o da terze parti.
Per ulteriori informazioni sulle estensioni Adobe o di terze parti, consulta Estensioni Adobe nella Guida utente dei tag di Experience Platform.
Questo argomento è destinato ai seguenti utenti: amministratori di siti, sviluppatori nel programma Adobe Experience Manager e utenti nelle operazioni.
Limitazioni dell’integrazione limitations-of-the-integration
- L’integrazione dei tag di Experience Platform per i visualizzatori Dynamic Media non funziona nel nodo di authoring di Experience Manager. Non puoi visualizzare alcun tracciamento da una pagina WCM finché non viene pubblicata.
- L’integrazione dei tag di Experience Platform per i visualizzatori Dynamic Media non è supportata per la modalità operativa pop-up, in cui l’URL del visualizzatore viene ottenuto utilizzando il pulsante "URL" nella pagina Dettagli risorsa.
- L'integrazione dei tag di Experience Platform non può essere utilizzata contemporaneamente all'integrazione dei visualizzatori legacy di Analytics (tramite il parametro
config2=). - Il supporto per il tracciamento video è limitato solo al tracciamento della riproduzione di base, come descritto in Panoramica sul tracciamento. In particolare, QoS, annunci, capitoli/segmenti o tracciamento degli errori non sono supportati.
- La configurazione della durata di 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 d’uso per l’integrazione use-cases-for-the-integration
Il caso d’uso principale per l’integrazione con i tag di Experience Platform sono i clienti che utilizzano sia Experience Manager Assets che Experience Manager Sites. In questi scenari, puoi impostare un’integrazione standard tra il nodo di authoring di Experience Manager e i tag di Experience Platform, quindi associare l’istanza Sites alla proprietà Tag di Experience Platform. Successivamente, qualsiasi componente WCM Dynamic Media aggiunto a una pagina Sites tiene traccia dei dati e degli eventi provenienti dai visualizzatori.
Vedi Tracciare i visualizzatori Dynamic Media in Experience Manager Sites.
Un caso d’uso secondario supportato dall’integrazione è quello dei clienti che utilizzano solo Experience Manager Assets o Dynamic Media Classic. In questi casi, ottieni il codice di incorporamento per il visualizzatore e lo aggiungi alla pagina del sito web. Quindi, ottieni l’URL di produzione della libreria di tag Experience Platform da Tag Experience Platform e aggiungilo manualmente al codice della pagina web.
Vedi Tracciare i visualizzatori Dynamic Media utilizzando il codice incorporato.
Funzionamento del tracciamento di dati ed eventi nell’integrazione how-data-and-event-tracking-works-in-the-integration
L'integrazione sfrutta due tipi distinti e indipendenti di tracciamento dei visualizzatori Dynamic Media: Adobe Analytics e Adobe Analytics for Audio and Video.
Informazioni sul tracciamento con Adobe Analytics about-tracking-using-adobe-analytics
Adobe Analytics consente di tenere traccia delle azioni eseguite da un utente durante l’interazione con i visualizzatori Dynamic Media sul sito web. Adobe Analytics consente inoltre di tenere traccia dei dati specifici del visualizzatore. Ad esempio, puoi tenere traccia e registrare gli eventi di caricamento della visualizzazione insieme al nome della risorsa, alle azioni di zoom che si sono verificate e alle azioni di riproduzione video.
Nei tag di Experience Platform, i concetti di Elementi dati e Regole funzionano insieme per abilitare il tracciamento di Adobe Analytics.
Informazioni sugli elementi dati nei tag di Experience Platform about-data-elements-in-adobe-launch
Un elemento dati nei tag di Experience Platform è una proprietà denominata il cui valore è definito in modo statico o calcolato in modo dinamico in base allo stato di una pagina web o dei dati dei visualizzatori Dynamic Media.
Le opzioni disponibili per la definizione di un elemento dati dipendono dall’elenco delle estensioni installate nella proprietà Tag di Experience Platform. L’estensione "Core" è preinstallata ed è disponibile come strumento predefinito in qualsiasi configurazione. Questa estensione "Core" consente di definire un elemento dati il cui valore proviene da cookie, codice JavaScript, stringa di query e molte altre origini.
Per il tracciamento di Adobe Analytics è necessario installare diverse altre estensioni, come descritto in Installazione e configurazione di estensioni. L’estensione Dynamic Media Viewers consente di definire un elemento dati; tale valore è un argomento dell’evento Dynamic Viewer. Ad esempio, è possibile fare riferimento al tipo di visualizzatore o al nome della risorsa indicato dal visualizzatore al momento del caricamento, al livello di zoom indicato quando l’utente finale esegue lo zoom e molto altro.
L’estensione Dynamic Media Viewer mantiene automaticamente aggiornati i valori degli elementi dati.
Dopo averlo definito, un elemento dati può essere utilizzato in altre posizioni dell’interfaccia utente Tag di Experience Platform, utilizzando il widget del selettore Elemento dati. L'azione Imposta variabili dell'estensione Adobe Analytics in una regola fa riferimento agli elementi dati definiti per il tracciamento dei visualizzatori Dynamic Media (vedi di seguito).
Vedi Data elements nella Guida utente di Experience Platform Tags.
Informazioni sulle regole nei tag di Experience Platform about-rules-in-adobe-launch
Una regola nei tag di Experience Platform è una configurazione agnostica che definisce tre aree che compongono una regola: Eventi, Condizioni e Azioni:
- Eventi (if) indica ai tag di Experience Platform quando attivare una regola.
- Condizioni (if) indica ad Experience Platform Tags le altre restrizioni da consentire o non consentire quando si attiva una regola.
- Azioni (quindi) indica ai tag di Experience Platform cosa fare quando viene attivata una regola.
Le opzioni disponibili nella sezione Eventi, Condizioni e Azioni dipendono dalle estensioni installate nella proprietà Tag di Experience Platform. L'estensione Core è preinstallata ed è disponibile come strumento predefinito in qualsiasi configurazione. L’estensione fornisce diverse opzioni per Eventi, come azioni di base a livello di browser che includono modifiche dello stato attivo, pressioni di tasti e invio di moduli. Include inoltre opzioni per le Condizioni, come valore del cookie, tipo di browser e altro ancora. Per Azioni, è disponibile solo l’opzione Codice personalizzato.
Per il tracciamento di Adobe Analytics, è necessario installare diverse altre estensioni, come descritto in Installazione e configurazione di estensioni. In particolare:
- L’estensione Dynamic Media Viewers estende l’elenco degli eventi supportati agli eventi specifici dei visualizzatori Dynamic Media, come caricamento del visualizzatore, scambio di risorse, zoom in 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 Dynamic Media, è possibile utilizzare uno dei seguenti tipi:
- Eventi dall’estensione Dynamic Media Viewers, dall’estensione Core o da qualsiasi altra estensione.
- Condizioni nella definizione della regola. In alternativa, è possibile lasciare vuota l'area delle condizioni.
Nella sezione Azioni è necessario disporre di un'azione Imposta variabili. Questa azione spiega ad Adobe Analytics come popolare le variabili di tracciamento con i dati. Allo stesso tempo, l'azione Imposta variabili non invia nulla al server di tracciamento.
L'azione Invia beacon deve seguire l'azione Imposta variabili. L'azione Invia beacon invia effettivamente i dati al server di tracciamento di Analytics. Entrambe le azioni, Imposta variabili e Invia beacon, provengono dall'estensione Adobe Analytics.
Consulta le Regole nella Guida utente dei tag di Experience Platform.
Configurazione di esempio sample-configuration
La seguente configurazione di esempio all’interno dei tag di Experience Platform illustra come tenere traccia del nome di una risorsa al caricamento del visualizzatore.
-
Dalla scheda Elementi dati, definisci un elemento dati
AssetNameche faccia riferimento al parametroassetdell'eventoLOADdall'estensione Dynamic Media Viewers.
-
Dalla scheda Regole, definisci una regola TrackAssetOnLoad.
In questa regola, il campo Event utilizza l'evento LOAD dell'estensione Dynamic Media Viewers.
-
La configurazione dell'azione dispone di due tipi di azione dell'estensione Adobe Analytics:
Imposta variabili, che mappano una variabile di analisi scelta al valore di
AssetNameelemento dati.Invia beacon, che invia informazioni di tracciamento ad Adobe Analytics.
-
La configurazione della regola risultante viene visualizzata come segue:
Informazioni su Adobe Analytics per audio e video about-adobe-analytics-for-audio-and-video
Quando un account Experience Cloud è abbonato per utilizzare Adobe Analytics for Audio and Video, è sufficiente abilitare il tracciamento video nelle impostazioni dell'estensione Dynamic Media Viewers. Le metriche video diventano disponibili in Adobe Analytics. Il tracciamento video dipende dalla presenza dell’estensione Adobe Media Analytics for Audio and Video.
Consulta Installazione e configurazione delle estensioni.
Attualmente, il supporto per il tracciamento dei video è limitato solo al tracciamento della "riproduzione di base", come descritto in Panoramica sul tracciamento. In particolare, QoS, annunci, capitoli/segmenti o tracciamento degli errori non sono supportati.
Utilizzare l’estensione Dynamic Media Viewers using-the-dynamic-media-viewers-extension
Come indicato in Casi d'uso per l'integrazione, è possibile tenere traccia dei visualizzatori Dynamic Media con la nuova integrazione dei tag Experience Platform in Experience Manager Sites e utilizzando il codice di incorporamento.
Tracciare i visualizzatori Dynamic Media in Experience Manager Sites tracking-dynamic-media-viewers-in-aem-sites
Per tenere traccia dei visualizzatori Dynamic Media in Experience Manager Sites, è necessario eseguire tutti i passaggi elencati nella sezione Configurare tutte le parti dell'integrazione. In particolare, devi creare la configurazione IMS e la configurazione cloud dei tag di Experience Platform.
Dopo la configurazione corretta, qualsiasi visualizzatore Dynamic Media aggiunto a una pagina Sites, utilizzando un componente WCM supportato da Dynamic Media, tiene traccia automaticamente dei dati in Adobe Analytics, Adobe Analytics for Video o in entrambi.
Consulta Aggiungere Dynamic Media Assets alle pagine tramite Adobe Sites.
Tracciare i visualizzatori Dynamic Media utilizzando il codice di incorporamento tracking-dynamic-media-viewers-using-embed-code
I clienti che non utilizzano Experience Manager Sites o che incorporano visualizzatori Dynamic Media in pagine web al di fuori di Experience Manager Sites, o in entrambi, possono comunque utilizzare l’integrazione Experience Platform Tags.
Completa i passaggi di configurazione dalle sezioni Configura Adobe Analytics e Configura tag Experience Platform. Tuttavia, i passaggi di configurazione relativi ad Experience Manager non sono necessari.
Dopo aver configurato correttamente il sistema, puoi aggiungere il supporto per tag Experience Platform a una pagina web con un visualizzatore Dynamic Media.
Consulta Aggiungere il codice di incorporamento dei tag di Experience Platform per ulteriori informazioni su come utilizzare il codice di incorporamento della libreria di tag di Experience Platform.
Per ulteriori informazioni sull'utilizzo della funzionalità del codice incorporato di Experience Manager Dynamic Media, consulta Incorporazione di un visualizzatore di video o immagini in una pagina Web.
Traccia i visualizzatori Dynamic Media utilizzando il codice incorporato:
- Prepara una pagina web per incorporare un visualizzatore Dynamic Media.
- Ottieni il codice di incorporamento per la libreria di tag Experience Platform effettuando prima l'accesso a Tag Experience Platform (consulta Configurare i tag Experience Platform).
- Seleziona Proprietà, quindi fai clic sulla scheda Ambienti.
- Scegli il livello di ambiente pertinente all’ambiente della pagina web. Quindi, nella colonna Installa, fare clic sull'icona della casella.
- Nella finestra di dialogo Istruzioni per l'installazione Web, copia il codice di incorporamento completo della libreria Experience Platform Tags, insieme ai tag
<script/>circostanti.
Guida di riferimento per l’estensione Dynamic Media Viewers reference-guide-for-the-dynamic-media-viewers-extension
Informazioni sulla configurazione dei visualizzatori Dynamic Media about-the-dynamic-media-viewers-configuration
L’estensione Dynamic Media Viewer si integra automaticamente con la libreria di tag di Experience Platform se sono soddisfatte le seguenti condizioni:
-
L'oggetto globale della libreria Tag di Experience Platform (
_satellite) è presente nella pagina. -
La funzione di estensione dei visualizzatori Dynamic Media
_dmviewers_v001()è definita su_satellite. -
Il parametro del visualizzatore
config2=non è specificato, pertanto il visualizzatore non utilizza l'integrazione legacy di Analytics.
È inoltre disponibile un'opzione per disabilitare esplicitamente l'integrazione dei tag di Experience Platform nel visualizzatore specificando il parametro launch=0 nella configurazione del visualizzatore. Il valore predefinito di questo parametro è 1.
Configurare l’estensione Dynamic Media Viewers configuring-the-dynamic-media-viewers-extension
L'unica opzione di configurazione per l'estensione Dynamic Media Viewers è Enable Adobe Media Analytics for Audio and Video.
Quando selezioni (abilita) questa opzione e l’estensione Adobe Media Analytics for Audio and Video viene installata e configurata, le metriche di riproduzione video vengono inviate alla soluzione Adobe Analytics for Audio and Video. La disattivazione di questa opzione disattiva il tracciamento video.
Se abiliti questa opzione senza aver installato l'estensione Adobe Media Analytics for Audio and Video, l'opzione non ha alcun effetto.
Informazioni sugli elementi dati nell’estensione Dynamic Media Viewers about-data-elements-in-the-dynamic-media-viewers-extension
L’unico tipo di elemento di dati fornito dall’estensione Dynamic Media Viewers è Evento visualizzatore, proveniente dall’elenco a discesa Data Element Type (Tipo di elemento dati).
Quando è selezionato, l’editor elementi dati esegue il rendering di un modulo con due campi:
- Tipo di dati evento visualizzatori DM: in un elenco a discesa vengono visualizzati tutti gli eventi visualizzatore con argomenti supportati dall'estensione Dynamic Media Viewers, insieme a un elemento speciale COMMON. Un elemento COMMON rappresenta un elenco di parametri evento che sono comuni a tutti i tipi di eventi inviati dai visualizzatori.
- Parametro di tracciamento: argomento dell'evento visualizzatore Dynamic Media selezionato.
Per l'elenco degli eventi supportati per ciascun tipo di visualizzatore, consulta la guida di riferimento per visualizzatori Dynamic Media. Vai alla sezione del visualizzatore specifico, quindi seleziona la sottosezione Supporto per il tracciamento di Adobe Analytics. Attualmente, la guida di riferimento per i visualizzatori Dynamic Media non documenta gli argomenti dell’evento.
Consideriamo ora il ciclo di vita dei visualizzatori Dynamic Media Elemento dati. Il valore di tale elemento dati viene popolato dopo che l’evento visualizzatore Dynamic Media corrispondente si verifica sulla pagina. Si supponga ad esempio che l'elemento dati punti all'evento LOAD e al relativo argomento "asset". Il valore di tale elemento dati riceve dati validi dopo che il visualizzatore ha eseguito l'evento LOAD per la prima volta. Se l'elemento dati punta all'evento ZOOM e al relativo argomento "scale", il valore di tale elemento dati rimane vuoto finché il visualizzatore non invia un evento ZOOM per la prima volta.
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 è indicato nella configurazione Regola. Si supponga ad esempio che l'elemento dati ZoomScale sia definito per il parametro "scale" dell'evento ZOOM. Tuttavia, l'evento LOAD è l'unico trigger nella configurazione della regola. Il valore di ZoomScale viene comunque aggiornato ogni volta che un utente esegue lo zoom all'interno del visualizzatore.
Qualsiasi visualizzatore Dynamic Media è dotato di un identificatore univoco sulla pagina web. L’elemento dati tiene traccia del valore stesso e del visualizzatore che lo ha popolato. Si supponga, ad esempio, che nella stessa pagina siano presenti più visualizzatori e 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 associati a ciascun visualizzatore caricato sulla pagina.
Il valore esatto restituito dall’elemento dati dipende dal contesto. Se una regola attivata da un evento visualizzatore Dynamic Media richiede l’elemento dati, il valore viene restituito per il visualizzatore che ha avviato la regola. Se una regola attivata da un evento di un’altra estensione Experience Platform Tags richiede l’elemento dati, segue il contesto dell’evento corrispondente. A quel punto, il valore dell’elemento dati proviene dal visualizzatore che è stato l’ultimo ad aggiornare questo elemento dati.
Considerare la seguente configurazione di esempio:
-
Pagina Web con due visualizzatori zoom di Dynamic Media: visualizzatore1 e visualizzatore2.
-
L'elemento dati ZoomScale punta all'evento ZOOM e al relativo argomento "scale".
-
Regola TrackPan con quanto segue:
- Utilizza l'evento PAN del visualizzatore Dynamic Media come attivatore.
- Invia il valore dell'elemento dati ZoomScale ad Adobe Analytics.
-
Regola TrackKey con:
- Utilizza l’evento di pressione chiave dall’estensione Core Experience Platform Tags come attivatore.
- Invia il valore dell'elemento dati ZoomScale ad Adobe Analytics.
Ora, supponiamo che l’utente carichi la pagina web con i due visualizzatori. In visualizzatore1 viene eseguito lo zoom avanti del 50%, quindi in visualizzatore2 viene eseguito lo zoom avanti del 25%. In viewer1, viene eseguita la panoramica dell'immagine e infine viene premuto un tasto sulla tastiera.
L’attività dell’utente comporta l’esecuzione delle seguenti due chiamate di tracciamento ad Adobe Analytics:
- La prima chiamata si verifica perché la regola TrackPan viene attivata quando l'utente effettua la panoramica in visualizzatore1. La chiamata invia 50% come valore dell'elemento dati ZoomScale perché riconosce che viewer1 ha attivato la regola e recupera il valore di scala corrispondente;
- La seconda chiamata si verifica perché la regola TrackKey viene attivata quando l'utente ha premuto un tasto sulla tastiera. La chiamata invia il 25% come valore dell'elemento dati ZoomScale perché il visualizzatore non ha attivato la regola. Di conseguenza, l’elemento dati restituisce il valore più aggiornato.
Il campione impostato sopra influisce anche sulla durata del valore dell’elemento dati. Il valore dell’elemento dati gestito dal visualizzatore Dynamic Media viene memorizzato nel codice della libreria di tag di Experience Platform anche dopo che il visualizzatore stesso è stato eliminato sulla pagina web. Questa funzionalità significa che se una regola attivata da un’estensione non Dynamic Media Viewer fa riferimento all’elemento dati, restituisce l’ultimo valore noto. Anche se il visualizzatore non è più presente nella pagina web.
In ogni caso, i valori degli elementi dati guidati dai visualizzatori Dynamic Media non vengono memorizzati nell’archiviazione locale o sul server, ma vengono conservati solo nella libreria di tag Experience Platform lato client. I valori di tale elemento dati scompaiono quando la pagina web viene ricaricata.
In genere, l'editor degli elementi dati supporta la selezione della durata di archiviazione 🔗. Tuttavia, gli elementi dati che utilizzano l'estensione Dynamic Media Viewers supportano solo l'opzione di durata di archiviazione None. Nell’interfaccia utente è possibile impostare qualsiasi altro valore, ma in questo caso il comportamento dell’elemento dati non è definito. L’estensione gestisce il valore dell’elemento dati singolarmente: l’elemento dati che mantiene il valore dell’argomento evento visualizzatore durante l’intero ciclo di vita del visualizzatore.
Informazioni sulle regole nell’estensione Dynamic Media Viewers about-rules-in-the-dynamic-media-viewers-extension
Nell’editor delle regole, l’estensione aggiunge nuove opzioni di configurazione per l’editor degli eventi. Inoltre, l’editor fornisce un’opzione per fare riferimento manualmente ai parametri dell’evento nell’editor azioni come opzione a breve termine, invece di utilizzare elementi dati preconfigurati.
Informazioni sull’editor eventi about-the-events-editor
Nell'editor eventi, l'estensione Dynamic Media Viewers aggiunge un Tipo evento denominato Evento visualizzatore.
Quando è selezionato, l'editor eventi visualizza il menu a discesa Eventi visualizzatore Dynamic Media, in cui sono elencati tutti gli eventi supportati dai visualizzatori Dynamic Media.
Informazioni sull’editor delle azioni about-the-actions-editor
L’estensione Dynamic Media Viewers consente di utilizzare i parametri evento dei visualizzatori Dynamic Media per la mappatura sulle variabili di analisi nell’editor di variabili Set dell’estensione Adobe Analytics.
Il metodo più semplice per farlo consiste nel completare il seguente processo in due fasi:
- Innanzitutto, definisci uno o più elementi dati, in cui ogni elemento dati rappresenta un parametro di un evento Dynamic Media Viewer.
- Infine, nell'editor Set Variables dell'estensione Adobe Analytics, fai clic sull'icona
È tuttavia possibile adottare un approccio alternativo e ignorare la creazione di elementi dati. È possibile fare riferimento diretto a un argomento da un evento Dynamic Media Viewer. Immetti il nome completo dell'argomento evento nel campo di input value dell'assegnazione della variabile Analytics. Assicurarsi che i segni di percentuale (%) siano circondati. Ad esempio,
%event.detail.dm.LOAD.asset%
Esiste una differenza importante tra l’utilizzo degli elementi dati e il riferimento diretto agli argomenti dell’evento. Per l’elemento dati, non importa quale evento attiva l’azione Imposta variabili. L’evento che attiva la Regola può non essere correlato al Visualizzatore dinamico (come la selezione della pagina web dall’estensione Core). Tuttavia, quando si utilizza un riferimento diretto all’argomento, è importante assicurarsi che l’evento che attiva la regola corrisponda all’argomento dell’evento a cui fa riferimento.
Ad esempio, se l'evento LOAD dall'estensione Dynamic Media Viewer attiva la regola, il riferimento a %event.detail.dm.LOAD.asset% restituisce il nome corretto della risorsa.
Tuttavia, restituisce un valore vuoto per qualsiasi altro evento.
Nella tabella seguente sono elencati gli eventi di Dynamic Media Viewer e i relativi argomenti supportati:
Configurare tutte le parti dell’integrazione configuring-all-the-integration-pieces
PRIMA DI INIZIARE
Adobe consiglia di consultare attentamente tutta la documentazione che precede questa sezione per comprendere appieno l’integrazione completa.
Questa sezione descrive i passaggi di configurazione necessari per integrare i visualizzatori Dynamic Media con Adobe Analytics e Adobe Analytics for Audio and Video. Anche se è possibile utilizzare l’estensione Dynamic Media Viewers per altri scopi nei tag di Experience Platform, tali scenari non sono trattati in questa documentazione.
Stai per utilizzare i seguenti prodotti Adobe per configurare la tua integrazione:
- Adobe Analytics: utilizzato per configurare variabili e rapporti di tracciamento.
- Tag di Experience Platform: utilizzati per definire 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 Experience Manager Sites, è necessario eseguire la configurazione seguente:
- Adobe Developer Console - integrazione creata per i tag Experience Platform.
- Nodo di authoring di Experience Manager: configurazione IMS e configurazione cloud di tag Experience Platform.
Come parte della configurazione, accertati di avere accesso a una società in Adobe Experience Cloud per la quale sono già abilitati i tag di Adobe Analytics e Experience Platform.
Configurare Adobe Analytics per l’integrazione configuring-adobe-analytics-for-the-integration
Dopo aver configurato Adobe Analytics, l’integrazione è impostata per:
- È presente una suite di rapporti selezionata.
- Le variabili di Analytics sono disponibili per ricevere i dati di tracciamento.
- I rapporti sono disponibili per visualizzare i dati raccolti all’interno di Adobe Analytics.
Vedi anche Guida all'implementazione di Analytics.
Per configurare Adobe Analytics per l'integrazione:
-
Per iniziare, accedi ad Adobe Analytics dalla home page di Experience Cloud. Sulla barra dei menu, fai clic sull'icona
Ora, seleziona una suite di rapporti.
Seleziona una suite di rapporti selecting-a-report-suite
-
Nell’angolo in alto a destra della pagina Adobe Analytics, alla destra del campo Search Reports (Cerca rapporti), seleziona la report suite corretta dall’elenco a discesa. Se sono disponibili più suite di rapporti e non sai quale utilizzare, chiedi assistenza. L’amministratore di Adobe Analytics può guidarti nella selezione della suite di rapporti appropriata.
Nell'esempio 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 un esempio. Spetta a te scegliere il nome della suite di rapporti da selezionare.
Adobe Analytics Se non è disponibile alcuna suite di rapporti, è necessario crearne una prima di poter 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 Admin > Suite di rapporti.
Ora, imposta le variabili Adobe Analytics.
Configurare le variabili Adobe Analytics setting-up-adobe-analytics-variables
-
Designa una o più variabili Adobe Analytics da utilizzare per monitorare il comportamento dei visualizzatori Dynamic Media sulla pagina web.
Puoi utilizzare qualsiasi tipo di variabile supportato da Adobe Analytics. L'implementazione di Analytics deve determinare il tipo di variabile appropriato, ad esempio Traffico personalizzato (
props) o Conversione (eVar).Vedi Panoramica di proprietà ed eVar.
Ai fini di questa documentazione, viene utilizzata solo una variabile Traffico personalizzato (prop) perché diventano disponibili in un rapporto di Analytics entro pochi minuti dopo che si è verificata un’azione su una pagina web.
Per abilitare una nuova variabile di traffico personalizzata, vai a Amministratore > Suite per report in Adobe Analytics sulla barra degli strumenti.
-
Nella pagina Gestione suite di rapporti, seleziona il rapporto corretto.
-
Sulla barra degli strumenti fare clic su Modifica impostazioni > Traffico > Variabili di traffico.
-
Selezionare una variabile inutilizzata, assegnarle un nome descrittivo (Risorsa visualizzatore (prop 30)), quindi modificare la casella combinata in "Abilitato" nella colonna Abilitato.
La schermata seguente è un esempio di variabile di traffico personalizzata (prop30) per il tracciamento di un nome di risorsa utilizzato dal visualizzatore:
-
Nella parte inferiore dell'elenco delle variabili fare clic su Salva.
Configurare un rapporto setting-up-a-report
In genere, un progetto specifico richiede come impostare un rapporto in Adobe Analytics. Pertanto, la configurazione di un rapporto dettagliato va oltre lo scopo di questa integrazione.
È tuttavia sufficiente sapere che i report Traffico personalizzato diventano automaticamente disponibili in Adobe Analytics dopo la configurazione delle variabili Traffico personalizzato in Imposta variabili Adobe Analytics.
Ad esempio, il rapporto per la variabile Viewer asset (Risorsa visualizzatore) (prop 30) è disponibile dal menu Rapporti in Traffico personalizzato > Traffico personalizzato 21-30 > Viewer asset (Risorsa visualizzatore) (prop 30).
Se accedi a questo rapporto subito dopo la creazione di Viewer asset (Risorsa visualizzatore) (prop 30) non troverai alcun dato, il che è piuttosto normale a questo punto dell’integrazione.
Configurare i tag di Experience Platform per l’integrazione configuring-adobe-launch-for-the-integration
Dopo aver configurato i tag di Experience Platform, per l’integrazione vengono impostati i seguenti elementi:
- La creazione di una nuova Proprietà per mantenere unite tutte le configurazioni.
- 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 dati e regole. Questa configurazione definisce quali dati acquisire dai visualizzatori Dynamic Media, quando attivare la logica di tracciamento e dove inviare i dati del visualizzatore in Adobe Analytics.
- Pubblicazione della libreria.
Per configurare i tag Experience Platform per l'integrazione:
-
Per iniziare, accedi ai tag di Experience Platform dalla home page di Experience Cloud. Sulla barra dei menu, fai clic sull'icona
Creare una proprietà nei tag di Experience Platform creating-a-property-in-adobe-launch
Una proprietà in Experience Platform Tags è una configurazione denominata che mantiene tutte le impostazioni unite. Viene generata e pubblicata una libreria delle impostazioni di configurazione a diversi livelli di ambiente (sviluppo, staging e produzione).
Vedere anche Configurare una proprietà di selezione.
Per creare una proprietà in Experience Platform Tags:
-
In Tag Experience Platform, fai clic su Nuova proprietà.
-
Nella finestra di dialogo Crea proprietà, digita un nome descrittivo nel campo Nome, ad esempio il titolo del tuo sito web. Ad esempio
DynamicMediaViewersProp. -
Nel campo Domini, immetti il dominio del tuo sito Web.
-
Nel menu a discesa Opzioni avanzate, abilita Configura per lo sviluppo dell'estensione (non potrà essere modificata in seguito) nel caso in cui l'estensione che desideri utilizzare - in questo caso, Visualizzatori Dynamic Media - non sia ancora stata rilasciata.
-
Seleziona Salva.
Selezionare la proprietà creata, quindi passare a Installazione e configurazione delle estensioni.
Installazione e configurazione delle estensioni installing-and-setup-of-extensions
Tutte le estensioni disponibili nei tag di Experience Platform sono elencate in Estensioni > Catalogo.
Per installare un'estensione, fare clic su Installa. Se necessario, eseguire una configurazione di estensione una tantum, quindi fare clic su Salva.
Se necessario, è necessario installare e configurare le seguenti estensioni:
- (Obbligatorio) Estensione del servizio Experience Cloud ID
Non è necessaria alcuna configurazione aggiuntiva, ad eccezione di eventuali valori proposti. Al termine, fai clic su Salva.
Consulta Estensione del servizio Experience Cloud Identity.
- (Obbligatorio) Estensione Adobe Analytics
Per configurare questa estensione, è necessario disporre dell'ID Report Suite trovato in Adobe Analytics, in Admin > Report Suite, nell'intestazione della colonna Report Suite ID.
(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 nella precedente sezione Selezione di una report suite.
Nella pagina Installa estensione, immetti l’ID Report Suite nel campo Development Report Suites (Report Suite di sviluppo), nel campo Staging Report Suites (Report Suite di staging) e nel campo Production Report Suites (Report Suite di produzione).
Configurare l'elemento seguente solo se si intende utilizzare il tracciamento video:
Nella pagina Installa estensione, espandi Generale, quindi specifica il server di tracciamento. Il server di tracciamento segue il modello <trackingNamespace>.sc.omtrdc.net, dove <trackingNamespace> è l'informazione ottenuta nell'e-mail di provisioning.
Seleziona Salva.
Consulta Estensione Adobe Analytics.
- (Facoltativo. Richiesto solo se è necessario il tracciamento video) Estensione Adobe Media Analytics for Audio and Video
Compila il campo del server di tracciamento. Il server di tracciamento per l'estensione Adobe Media Analytics for Audio and Video è diverso dal server di tracciamento utilizzato per Adobe Analytics. Segue il modello <trackingNamespace>.hb.omtrdc.net, dove <trackingNamespace> è l'informazione dell'e-mail di provisioning.
Tutti gli altri campi sono facoltativi.
Consulta Estensione Adobe Media Analytics for Audio and Video.
- (Obbligatorio) Estensione Dynamic Media Viewers
Per attivare il tracking Video Heartbeat, seleziona enable Adobe Analytics for Video (Abilita Adobe Analytics per video).
Al momento della scrittura, l'estensione Dynamic Media Viewers è disponibile solo se è stata creata la proprietà Experience Platform Tags per lo sviluppo.
Consulta Creare una proprietà in Experience Platform Tags.
Dopo l’installazione e la configurazione delle estensioni, almeno le cinque estensioni seguenti (quattro se non stai tracciando il video) sono elencate nell’area Estensioni > Installate.
Impostare elementi dati e regole setting-up-data-elements-and-rules
In Tag di Experience Platform, crea elementi dati e regole necessari per il tracciamento dei visualizzatori Dynamic Media.
Per una panoramica del tracciamento con i tag Experience Platform, consulta Funzionamento del tracciamento di dati ed eventi nell'integrazione.
Vedi Configurazione di esempio per una configurazione di esempio in Tag di Experience Platform che illustra come tenere traccia del nome di una risorsa al caricamento del visualizzatore.
Consulta Configurare l'estensione Dynamic Media Viewers per informazioni approfondite sulle funzionalità dell'estensione.
Pubblicare una libreria publishing-a-library
Per modificare la configurazione dei tag di Experience Platform (incluse le impostazioni di Proprietà, Estensioni, Regole ed Elementi dati), devi pubblicare tali modifiche. La pubblicazione nei tag di Experience Platform viene eseguita dalla scheda Pubblicazione nella configurazione di Proprietà.
I tag Experience Platform possono potenzialmente avere più ambienti di sviluppo, un ambiente di staging e un ambiente di produzione. Per impostazione predefinita, la configurazione cloud dei tag di Experience Platform in Experience Manager punta il nodo di authoring di Experience Manager all’ambiente di staging dei tag della piattaforma. Il nodo Publish di Experience Manager punta all’ambiente di produzione dei tag di Experience Platform. Ciò significa che con le impostazioni predefinite di Experience Manager, è necessario pubblicare la libreria Tag di Experience Platform nell’ambiente di staging. In questo modo puoi utilizzarlo in modalità di authoring in Experience Manager. Puoi quindi pubblicarlo nell’ambiente di produzione in modo che possa essere utilizzato in Experience Manager Publish.
Per ulteriori informazioni sugli ambienti di tag Experience Platform, consulta Ambienti.
La pubblicazione di una libreria prevede i due passaggi seguenti:
- Aggiunta e creazione di una nuova libreria includendo tutte le modifiche necessarie (nuove e aggiornamenti) nella libreria.
- Spostarsi verso l’alto nella libreria attraverso i diversi livelli di ambiente (da Sviluppo a Staging e Produzione).
Aggiungere e creare una nuova libreria adding-and-building-a-new-library
-
La prima volta che apri la scheda Pubblicazione in Tag di Experience Platform, l’elenco delle librerie è vuoto.
Nella colonna sinistra, fare clic su Aggiungi nuova libreria.
-
Nella pagina Crea nuova libreria, immetti il nome descrittivo della nuova libreria nel campo Nome. Ad esempio,
LibreriaVisualizzatoriDynamicMedia
Dall’elenco a discesa Ambiente, scegli il livello Ambiente. Inizialmente, solo il livello Sviluppo è disponibile per la selezione. Nella parte inferiore sinistra della pagina fare clic su Aggiungi tutte le risorse modificate.
-
Fai clic su Salva e genera per sviluppo nell'angolo superiore destro della pagina.
In pochi minuti, la libreria viene creata ed è pronta per l’uso.
note note NOTE Alla prossima modifica della configurazione dei tag Experience Platform, vai alla scheda Pubblicazione nella configurazione Proprietà, quindi seleziona la libreria creata in precedenza. Dalla schermata di pubblicazione della libreria, fai clic su Aggiungi tutte le risorse modificate, quindi fai clic su Salva e genera per sviluppo.
Spostarsi verso l’alto in una libreria attraverso i livelli di ambiente moving-a-library-up-through-environment-levels
-
Dopo l’aggiunta di una nuova libreria, questa si trova nell’ambiente di sviluppo. Per spostarlo nel livello dell'ambiente di staging (che corrisponde alla colonna Inviato), dal menu a discesa della libreria, fare clic su Invia per approvazione.
-
Nella finestra di dialogo di conferma, fai clic su Invia.
Dopo aver spostato la libreria nella colonna Inviata, dal menu a discesa della libreria, fare clic su Genera per staging.
-
Per spostare la libreria dall’ambiente di staging all’ambiente di produzione (che è la colonna Pubblicato), segui un processo simile.
Innanzitutto, dal menu a discesa, fai clic su Approva per la pubblicazione.
-
Dal menu a discesa, fai clic su Genera e pubblica in produzione.
Consulta Pubblicazione per ulteriori informazioni sul processo di pubblicazione nei tag di Experience Platform.
Configurare Adobe Experience Manager per l’integrazione configuring-adobe-experience-manager-for-the-integration
Prerequisiti:
- Experience Manager esegue sia le istanze in modalità di authoring che quelle in modalità di pubblicazione.
- Il nodo di authoring di Experience Manager è configurato in Dynamic Media.
- I componenti WCM Dynamic Media sono abilitati in Experience Manager Sites.
La configurazione di Experience Manager prevede i due passaggi principali seguenti:
- Configurazione di Experience Manager IMS.
- Configurazione di Experience Platform Tags Cloud.
Configurare Experience Manager IMS configuring-aem-ims
-
In Experience Manager Author, fai clic sull'icona
-
Nella pagina Configurazione Adobe IMC, nell'angolo superiore sinistro, fare clic su Crea.
-
Nella pagina Configurazione account tecnico Adobe IMS, nell'elenco a discesa Soluzione cloud, fare clic su Raccolta dati Experience Platform.
-
Abilita Crea nuovo certificato, quindi immetti un valore significativo per il certificato nel campo di testo. Ad esempio, AdobeLaunchIMSCert. Fai clic su Crea certificato.
Viene visualizzato il seguente messaggio informativo:
Per recuperare un token di accesso valido, è necessario aggiungere la nuova chiave pubblica del certificato all'account tecnico in Adobe Developer!
Per chiudere la finestra di dialogo Info, fare clic su OK.
-
Selezionare Scarica chiave pubblica per scaricare un file di chiave pubblica (
*.crt) nel sistema locale.note note NOTE A questo punto, lascia aperta la pagina Configurazione account tecnico Adobe IMS; non chiude la pagina e non fai clic su Avanti. Tornerai a questa pagina più avanti nei passaggi. 
-
In una nuova scheda del browser, passa a Adobe Developer Console.
-
Dalla pagina Integrazioni Adobe Developer Console, nell'angolo superiore destro, fare clic su Nuova integrazione.
-
Nella finestra di dialogo Create a new integration (Crea una nuova integrazione), accertati che sia selezionato il pulsante di scelta Access an API (Accesso a un API), quindi fai clic su Continua.
-
Nella seconda pagina Crea una nuova integrazione, abilita (attiva) il pulsante di scelta API tag Experience Platform. Nell’angolo inferiore destro della pagina, fai clic su Continua.
-
Nella terza pagina Crea una nuova integrazione eseguire le operazioni seguenti:
-
Nel campo Nome immettere un nome descrittivo. Ad esempio, DynamicMediaViewersIO.
-
Nel campo Descrizione immettere una descrizione per l'integrazione.
-
Nell'area Certificati a chiave pubblica, carica il file a chiave pubblica (
*.crt) scaricato in precedenza in questi passaggi. -
Nell'intestazione Seleziona un ruolo per l'API dei tag di Experience Platform, fare clic su Amministratore.
-
Nell'intestazione Seleziona uno o più profili di prodotto per l'API dei tag di Experience Platform, seleziona il profilo di prodotto denominato Tag - <nome_società>.
-
-
Seleziona Crea integrazione.
-
Nella pagina Integrazione creata, fare clic su Continua con i dettagli di integrazione.
-
Viene visualizzata una pagina dei dettagli delle integrazioni simile alla seguente:
note note NOTE Lascia aperta la pagina dei dettagli di integrazione. Tra poco ti occorreranno varie informazioni provenienti dalle schede Panoramica e JWT. 
Pagina dettagli integrazione -
Torna alla pagina Configurazione account tecnico Adobe IMS che hai lasciato aperta in precedenza. Nell’angolo superiore destro della pagina, fai clic su Avanti per aprire la pagina Account alla finestra Configurazione account tecnico Adobe IMS.
(Se la pagina è stata chiusa in precedenza, torna ad Experience Manager Author, quindi vai a Strumenti > Sicurezza > Configurazioni Adobe IMS. Seleziona Crea. Nell'elenco a discesa Soluzione cloud, fare clic su Tag Experience Platform. Nell'elenco a discesa Certificato fare clic sul nome del certificato creato in precedenza.
Configurazione account tecnico Adobe IMS - Pagina certificato -
La pagina Account contiene cinque campi che è necessario compilare utilizzando le informazioni della pagina Dettagli integrazione del passaggio precedente.
Configurazione account tecnico Adobe IMS - Pagina account -
Nella pagina Account, compila i campi seguenti:
- Titolo - Inserisci un titolo account descrittivo.
- Server autorizzazioni - Tornare alla pagina dei dettagli di integrazione aperta in precedenza. Seleziona la scheda JWT. Copia il nome del server, senza il percorso, come evidenziato di seguito.
Torna alla pagina Account, quindi incolla il nome nel rispettivo campo.
Ad esempio,https://ims-na1.adobelogin.com/
(il nome del server di esempio è solo a scopo illustrativo)
Pagina dettagli integrazione - Scheda JWT -
Chiave API: torna alla pagina dei dettagli di integrazione. Seleziona la scheda Panoramica, quindi fai clic su Copia a destra del campo Chiave API (ID client).
Torna alla pagina Account, quindi incolla la chiave nel rispettivo campo.
Pagina dettagli integrazione -
Segreto client: torna alla pagina dei dettagli di integrazione. Nella scheda Panoramica, fai clic su Retrieve Client Secret (Recupera segreto client). A destra del campo Segreto client, fai clic su Copia.
Torna alla pagina Account, quindi incolla la chiave nel rispettivo campo.
-
Payload - Torna alla pagina dei dettagli di integrazione. Nella scheda JWT, copia l'intero codice oggetto JSON nel campo Payload JWT.
Torna alla pagina Account, quindi incolla il codice nel rispettivo campo.
Pagina dettagli integrazione - Scheda JWTLa pagina Account, con tutti i campi compilati, è simile alla seguente:
-
Fai clic su Crea nell'angolo superiore destro della pagina Account.
Con Experience Manager IMS configurato, ora hai un nuovo IMSAccount elencato in Configurazioni Adobe IMS.
Configurare Experience Platform Tags Cloud per l’integrazione configuring-adobe-launch-cloud-for-the-integration
-
In modalità Autore Experience Manager, nell'angolo superiore sinistro, fai clic sull'icona
-
Nella pagina Configurazioni tag Experience Platform, seleziona nel pannello a sinistra un sito Experience Manager per il quale desideri applicare la configurazione tag Experience Platform.
Solo a scopo di esempio, il sito
We.Retailè selezionato nella schermata seguente.
-
Fai clic su Crea nell’angolo superiore sinistro della pagina.
-
Nella pagina Generale (1/3 pagine) della finestra Crea configurazione tag di Experience Platform, compila i campi seguenti:
-
Titolo - Inserisci un titolo di configurazione descrittivo. Esempio:
We.Retail Tags cloud configuration. -
Configurazione Adobe IMS associata - Seleziona la configurazione IMS creata in precedenza in Configura Experience Manager IMS.
-
Società - Dall'elenco a discesa Società, seleziona la tua società Experience Cloud. L’elenco viene compilato automaticamente.
-
Proprietà - Dall'elenco a discesa Proprietà, seleziona la proprietà Experience Platform Tags creata in precedenza. L’elenco viene compilato automaticamente.
Dopo aver completato tutti i campi, la pagina Generale sarà simile alla seguente:
-
-
Fai clic su Avanti nell'angolo superiore sinistro.
-
Nella pagina Gestione temporanea (2/3 pagine) della finestra Crea configurazione tag di Experience Platform, compila il seguente campo:
Nel campo URI libreria (Uniform Resource Identifier), controlla il percorso della versione di staging della libreria Experience Platform Tags. Experience Manager compila automaticamente questo campo.
Solo a scopo illustrativo, questo passaggio utilizza le librerie di tag Experience Platform distribuite in Adobe CDN.
note note NOTE Verifica che l’URI della libreria con compilazione automatica (Uniform Resource Identifier) sia formato correttamente. Se necessario, correggerlo in modo che l’URI rappresenti un URI relativo al protocollo. In altre parole, inizia da una doppia barra in avanti. Ad esempio: //assets.adobetm.com/launch-xxxx.È probabile che la pagina Gestione temporanea sia simile alla seguente. Le opzioni Archivia e Carica libreria in modo asincrono sono non impostate:
-
Fai clic su Avanti nell'angolo superiore destro.
-
Se necessario, nella pagina Produzione (3/3 pagine) della finestra Crea configurazione tag di Experience Platform, correggi l'URI di produzione con compilazione automatica con una procedura simile a quella della pagina Staging precedente.
-
Fai clic su Crea nell'angolo superiore destro.
La nuova configurazione cloud di tag di Experience Platform viene ora creata ed elencata accanto al sito web.
-
Seleziona la nuova configurazione cloud di tag Experience Platform (quando è selezionata, a sinistra del titolo della configurazione compare un segno di spunta). Sulla barra degli strumenti fare clic su Pubblica.
Attualmente, Experience Manager Author non supporta l’integrazione dei visualizzatori Dynamic Media con i tag di Experience Platform.
È, tuttavia, supportato nel nodo di pubblicazione di Experience Manager. Utilizzando le impostazioni predefinite di Configurazione cloud dei tag di Experience Platform, Experience Manager Publish utilizza l’ambiente di produzione dei tag di Experience Platform. Di conseguenza, ogni volta durante il test è necessario inviare gli aggiornamenti della libreria di tag di Experience Platform dallo Sviluppo all’ambiente di produzione.
È possibile aggirare questo limite. Specifica l’URL di sviluppo o staging della libreria di tag di Experience Platform nella configurazione cloud di tag di Experience Platform per la pubblicazione di Experience Manager di cui sopra. In questo modo, il nodo di pubblicazione di Experience Manager utilizza la versione di sviluppo o staging della libreria di tag di Experience Platform.
Per ulteriori informazioni sulla configurazione cloud dei tag di Experience Platform, vedere Integrate Experience Platform Tags and Experience Manager.