Puoi configurare il lettore per il tracciamento e l’analisi dell’utilizzo dei video.
Prima di attivare il tracciamento video (heartbeat video), assicurati di disporre dei seguenti elementi:
Endpoint del server di tracciamento AppMeasurement | URL dell’endpoint di raccolta back-end Adobe Analytics (precedentemente SiteCatalyst). |
Endpoint del server di tracciamento di Video Analytics | URL dell’endpoint della raccolta back-end di analisi video. Qui vengono inviate tutte le chiamate di tracciamento heartbeat video. Suggerimento: l'URL del server di tracciamento dei visitatori corrisponde all'URL del server di tracciamento di Analytics. Per informazioni sull'implementazione del servizio ID visitatori, vedi Implementazione del servizio ID . |
Nome account | Noto anche come ID suite di rapporti (RSID). |
ID organizzazione Marketing Cloud | Valore stringa necessario per creare un’istanza del componente Visitatore. |
Endpoint del server di tracciamento dei visitatori | L’URL dell’endpoint back-end che fornisce un identificatore univoco per il visualizzatore video corrente. |
Editore | Questo è l’ID dell’editore, fornito ai clienti dal loro rappresentante Adobe. Suggerimento: questo ID non è solo una stringa con il nome del brand/televisore. |
Per configurare il tracciamento video nel lettore:
Crea un’istanza e configura la libreria VisitorAPI.
Considera le seguenti informazioni:
La creazione di un'istanza richiede un parametro di input dell'ID organizzazione del Marketing Cloud fornito da Adobe.
Questo è un valore stringa.
L’unica opzione di configurazione per la libreria VisitorAPI è l’URL dell’endpoint back-end che fornisce l’identificatore univoco per l’utente corrente.
L’URL del server di tracciamento dei visitatori è uguale all’URL del server di tracciamento di Analytics.
Per informazioni sull'implementazione del servizio ID visitatori, vedi Implementazione del servizio ID visitatori.
var_visitor = new Visitor("MARKETING_CLOUD_ORG_ID");
_visitor.trackingServer = "URL_OF_THE_VISITOR_TRACKER_SERVER”;
Crea un’istanza e configura il componente AppMeasurement.
L’istanza di AppMeasurement dispone di molte opzioni di configurazione. Per ulteriori informazioni, consulta Sviluppatore Adobe Analytics documentazione. Le opzioni nel codice di esempio seguente ( account
, visitorNamespace
, e trackingServer
) e i valori sono forniti da Adobe.
È necessario assicurarsi che la catena di dipendenze sia impostata correttamente. L’istanza di AppMeasurement aggrega (dipende da) il componente API visitatore.
var appMeasurement = new AppMeasurement();
appMeasurement.visitor = visitor;
appMeasurement.trackingServer = 'URL_OF_THE_ADOBE_ANALYTICS_TRACKING_SERVER';
appMeasurement.account = 'ACCOUNT_NAME'; // Also known as RSID
appMeasurement.pageName = 'Sample Page Name';
appMeasurement.charSet = "UTF-8";
appMeasurement.visitorID = "test-vid";
Nell’applicazione, assicurati che appMeasurementObject.visitor
viene popolato prima di avviare il flusso di analisi video, oppure potresti non ottenere alcun risultato di tracciamento. Questi risultati sono indicati dai messaggi nel registro. Puoi aggiungere una chiamata di tracciamento vuota ( appMeasurementObject.track
), polling visitor
finché non viene popolato, quindi avvia video analytics.
Inizializza e configura i metadati di tracciamento heartbeat video.
Puoi arrestare il modulo di analisi video nel flusso intermedio e reinizializzarlo, se necessario. Prima di reinizializzare il modulo, accertati che anche i metadati di analisi video siano aggiornati ai metadati di contenuto corretti. Per ricreare i metadati, ripeti i passaggi secondari 1 e 2.
Crea un’istanza dei metadati di Video Analytics.
Questa istanza contiene tutte le informazioni di configurazione necessarie per abilitare il tracciamento heartbeat video. Ad esempio:
function getVideoAnalyticsMetadata() {
var vaObj = new AdobePSDK.VA.VideoAnalyticsMetadata();
vaObj.appMeasurement = appMeasurement;
vaObj.trackingServer = 'hbTrackingServer';
vaObj.publisher = 'hbPublisher';
vaObj.channel = 'sample-channel';
vaObj.playerName = 'TVSDK-HTML';
vaObj.appVersion = '1.0.0';
vaObj.videoName = 'hbFriendlyName'; // this will overwrite the ContextData variable a.media.friendlyName
vaObj.assetDuration = durationInSeconds;
// use this to override the default asset length of -1 for live streams
vaObj.debugLogging = false;
return vaObj;
}
Dopo aver creato un’istanza del lettore multimediale, crea un’istanza di tracciamento di Video Analytics e fornisci un riferimento all’istanza del lettore multimediale.
Tenere presente quanto segue:
Crea sempre una nuova istanza di tracciamento per ogni sessione di riproduzione del contenuto e rimuovi il riferimento precedente (dopo aver staccato l’istanza del lettore multimediale).
I metadati creati nel passaggio secondario 1 devono essere forniti nel costruttore del tracciatore di Video Analytics.
var videoAnalyticsMetadata = getVideoAnalyticsMetadata();
videoAnalyticsProvider = new AdobePSDK.VA.VideoAnalyticsProvider(videoAnalyticsMetadata);
videoAnalyticsProvider.attachMediaPlayer(player);
Distruggi il tracker di Video Analytics.
Prima di iniziare una nuova sessione di riproduzione del contenuto, elimina l’istanza precedente del tracciatore video. Dopo aver ricevuto l’evento di completamento del contenuto (o la notifica), attendi alcuni minuti prima di eliminare l’istanza di tracciamento video. Distruggere immediatamente l’istanza potrebbe interferire con la capacità del tracciatore di Video Analytics di inviare un ping video completo.
if (videoAnalyticsProvider) {
videoAnalyticsProvider.detachMediaPlayer();
videoAnalyticsProvider = null;
Contrassegna manualmente il flusso live/lineare come completato.
Se hai diversi episodi su un flusso live, puoi contrassegnare manualmente un episodio come completo utilizzando l’API completa. In questo modo si termina la sessione di tracciamento video per l’episodio video corrente e si può avviare una nuova sessione di tracciamento per l’episodio successivo.
Questa API è facoltativa e non è necessaria per il tracciamento video VOD.
if (videoAnalyticsProvider)
{
videoAnalyticsProvider.trackVideoComplete();
videoAnalyticsProvider.detachMediaPlayer();
videoAnalyticsProvider = null;
// Create a new instance of VideoAnalyticsProvider to continue tracking.
}