Show Menu
ARGOMENTI×

Analisi del video

Queste informazioni spiegano come misurare i video su Android con la soluzione di misurazione video.
Durante la riproduzione di un video, vengono inviate al servizio frequenti chiamate "heartbeat" che consentono di misurare il tempo di riproduzione. Tali chiamate heartbeat sono inviate ogni 10 secondi e consentono di ottenere metriche di coinvolgimento dettagliate e rapporti più precisi sull'abbandono. Per ulteriori informazioni sulla soluzione di misurazione video di Adobe, consulta Misurazione di audio e video in Adobe Analytics .
Il processo generale da seguire per la misurazione dei video è molto simile per tutte le piattaforme. Di seguito viene fornita una panoramica di base delle attività di sviluppo, con esempi di codice. Nella tabella seguente sono elencati i dati multimediali inviati ad Analytics. Le regole di elaborazione vengono utilizzate per mappare i dati contestuali in una variabile Analytics.

Mappare gli eventi del lettore sulle variabili di Analytics

  • a.media.name
    • Tipo di variabile: eVar
      • Scadenza predefinita: visita
      • Insight personalizzato (s.prop, usato per il percorso del video)
    • ( Obbligatorio ) Quando un visitatore visualizza il video in qualche modo, questa variabile dati di contesto raccoglie il nome del video, in base a quanto specificato nell'implementazione. Per questa variabile puoi aggiungere delle classificazioni.
    • ( Facoltativo ) La variabile Insight personalizzato fornisce informazioni sul percorso del video.
  • a.media.name
    • Tipo evento: Custom Insight (s.prop)
    • ( Facoltativo ) Fornisce informazioni sul percorso del video.
      Il percorso deve essere abilitato per questa variabile da ExpCare.
    • Tipo evento: Insight personalizzato (s.prop)
  • a.media.segment
    • Tipo di variabile: eVar
    • Scadenza predefinita: visualizzazioni pagina
    • ( Obbligatorio ) Raccoglie dati sui segmenti video, tra cui il nome del segmento e l'ordine in cui il segmento appare nel video.
      Puoi popolare questa variabile abilitando la variabile segmentByMilestones quando monitori automaticamente gli eventi del lettore oppure impostando un nome del segmento personalizzato quando monitori manualmente gli eventi del lettore. Ad esempio, quando un visitatore visualizza il primo segmento di un video, SiteCatalyst potrebbe raccogliere quanto segue nella eVar dei segmenti: 1:M:0-25 .
      Il metodo predefinito di raccolta dei dati video raccoglie i dati presso i seguenti punti:
      • inizio video (play)
      • inizio del segmento
      • fine del video (stop) Analytics conta la visualizzazione del primo segmento all'inizio del segmento, quando il visitatore inizia la visualizzazione. Il segmento successivo viene visualizzato quando inizia il segmento.
  • a.contentType
    • Tipo di variabile: eVar
    • Scadenza predefinita: visualizzazioni pagina
    • Raccoglie dati relativi al tipo di contenuto visualizzato da un visitatore.
      Agli hit inviati dalla misurazione è assegnato il tipo di contenuto video video. Dal punto di vista della misurazione video, il tipo di contenuto ti consente di identificare i visitatori del video e di calcolare i tassi di conversione relativi al video.
  • a.media.timePlayed
    • Tipo di variabile: Event
    • Tipo: contatore
    • Conta il tempo, in secondi, trascorso guardando un video a partire dall'ultimo processo di raccolta dati (richiesta immagine).
  • a.media.view
    • Tipo di variabile: Event
    • Tipo: contatore
    • Indica che un visitatore ha visualizzato una parte di un video.
      Tuttavia, non fornisce informazioni sulla durata della visualizzazione o sulla parte di video visualizzata dal visitatore.
  • a.media.segmentView
    • Tipo di variabile: Event
    • Tipo: contatore
    • Indica che un visitatore ha visualizzato una parte di un segmento video.
      Tuttavia, non fornisce informazioni sulla durata della visualizzazione o sulla parte di video visualizzata dal visitatore.
  • a .media.complete
    • Tipo di variabile: Event
    • Tipo: contatore
    • Indica che un utente ha visualizzato un video completo.
      Per impostazione predefinita, l'evento completo è misurato 1 secondo prima della fine del video. Durante l'implementazione, puoi specificare quanti secondi prima della fine del video consideri la visualizzazione come completa. Per i video live e altri flussi che non hanno una fine definita, puoi specificare un punto personalizzato per misurare le visualizzazioni complete (ad esempio, dopo che il video è stato visualizzato per una data quantità di tempo).

Configurare le impostazioni per i file multimediali

Configura un oggetto MediaSettings con le impostazioni che desideri utilizzare per tracciare il video:
MediaSettings mySettings = Media.settingsWith("name", 10, "playerName", "playerId");

Tracciare gli eventi del lettore

Per misurare la riproduzione di un video, è necessario invocare i metodi mediaPlay , mediaStop e mediaClose nei momenti opportuni. Ad esempio, chiama mediaStop quando il lettore viene messo in pausa e mediaPlay quando la riproduzione viene avviata o ripresa.

Classi

Classe: MediaSettings
public String name; 
public String playerName; 
public String playerID; 
public double length; 
public String channel; 
public String milestones; 
public String offsetMilestones; 
public boolean segmentByMilestones; 
public boolean segmentByOffsetMilestones; 
public int trackSeconds = 0; 
public int completeCloseOffsetThreshold = 1; 
 
// MediaAnalytics Ad settings 
public String parentName; 
public String parentPod; 
public String CPM; 
public double parentPodPosition; 
public boolean isMediaAd;

Classe: MediaState
public Date openTime = new Date(); 
public String name; 
public String segment; 
public String playerName; 
public String mediaEvent; 
public int offsetMilestone; 
public int segmentNum; 
public int milestone; 
public double length; 
public double offset; 
public double percent; 
public double timePlayed; 
public double segmentLength; 
public boolean complete = false; 
public boolean clicked = false; 
public boolean ad; 
public boolean eventFirstTime;

Guida di riferimento delle classi e dei metodi per la misurazione di file multimediali

Di seguito sono riportati i metodi della classe Misurazione di file multimediali:
  • settingsWith
    Restituisce un oggetto MediaSettings con i parametri specificati.
    • Di seguito è riportata la sintassi per questo metodo:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      MediaSettingsmySettings = Media.settingsWith("name", 10, "playerName", "playerId");
      
      
  • adSettingsWith
    Restituisce un oggetto MediaSettings per l'uso con il tracciamento di un video annuncio.
    • Di seguito è riportata la sintassi per questo metodo:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
  • open
    Apre un oggetto MediaSettings per il tracciamento.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void open(MediaSettings settings, MediaCallback callback); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.open(mySettings, new Media.MediaCallback() { 
        @Override 
        public void call(Object item)
        {//  monitor  callback  if  you  want  to  be  notified  every  second  the  media  is  playing  }
        }); 
      
      
    • close
      Chiude l'elemento multimediale denominato name .
      • Di seguito è riportata la sintassi per questo metodo:
      public static void close(String name);
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.close("name"); 
      
      
  • play
    • Riproduce l'elemento multimediale denominato name in corrispondenza dell' offset indicato in secondi.
    • Di seguito è riportata la sintassi per questo metodo:
      publicstatic void play(String name, double offset); 
      
      
  • completato
    Contrassegna manualmente l'elemento multimediale come completato in corrispondenza dell' offset indicato in secondi.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void complete(String name, double offset); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.complete("name", 0); 
      
      
  • stop
    Notifica al modulo multimediale che il video è stato interrotto o messo in pausa in corrispondenza dell' offset indicato.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void stop(String name, double offset); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.stop("name", 0);
      
      
  • click
    Notifica al modulo multimediale l'avvenuto clic sull'elemento multimediale.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void click(String name double offset); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.click("name", 0);
      
      
  • track
    Invia una chiamata Track Action (senza visualizzazioni pagina) per lo stato corrente dell'elemento multimediale.
    • Di seguito è riportata la sintassi per questo metodo:
      publicstatic void track(String name, Map<String, Object> data); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Media.track("name", null);