Integrare i visualizzatori Dynamic Medie con Adobe Analytics e i tag Experience Platform integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch
Cos’è l’integrazione dei visualizzatori Dynamic Medie con Adobe Analytics e i tag Experience Platform? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch
Estensione Visualizzatori Dynamic Medie per Tag Experienci Platform e Visualizzatori Dynamic Medie 5.13, che consente ai clienti di Adobe Analytics e Tag Experienci Platform di utilizzare eventi e dati specifici per i visualizzatori Dynamic Medie nella propria configurazione di Tag Experienci Platform.
Grazie a questa integrazione è possibile tenere traccia dell’utilizzo dei visualizzatori Dynamic Medie sul sito web con Adobe Analytics. Allo stesso tempo, puoi utilizzare gli eventi e i dati esposti dai visualizzatori con qualsiasi altra estensione di Tag di Experience Platform che provenga da Adobe o da una terza parte.
Per ulteriori informazioni sulle estensioni Adobe o di terze parti, consulta Estensioni Adobe nella Guida utente dei tag Experience Platform.
Questo argomento è destinato ai seguenti utenti: amministratori di siti, sviluppatori nell'Experience Platform e utenti nelle operazioni.
Limitazioni dell’integrazione limitations-of-the-integration
- L’integrazione dei tag di Experience Platform per i visualizzatori Dynamic Medie non funziona nel nodo dell’autore Experience Manager. Non puoi visualizzare alcun tracciamento da una pagina WCM finché non viene pubblicata.
- L’integrazione di tag di Experience Platform per i visualizzatori Dynamic Medie 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, il monitoraggio di QoS, annunci, capitoli/segmenti o errori non è supportato.
- La configurazione della durata di archiviazione per gli elementi dati non è supportata per gli elementi dati che utilizzano l'estensione Dynamic Medie 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 Experience Platform è costituito dai clienti che utilizzano sia Adobe Experience Manager Assets che Adobe Experience Manager Sites. In tali scenari, puoi impostare un’integrazione standard tra il nodo di authoring dell’Experience Manager e i tag dell’Experience Platform, quindi associare l’istanza Sites alla proprietà dei tag dell’Experience Platform. Successivamente, qualsiasi componente WCM di Dynamic Medie aggiunto a una pagina Sites terrà traccia dei dati e degli eventi provenienti dai visualizzatori.
Vedi Tracciare i visualizzatori Dynamic Medie 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 Experienci Platform e aggiungilo manualmente al codice della pagina web.
Vedi Tracciare i visualizzatori Dynamic Medie utilizzando il codice di incorporamento.
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 Medie: Adobe Analytics e Adobe Analytics per audio e video.
Informazioni sul tracciamento con Adobe Analytics about-tracking-using-adobe-analytics
Adobe Analytics consente di tenere traccia delle azioni eseguite dall’utente finale quando interagiscono con i visualizzatori Dynamic Medie 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.
Nell'Experience Platform di Tag, 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 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 Medie.
Le opzioni disponibili per la definizione di un elemento dati dipendono dall’elenco delle estensioni installate nella proprietà Experience Platform Tags. 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 Medie 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 Medie Viewer mantiene automaticamente aggiornati i valori degli elementi dati.
Dopo averlo definito, un elemento dati può essere utilizzato in altre posizioni dell’interfaccia utente dei tag di Experience Platform, utilizzando il widget del selettore Elemento dati. In particolare, per gli elementi dati definiti ai fini del tracciamento dei visualizzatori Dynamic Medie si fa riferimento all’azione Imposta variabili dell’estensione Adobe Analytics nella regola (vedi di seguito).
Vedi Elementi dati.
Informazioni sulle regole nei tag Experience Platform about-rules-in-adobe-launch
Una regola in Experience Platform Tags è una configurazione agnostica che definisce tre aree che compongono una regola: Eventi, Condizioni e Azioni:
- Eventi (if) indica ai tag Experience Platform quando attivare una regola.
- Condizioni (if) indica all'Experience Platform Tags le altre restrizioni da consentire o non consentire quando si attiva una regola.
- Azioni (then) indica all'Experience Platform Tag cosa fare quando viene attivata una regola.
Le opzioni disponibili nella sezione Eventi, Condizioni e Azioni dipendono dalle estensioni installate nella proprietà Experience Platform Tags. L'estensione Core è preinstallata ed è disponibile come strumento predefinito in qualsiasi configurazione. L'estensione fornisce diverse opzioni per Eventi, ad esempio azioni di base a livello di browser. Tali azioni includono il cambiamento dell’elemento attivo, le pressioni dei tasti e l’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 Medie Viewers estende l’elenco degli eventi supportati agli eventi specifici dei visualizzatori Dynamic Medie, come il caricamento del visualizzatore, lo scambio di risorse, lo zoom in e la 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 Medie, è possibile utilizzare uno dei seguenti tipi:
- Eventi dall’estensione Dynamic Medie 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 Imposta variabili deve essere seguita da un'azione Invia beacon. 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.
Vedi Regole.
Configurazione di esempio sample-configuration
La seguente configurazione di esempio in 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 Medie Viewers.
-
Dalla scheda Regole, definisci una regola TrackAssetOnLoad.
In questa regola, il campo Event utilizza l'evento LOAD dell'estensione Dynamic Medie 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 sarà simile alla seguente:
Informazioni su Adobe Analytics per audio e video about-adobe-analytics-for-audio-and-video
Quando un account di Experience Cloud è abbonato per utilizzare Adobe Analytics for Audio and Video, è sufficiente abilitare il tracciamento video nelle impostazioni dell'estensione Dynamic Medie Viewers. Le metriche video diventano disponibili in Adobe Analytics. Il tracciamento video dipende dalla presenza dell’estensione Analytics for Audio and Video di Adobe Medium.
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, il monitoraggio di QoS, annunci, capitoli/segmenti o errori non è supportato.
Utilizzare l’estensione Dynamic Medie Viewers using-the-dynamic-media-viewers-extension
Come indicato in Casi d'uso per l'integrazione, è possibile tenere traccia dei visualizzatori Dynamic Medie con la nuova integrazione dei tag di Experience Platform in Experience Manager Sites e utilizzando il codice di incorporamento.
Tracciare i visualizzatori Dynamic Medie in Experience Manager Sites tracking-dynamic-media-viewers-in-aem-sites
Per tenere traccia dei visualizzatori Dynamic Medie 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 aver eseguito la configurazione corretta, qualsiasi visualizzatore Dynamic Medie aggiunto a una pagina Sites utilizzando un componente WCM supportato da Dynamic Medie tiene traccia automaticamente dei dati su Adobe Analytics, Adobe Analytics for Video o entrambi.
Tracciare i visualizzatori Dynamic Medie utilizzando il codice di incorporamento tracking-dynamic-media-viewers-using-embed-code
I clienti che non utilizzano Experience Manager Sites o che non incorporano i visualizzatori Dynamic Medie in pagine web al di fuori di Experience Manager Sites, o in entrambi i casi, possono comunque utilizzare l’integrazione Experience Platform di tag.
Completa i passaggi di configurazione dalle sezioni Configura Adobe Analytics e Configura tag di Experience Platform. Tuttavia, i passaggi di configurazione relativi agli Experienci Manager non sono necessari.
Dopo aver configurato correttamente il sistema, puoi aggiungere il supporto dei tag di Experience Platform a una pagina web con un visualizzatore Dynamic Medie.
Per ulteriori informazioni sull'utilizzo del codice di incorporamento della libreria Experience Platform Tags, consulta Aggiungere il codice di incorporamento dei tag di Experience Platform.
Tieni traccia dei visualizzatori Dynamic Medie utilizzando il codice di incorporamento:
- Prepara una pagina web per incorporare un visualizzatore Dynamic Medie.
- Ottieni il codice di incorporamento per la libreria di tag di Experience Platform effettuando prima l'accesso a Tag di Experience Platform (consulta Configurazione dei tag di Experience Platform).
- Seleziona Proprietà, quindi seleziona la scheda Ambienti.
- Scegli il livello di ambiente pertinente all’ambiente della pagina web. Quindi, nella colonna Installa, seleziona l'icona della casella.
- Nella finestra di dialogo Istruzioni di installazione Web, copia il codice di incorporamento completo della libreria di tag di Experience Platform, insieme ai tag
<script/>circostanti.
Guida di riferimento per l’estensione Dynamic Medie Viewers reference-guide-for-the-dynamic-media-viewers-extension
Informazioni sulla configurazione dei visualizzatori Dynamic Medie about-the-dynamic-media-viewers-configuration
L’estensione Dynamic Medie Viewer si integra automaticamente con la libreria di tag di Experience Platform se sono soddisfatte le seguenti condizioni:
-
Experience Platform Nella pagina è presente l'oggetto globale della libreria Tag (
_satellite). -
La funzione di estensione dei visualizzatori Dynamic Medie
_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 Medie Viewers configuring-the-dynamic-media-viewers-extension
L'unica opzione di configurazione per l'estensione Dynamic Medie Viewers è Abilita Adobe Medium Analytics per audio e video.
Quando selezioni (abilita) questa opzione e l’estensione Adobe Medium 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 che sia installata l'estensione Adobe Medium Analytics for Audio and Video, l'opzione non ha alcun effetto.
Informazioni sugli elementi dati nell’estensione Dynamic Medie 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:
- DM viewers event data type (Tipo di dati evento visualizzatori DM): un elenco a discesa che identifica tutti gli eventi visualizzatore supportati dall’estensione Dynamic Media Viewers che presentano argomenti, con l’aggiunta di un elemento COMMON speciale. 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 Medie selezionato.
Per un elenco degli eventi supportati per ciascun tipo di visualizzatore, consulta la guida di riferimento per visualizzatori Dynamic Medie. Vai alla sezione del visualizzatore specifico, quindi seleziona Supporto per la sottosezione di tracciamento di Adobe Analytics. Attualmente, la guida di riferimento per i visualizzatori Dynamic Medie non documenta gli argomenti dell’evento.
Considera ora il ciclo di vita dei visualizzatori Dynamic Medie Elemento dati. Il valore di tale elemento dati viene popolato dopo che l’evento visualizzatore Dynamic Medie corrispondente si verifica sulla pagina. Si supponga ad esempio che l'elemento dati punti all'evento LOAD e al relativo argomento "asset". In questo caso, il valore di tale elemento dati riceve dati validi dopo che il visualizzatore ha eseguito per la prima volta l'evento LOAD. 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'unica regola presente nella configurazione della regola viene attivata dall'evento LOAD. 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 l’elemento dati è richiesto in una regola che è stata attivata da un evento visualizzatore Dynamic Medie, viene restituito il valore dell’elemento dati per il visualizzatore che ha avviato la regola. Inoltre, l’elemento dati è richiesto in una regola che è stata attivata da un evento di un’altra estensione di tag di Experience Platform. 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 Medie: 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 di Dynamic Medie come attivatore.
- Invia il valore dell'elemento dati ZoomScale ad Adobe Analytics.
-
Regola TrackKey con:
- Utilizza come attivatore l’evento di pressione del tasto dall’estensione Core Experience Platform Tags.
- Invia il valore dell'elemento dati ZoomScale ad Adobe Analytics.
Ora, supponiamo che l’utente finale 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 una panoramica dell'immagine e infine viene selezionato un tasto sulla tastiera.
L’attività dell’utente finale comporta l’esecuzione delle due chiamate di tracciamento seguenti 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 il 50% come valore dell'elemento dati ZoomScale perché l'elemento dati sa che la regola è attivata da viewer1 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é la regola non è stata attivata dal visualizzatore. 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 Medie viene memorizzato nel codice della libreria dei tag di Experience Platform anche dopo che il visualizzatore stesso è stato eliminato sulla pagina web. Questa funzionalità significa che se esiste una regola attivata da un’estensione non Dynamic Medie Viewer e fa riferimento a tale elemento dati, l’elemento dati restituisce l’ultimo valore noto. Anche se il visualizzatore non è più presente nella pagina web.
In ogni caso, i valori di Elementi dati guidati da Visualizzatori Dynamic Medie non vengono memorizzati nell’archiviazione locale o sul server, ma solo nella libreria di tag di 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 Medie 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 Medie 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 Medie Viewers aggiunge un Tipo evento denominato Evento visualizzatore.
Se selezionato, l'editor eventi esegue il rendering dell'elenco a discesa Eventi visualizzatore Dynamic Medie, elencando tutti gli eventi disponibili supportati dai visualizzatori Dynamic Medie.
Informazioni sull’editor delle azioni about-the-actions-editor
L’estensione Dynamic Medie Viewers consente di utilizzare i parametri evento dei visualizzatori Dynamic Medie per la mappatura sulle variabili di analisi nell’editor Set Variables 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 Medie Viewer.
- Infine, nell'editor Set Variables dell'estensione Adobe Analytics, seleziona l'icona del selettore Data Element (tre dischi sovrapposti) per aprire la finestra di dialogo Seleziona elemento dati, quindi seleziona un elemento dati da essa.
È tuttavia possibile adottare un approccio alternativo e ignorare la creazione di elementi dati. È possibile fare riferimento diretto a un argomento da un evento Dynamic Medie Viewer. Immetti il nome completo dell'argomento evento nel campo di input value dell'assegnazione della variabile Analytics. Accertatevi di racchiuderla con i segni di percentuale (%). 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. Ad esempio, selezionando la 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, il riferimento a %event.detail.dm.LOAD.asset% restituisce il nome corretto della risorsa se la regola viene attivata dall’evento LOAD dell’estensione Dynamic Media Viewer. Tuttavia, restituisce un valore vuoto per qualsiasi altro evento.
Nella tabella seguente sono elencati gli eventi di Dynamic Medie Viewer e i relativi argomenti supportati:
Configurare tutte le parti dell’integrazione configuring-all-the-integration-pieces
PRIMA DI INIZIARE
L’Adobe consiglia di esaminare attentamente tutta la documentazione che precede questa sezione in modo da comprendere l’integrazione completa.
Questa sezione descrive i passaggi di configurazione necessari per integrare i visualizzatori Dynamic Medie con Adobe Analytics e Adobe Analytics for Audio and Video. Anche se è possibile utilizzare l’estensione Dynamic Medie Viewers per altri scopi nei tag Experience Platform, tali scenari non sono trattati in questa documentazione.
Stai per utilizzare i seguenti prodotti di 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 anche la seguente configurazione:
- Adobe Developer Console - viene creata l'integrazione per Experience Platform Tags.
- Nodo di authoring di Experienci Manager: configurazione IMS e configurazione cloud di tag di Experienci Platform.
Come parte della configurazione, accertati di avere accesso a una società in Adobe Experience Cloud per la quale sono già abilitati Adobe Analytics e Tag Experienci Platform.
Configurare Adobe Analytics per l’integrazione configuring-adobe-analytics-for-the-integration
Dopo aver configurato Adobe Analytics, per l’integrazione viene configurato quanto segue:
- Una suite di rapporti è attiva e 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 dell'Experience Cloud. Sulla barra dei menu, seleziona l'icona Soluzioni (una tabella di punti tre per tre) nell'angolo superiore destro della pagina, quindi seleziona Analytics.
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ù report suite e non sai quale utilizzare, contatta l’amministratore Adobe Analytics che ti fornirà supporto al riguardo.
Nella schermata 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 di 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 Medie sulla pagina web.
È possibile utilizzare qualsiasi tipo di variabile supportata da Adobe Analytics. La decisione sul tipo di variabile (come Traffico personalizzato [props], Conversione [eVar]) è guidata dalle esigenze specifiche della tua implementazione di Analytics.
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 nella barra degli strumenti.
-
Nella pagina Gestione suite di rapporti, seleziona il rapporto corretto, quindi nella barra degli strumenti passa a Modifica impostazioni > Traffico > Variabili di traffico.
-
Selezionare una variabile non utilizzata, assegnarle un nome descrittivo (Risorsa visualizzatore (prop 30)) e 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, selezionare Salva.
Configurare un rapporto setting-up-a-report
-
In generale, la configurazione di un rapporto in Adobe Analytics è guidata da esigenze specifiche del progetto. Di conseguenza, la configurazione dettagliata dei rapporti 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 viene configurato quanto segue:
- 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 Medie, 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 Experience Platform dalla home page dell'Experience Cloud. Sulla barra dei menu, seleziona l'icona Soluzioni (tre per tre punti di tabella) nell'angolo superiore destro della pagina, quindi seleziona Tag.
Puoi anche aprire direttamente i tag di Experience Platform.
Creare una proprietà in Experience Platform Tags 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).
Vedi anche Creare una proprietà Tags.
-
In Tag Experience Platform, selezionare 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 delle estensioni (non sarà possibile modificarlo in seguito) nel caso in cui l'estensione che desideri utilizzare, in questo caso Visualizzatori Dynamic Medie, non sia ancora stata rilasciata.
-
Seleziona Salva.
Seleziona la proprietà appena creata, quindi passa a Installazione e configurazione delle estensioni.
Installazione e configurazione delle estensioni installing-and-setup-of-extensions
Tutte le estensioni disponibili in Experience Platform Tags sono elencate in Estensioni > Catalogo.
Per installare un'estensione, selezionare Installa. Se necessario, eseguire una configurazione di estensione una tantum, quindi selezionare Salva.
Se necessario, è necessario installare e configurare le seguenti estensioni:
- (Obbligatorio) Estensione Experience Cloud ID Service.
Non è necessaria alcuna configurazione aggiuntiva, accetta tutti i valori proposti. Al termine, assicurati di selezionare Salva.
Consulta Estensione del servizio Adobe 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 in Selezionare una suite di rapporti in precedenza.)
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 prevede di 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) Adobi Medium Estensione Analytics for Audio and Video
Compila il campo del server di tracciamento. Il server di tracciamento per l'estensione Adobe Medium 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 Analytics for Audio and Video per Adobe Medium.
- (Obbligatorio) Estensione Visualizzatori Dynamic Medie
Per attivare il tracking Video Heartbeat, seleziona enable Adobe Analytics for Video (Abilita Adobe Analytics per video).
Al momento della stesura di questo Experience Platform, l'estensione Dynamic Medie Viewers è disponibile solo se la proprietà Tag è stata creata per lo sviluppo.
Vedi 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 Medie.
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 Medie Viewers per informazioni approfondite sulle funzionalità dell'estensione.
Publish 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 in Tag di Experience Platform viene eseguita dalla scheda Pubblicazione nella configurazione di Proprietà.
I tag di 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 dell’autore dell’Experience Manager all’ambiente di stage dei tag di Experience Platform. Il nodo Publish di Experience Manager punta all’ambiente di produzione dei tag di Experience Platform. Ciò significa che con le impostazioni di Experience Manager predefinite, è necessario pubblicare la libreria dei tag di Experience Platform nell’ambiente di staging. In questo modo puoi utilizzarlo in Experience Manager Author. Puoi quindi pubblicarlo nell’ambiente di produzione in modo che possa essere utilizzato in Experience Manager Publish.
Per ulteriori informazioni sugli ambienti di tag di 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 Experience Platform, l’elenco delle librerie è vuoto.
Nella colonna sinistra, selezionare Aggiungi nuova libreria.
-
Nella pagina Crea nuova libreria, immetti un nome descrittivo per la 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, seleziona Aggiungi tutte le risorse modificate.
-
Nell'angolo superiore destro della pagina, seleziona Salva e genera per sviluppo.
In pochi minuti, la libreria viene creata ed è pronta per l’uso.
note note NOTE Alla prossima modifica della configurazione dei tag di Experience Platform, vai alla scheda Pubblicazione nella configurazione Proprietà, quindi seleziona la libreria creata in precedenza. Dalla schermata di pubblicazione della libreria, seleziona Aggiungi tutte le risorse modificate, quindi seleziona 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, selezionare Invia per approvazione.
-
Nella finestra di dialogo di conferma, seleziona Invia.
Dopo aver spostato la libreria nella colonna Inviata, dal menu a discesa della libreria, selezionare 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, seleziona Approva per la pubblicazione.
-
Dal menu a discesa, selezionare Build & Publish to Production.
Per ulteriori informazioni sulla pubblicazione in Experience Platform Tags, vedere Pubblicazione.
Configurare Adobe Experience Manager per l’integrazione configuring-adobe-experience-manager-for-the-integration
Prerequisiti:
- L’Experience Manager esegue sia le istanze Author che Publish.
- Il nodo di authoring Experience Manager è configurato in modalità di esecuzione Dynamic Medie - Scene7 (dynamicmedia_s7)
- I componenti WCM di Dynamic Medie sono abilitati in Experience Manager Sites.
La configurazione di Experience Manager è costituita dai due passaggi principali seguenti:
- Configurazione di Experience Manager IMS.
- Configurazione di Experience Platform Tags Cloud.
Configurare Experience Manager IMS configuring-aem-ims
-
Nell'Experience Manager Autore, seleziona l'icona Strumenti (martello), quindi vai a Sicurezza > Configurazioni Adobe IMS.
-
Nella pagina Configurazione IMC di Adobe, nell'angolo superiore sinistro, selezionare Crea.
-
Nella pagina Configurazione account tecnico Adobe IMS, seleziona Tag Experience Platform nell'elenco a discesa Soluzione cloud.
-
Abilita Crea nuovo certificato, quindi immetti un valore significativo per il certificato nel campo di testo. Ad esempio, AdobeLaunchIMSCert. Seleziona Crea certificato.
Viene visualizzato il seguente messaggio informativo:
Per recuperare un token di accesso valido, la nuova chiave pubblica del certificato viene aggiunta all'account tecnico in Adobe Developer Console!
Per chiudere la finestra di dialogo Info, selezionare OK.
-
Per scaricare un file di chiave pubblica (*.crt) nel sistema locale, selezionare Scarica chiave pubblica.
note note NOTE A questo punto, lascia aperta la pagina Configurazione account tecnico Adobe IMS; non chiude la pagina e non seleziona 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, selezionare Nuova integrazione.
-
Nella finestra di dialogo Crea una nuova integrazione, accertati che sia selezionato il pulsante di scelta Accedi a un'API, quindi seleziona Continua.
-
Nella seconda pagina Crea una nuova integrazione, abilita (attiva) il pulsante di scelta API tag Experience Platform. Nell'angolo inferiore destro della pagina, seleziona 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 la descrizione per l'integrazione.
-
Nell'area Certificati a chiave pubblica, caricare 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, selezionare 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, selezionare 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 dei dettagli di integrazione.
-
Torna alla pagina Configurazione account tecnico Adobe IMS che hai lasciato aperta in precedenza. Nell'angolo superiore destro della pagina, seleziona Avanti per aprire la pagina Account nella finestra Configurazione account tecnico Adobe IMS.
Se la pagina è stata chiusa in precedenza, torna all'istanza di authoring di Experience Manager, quindi passa a Strumenti > Sicurezza > Configurazioni Adobe IMS. Seleziona Crea. Nell'elenco a discesa Soluzione cloud, selezionare Tag Experience Platform. Nell'elenco a discesa Certificato selezionare il nome del certificato creato in precedenza.)
Pagina Configurazione account tecnico Adobe IMS: Certificato.
-
La pagina Account contiene cinque campi che è necessario compilare utilizzando le informazioni della pagina Dettagli integrazione del passaggio precedente.
Pagina Configurazione account tecnico Adobe IMS: 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. Copiare 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 è solo un esempio)
Pagina dei dettagli di integrazione: scheda JWT
-
Chiave API: torna alla pagina dei dettagli di integrazione. Seleziona la scheda Panoramica, quindi a destra del campo Chiave API (ID client) seleziona Copia.
Torna alla pagina Account, quindi incolla la chiave nel rispettivo campo.
Pagina dei dettagli di integrazione.
-
Segreto client - Torna alla pagina dei dettagli di integrazione. Dalla scheda Panoramica, seleziona Recupera segreto client. A destra del campo Segreto client, selezionare 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 dei dettagli di integrazione - Scheda JWT
La pagina Account, con tutti i campi compilati, è simile alla seguente:
-
Selezionare 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 Experience Manager Author, nell'angolo in alto a sinistra, seleziona l'icona Strumenti (martello), quindi vai a Cloud Service > Experience Platform configurazioni tag.
-
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.
-
Selezionare 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à - Seleziona la tua società di Experience Cloud dall'elenco a discesa Società. L’elenco viene compilato automaticamente.
-
Proprietà - Dall'elenco a discesa Proprietà, seleziona la proprietà Tag di Experience Platform creata in precedenza. L’elenco viene compilato automaticamente.
Dopo aver completato tutti i campi, la pagina Generale sarà simile alla seguente:
-
-
Nell'angolo superiore sinistro selezionare Avanti.
-
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 di tag di Experience Platform. Experience Manager compila automaticamente questo campo.
Solo a scopo di esempio, 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) non abbia un formato valido. 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:
-
Nell'angolo superiore destro selezionare Avanti.
-
Se necessario, nella pagina Produzione (3/3 pagine) della finestra Crea configurazione tag Experience Platform, correggi l'URI di produzione con compilazione automatica con una procedura simile a quella della pagina Staging precedente.
-
Nell'angolo superiore destro selezionare Crea.
Il nuovo Experience Platform Configurazione cloud tag viene ora creato ed elencato accanto al sito web in modo simile al seguente:
-
Seleziona il nuovo Experience Platform Configurazione cloud di tag (quando è selezionato, a sinistra del titolo della configurazione compare un segno di spunta). Sulla barra degli strumenti, selezionare Publish.
Attualmente, Experience Manager Author non supporta l’integrazione dei visualizzatori Dynamic Medie con i tag Experience Platform.
Tuttavia, è supportato nel nodo Publish di Experience Manager. Utilizzando le impostazioni predefinite di Configurazione cloud tag di Experience Platform, il nodo di pubblicazione di Experience Manager 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 da Sviluppo all’ambiente di produzione.
È possibile aggirare questo limite. Specifica l’URL di sviluppo o staging della libreria Tag di Platform nella configurazione cloud di Tag di Experience Platform per il nodo Publish di Experience Manager qui sopra. In questo modo il nodo Publish di Experience Manager utilizza la versione di sviluppo o staging della libreria Tag di Experience Platform.
Per ulteriori informazioni sulla configurazione cloud dei tag Experience Manager, consulta Integrare Experience Platform con i tag Experience Platform tramite Adobe Developer Console.