Utilizza questa documentazione per maggiori informazioni sull’installazione, la configurazione e l’implementazione dell’estensione Adobe Media Analytics (3.x SDK) for Audio and Video (estensione Media Analytics). Sono incluse le opzioni disponibili quando si utilizza questa estensione per generare una regola, insieme a esempi e collegamenti a campioni.
L’estensione Media Analytics (MA) aggiunge l’SDK principale JavaScript Media SDK (Media 3.x SDK). Questa estensione fornisce la funzionalità per aggiungere l’istanza di tracciamento Media
a un sito o a un progetto Adobe Experience Platform Launch. L’estensione MA richiede due estensioni aggiuntive:
Questa estensione viene distribuita con Media 3.x SDK, che non è compatibile con le versioni precedenti quali Media 2.x SDK. Se la pagina utilizza già Media 2.x SDK, utilizza l’estensione Adobe Media Analytics for Audio and Video invece di questa estensione.
Dopo aver incluso tutte e tre le estensioni precedentemente menzionate nel progetto Platform Launch, puoi procedere in uno dei due modi seguenti:
Media
dalla Web appMedia
. Questa istanza viene esposta tramite l'estensione MA.Installazione: Per installare l'estensione MA, aprire la proprietà dell'estensione, selezionare Extensions > Catalog, passare il puntatore del mouse sull' Adobe Media Analytics (3.x SDK) for Audio and Video estensione e selezionare Install.
Configura: Per configurare l'estensione MA, aprire la Extensions scheda, passare il mouse sull'estensione, quindi selezionare Configure:
Opzione | Descrizione |
---|---|
Collection API Server | Definisce il server API di Media Collection (per ottenere questo server, contatta il rappresentante Adobe) |
Application Version | Versione dell'app/SDK del lettore multimediale |
Player Name | Nome del lettore multimediale in uso (ad esempio "AVPlayer", "HTML5 Player", "My Custom VideoPlayer") |
Channel | Proprietà nome canale |
Debug Logging | Attiva o disattiva la registrazione |
Enable SSL | Attiva o disattiva l'invio di ping su HTTPS |
Export APIs to Window Object | Attivare o disattivare l'esportazione delle API di Media Analytics all'ambito globale |
Variable Name | Una variabile utilizzata per esportare le API di Media Analytics sotto l'oggetto window |
Promemoria: l'estensione MA richiede le estensioni Analytics ed Experience Cloud ID. Devi aggiungere queste estensioni alla proprietà dell'estensione e configurarle.
L’estensione MA esporta le API di Media nell’oggetto finestra globale abilitando l’impostazione “Export APIs to Window Objects” nella pagina Configuration. Esporta le API sotto il nome della variabile configurato. Ad esempio, se il nome della variabile è configurato come ADB
allora è possibile accedere alle API di Media tramite window.ADB.Media
.
L’estensione MA esporta le API solo se window["CONFIGURED_VARIABLE_NAME"]
non è definita e non sostituisce le variabili esistenti.
API di Media: window["CONFIGURED_VARIABLE_NAME"].Media
Questo espone tutte le API e le costanti di Media SDK: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
Crea un’istanza di tracciamento Media: window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
Valore restituito: un’istanza di tracciamento Media
per tenere traccia di una sessione multimediale.
var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
var tracker = Media.getInstance();
Utilizzando l’istanza di tracciamento Media, segui la documentazione API JS per implementare il tracciamento dei contenuti multimediali.
Ottieni il sample player qui: MA Sample Player. Il sample player funge da riferimento per mostrare come utilizzare l’estensione MA per supportare Media Analytics direttamente da una Web app.
L’estensione MA espone media
come modulo condiviso ad altre estensioni. (Per ulteriori informazioni sui moduli condivisi, consulta la documentazione Moduli condivisi.)
Puoi accedere ai moduli condivisi solo da altre estensioni. In altre parole, una pagina web/app JavaScript non può accedere ai moduli condivisi, né utilizzare turbine
(vedi il codice di esempio di seguito) al di fuori di un’estensione.
API di Media: media
modulo condiviso
Questo espone tutte le API e le costanti di Media SDK: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
Crea l’istanza di tracciamento Media come segue:
Valore restituito: un’istanza di tracciamento Media
per tenere traccia di una sessione multimediale.
var Media =
turbine.getSharedModule('adobe-media-analytics', 'media');
var tracker = Media.getInstance();
Utilizzando l’istanza di tracciamento Media, segui la documentazione API JS per implementare il tracciamento dei contenuti multimediali.
Test: per questa versione, per testare l’estensione devi caricarla in Adobe Experience Platform Launch, dove puoi accedere a tutte le estensioni dipendenti.