DocumentazioneAnalyticsGuida di Media Analytics

Parametri per lo stato del lettore player-state-parameters

Last update: Tue Jun 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User
  • Admin
  • Developer

Questo argomento presenta un elenco di dati di stato del lettore raccolti da Adobe tramite le variabili di soluzione.

Descrizione dei dati della tabella:

  • Implementazione: informazioni sui valori e i requisiti di implementazione

    • Chiave: variabile, impostata manualmente nell’app o automaticamente dall’SDK di Adobe Media.
    • Obbligatorio: indica se il parametro è necessario per il tracciamento video di base.
    • Tipo: specifica il tipo di variabile da impostare, stringa o numero.
    • Inviato con: indica quando i dati vengono inviati. Avvia file multimediale è la chiamata di Analytics inviata all’avvio del file multimediale. Avvia annuncio è la chiamata di Analytics inviata all’avvio dell’annuncio e così via. Le chiamate di Chiusura sono le chiamate compilate di Analytics inviate direttamente dal server heartbeat a quello di Analytics al termine della sessione multimediale, oppure dell’annuncio, del capitolo, ecc. Le chiamate di chiusura non sono disponibili nelle chiamate dei pacchetti di rete.
    • Versione SDK min.: indica la versione SDK necessaria per accedere al parametro.
    • Valore di esempio: fornisce un esempio di utilizzo comune delle variabili.

  • Parametri di rete: mostra i valori trasferiti ai server di Adobe Analytics o Heartbeat. Questa colonna mostra i nomi dei parametri visualizzati nelle chiamate di rete generate dagli SDK di Adobe Media.

  • Reporting: informazioni su come visualizzare e analizzare i dati video.

    • Disponibile: indica se i dati sono disponibili nel reporting per impostazione predefinita (Sì) o richiede la configurazione personalizzata (Personalizzato)
    • Variabile riservata: indica se i dati vengono acquisiti come evento, eVar, prop o classificazione in una variabile riservata.
    • Nome del rapporto: nome del report Adobe Analytics per la variabile
    • Dati contestuali: nome dei dati contestuali di Adobe Analytics trasferiti al server di reporting e utilizzati nelle regole di elaborazione.
    • Feed di dati: nome della colonna per la variabile trovata nei feed di dati Clickstream o Live Stream
    • Audience Manager: nome degli elementi presenti in Adobe Audience Manager
IMPORTANT
Non modificare i nomi delle classificazioni per le variabili elencate di seguito e descritte nella variabile Reporting/Reserved (Reporting/Riservato) come “classificazione”.
Le classificazioni per i file multimediali vengono definite quando una suite di rapporti è abilitata per il tracciamento dei contenuti multimediali. Periodicamente Adobe aggiunge nuove proprietà e in questo caso i clienti devono riabilitare le suite di rapporti per accedere alle nuove proprietà multimediali. Durante il processo di aggiornamento, l’Adobe determina se le classificazioni sono abilitate controllando i nomi delle variabili. Se manca qualcuno di questi, Adobe aggiunge di nuovo quelli mancanti.

Proprietà stato del lettore player-state-properties

Le funzionalità di tracciamento dello stato del lettore possono essere collegate a un flusso audio o video. Le metriche standard di tracciamento dello stato del lettore sono memorizzate come variabili di soluzione. Gli stati standard sono: fullScreen, mute, closeCaption, pictureInPicture e inFocus.

Proprietà schermo intero

Flussi interessati dallo schermo intero

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Il numero di flussi interessati dallo schermo intero. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato a schermo intero.
    Importante
    Se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.States.fullscreen.set
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome rapporto
    Flussi interessati dallo schermo intero
  • Dati contestuali:
    a.media.States.fullscreen.set
  • Feed di dati
    videostatefullscreen
  • Audience Manager:
    c_contextdata.a.media.States.fullscreen.set
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateSet
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.isSet

Conteggi schermo intero

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di volte in cui è stato visualizzato uno schermo intero. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato a schermo intero.
    Importante
    Se questo evento è impostato, il conteggio è uguale al numero di volte in cui il video era nello stato a schermo intero. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.fullscreen.count
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Conteggio a schermo intero
  • Dati contestuali:
    a.media.states.fullscreen.count
  • Feed di dati
    videostatefullscreencount
  • Audience Manager:
    c_contextdata.media.states.fullscreen.count
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateCount
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.count

Durata totale schermo intero

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Tempo di visualizzazione a schermo intero. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato a schermo intero.
    Importante
    Se questo evento è impostato, il valore è pari alla durata di tempo in cui il video era nello stato Schermo intero. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.fullscreen.time
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Durata totale schermo intero
  • Dati contestuali:
    a.media.states.fullscreen.time
  • Feed di dati
    videostatefullscreentime
  • Audience Manager:
    c_contextdata.media.states.fullscreen.time
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateTime
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.time

Proprietà sottotitoli

Flussi interessati dai sottotitoli

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di flussi interessati dalla funzione Sottotitoli. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di sottotitoli codificati.
    Importante
    Se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.closedcaptioning.set
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Flussi interessati dalla funzione Sottotitoli
  • Dati contestuali:
    a.media.states.closedcaptioning.set
  • Feed di dati
    videostateclosedcaptioning
  • Audience Manager:
    c_contextdata.a.media.states.
    closedcaptioning.set
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateSet
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.isSet

Conteggi per sottotitoli

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di volte in cui sono stati visualizzati i sottotitoli. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di Sottotitoli.
    Importante
    Se questo evento è impostato, il conteggio è pari al numero di volte in cui il video era nello stato Sottotitoli. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.closedcaptioning.count
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Conteggio sottotitoli
  • Dati contestuali:
    a.media.states.closedcaptioning.count
  • Feed di dati
    videostateclosedcaptioncount
  • Audience Manager:
    c_contextdata.media.states.
    closedcaptioning.count
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateCount
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.count

Durata totale sottotitoli

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Tempo di visualizzazione dei sottotitoli. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato Schermo intero.
    Importante
    Se questo evento è impostato, il valore è pari alla durata di tempo in cui il video era nello stato Sottotitoli. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.closedcaptioning.time
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Durata totale sottotitoli
  • Dati contestuali:
    a.media.states.closedcaptioning.time
  • Feed di dati
    videostateclosedcaptiontime
  • Audience Manager:
    c_contextdata.media.states.
    closedcaptioning.time
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateTime
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.time

Proprietà disattivazione audio

Flussi interessati dalla disattivazione audio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di flussi interessati dalla disattivazione audio. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di disattivazione audio.
    Importante
    Se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.mute.set
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Flussi interessati dalla disattivazione audio
  • Dati contestuali:
    a.media.states.mute.set
  • Feed di dati
    videostatemute
  • Audience Manager:
    c_contextdata.a.media.states.mute.set
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateSet
  • < Percorso campo XDM per reporting:
    mediaReporting.playerStateData.isSet

Conteggi disattivazione audio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Il numero di volte in cui è stato visualizzato l’audio disattivato. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di disattivazione audio.
    Importante
    Se questo evento è impostato, il conteggio è uguale al numero di volte in cui il video era in stato di disattivazione audio. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.mute.count
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Conteggio disattivazione audio
  • Dati contestuali:
    a.media.states.mute.count
  • Feed di dati
    videostatemutecount
  • Audience Manager:
    c_contextdata.media.states.mute.count
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.mute.playerStateCount
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.count

Durata totale disattivazione audio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Periodo di tempo in cui è stata visualizzata la disattivazione audio. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di disattivazione audio.
    Importante
    Se questo evento è impostato, il periodo di tempo corrisponde al periodo in cui il video era in stato di disattivazione audio. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.States.mute.time
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome rapporto
    Durata totale disattivazione audio
  • Dati contestuali:
    a.media.States.mute.time
  • Feed di dati
    videostatemutetime
  • Audience Manager:
    c_contextdata.media.States.mute.time
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateTime
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.time

Proprietà immagine nell’immagine

Flussi interessati da Picture in Picture (immagine nell’immagine)

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di flussi interessati da immagine nell’immagine (Picture in Picture). Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato immagine nell’immagine.
    Importante
    Se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.States.pictureinpicture.set
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome rapporto
    Flussi interessati da immagine nell’immagine (Picture in Picture)
  • Dati contestuali:
    a.media.States.pictureinpicture.set
  • Feed di dati
    videostatepictureinpicture
  • Audience Manager:
    c_contextdata.a.media.states.
    pictureinpicture.set
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateSet
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.isSet

Conteggio immagini nell’immagine (Picture in Picture)

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di volte in cui è stata visualizzata l’immagine nell’immagine (Picture in Picture). Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di immagine nell’immagine (Picture in Picture).
    Importante
    Se questo evento è impostato, il conteggio è uguale al numero di volte in cui il video era nello stato di immagine nell’immagine (Picture in Picture). Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.States.pictureinpicture.count
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Conteggio immagini nell’immagine (Picture in Picture)
  • Dati contestuali:
    a.media.States.pictureinpicture.count
  • Feed di dati
    videostatepictureinpicturecount
  • Audience Manager:
    c_contextdata.media.states.
    pictureinpicture.count
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateCount
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.count

Durata totale immagine nell’immagine (Picture in Picture)

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Periodo di tempo in cui è stata visualizzata l’immagine nell’immagine (Picture in Picture). Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato di immagine nell’immagine (Picture in Picture).
    Importante
    Se questo evento è impostato, il periodo di tempo corrisponde al periodo in cui il video era in stato di immagine nell’immagine (Picture in Picture). Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.States.pictureinpicture.time
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    Durata totale immagine nell’immagine (Picture in Picture)
  • Dati contestuali:
    a.media.States.pictureinpicture.time
  • Feed di dati
    videostatepictureinpitretime
  • Audience Manager:
    c_contextdata.media.states.
    pictureinpicture.time
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateTime
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.time

Proprietà messa a fuoco (In Focus)

Flussi interessati da In Focus

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di flussi interessati da In Focus. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato In Focus.
    Importante
    Se questo evento è impostato, l’unico valore possibile è TRUE. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.infocus.set
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome rapporto
    Flussi interessati da In Focus
  • Dati contestuali:
    a.media.states.infocus.set
  • Feed di dati
    videostateinfocus
  • Audience Manager:
    c_contextdata.a.media.states.infocus.set
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateSet
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.isSet

Conteggi In Focus

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Numero di volte in cui è stato visualizzato In Focus. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno stato In Focus.
    Importante
    Se questo evento è impostato, il conteggio è pari al numero di volte in cui il video era nello stato In focus. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.infocus.count
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome rapporto
    Conteggio In Focus
  • Dati contestuali:
    a.media.states.infocus.count
  • Feed di dati
    videostateinfocuscount
  • Audience Manager:
    c_contextdata.media.states.infocus.count
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateCount
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.count

Durata totale In Focus

Implementazione
Parametri di rete
Reporting
  • Chiave SDK
    Impostata automaticamente
  • Chiave API
    N/D
  • Obbligatorio
    No
  • Tipo
    numero
  • Inviato con
    Chiusura file multimediali
  • Versione SDK min.
    3.0
  • Valore di esempio
    TRUE
  • Descrizione
    Veniva visualizzato il periodo di tempo In focus. Questa metrica è impostata su 1 solo se durante una sessione di riproduzione si è verificato almeno uno Stato in focus.
    Importante
    Se questo evento è impostato, l’ora corrisponde a quanto tempo il video è rimasto nello stato In focus. Se questo evento non è impostato, non viene inviato alcun valore.
  • Adobe Analytics:
    a.media.states.infocus.time
  • Heartbeat
    N/D
  • Disponibile
    Sì
  • Variabile riservata
    evento
  • Nome del rapporto
    durata totale In focus
  • Dati contestuali:
    a.media.states.infocus.time
  • Feed di dati
    videostateinfocustime
  • Audience Manager:
    c_contextdata.media.states.infocus.time
  • Percorso campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateTime
  • Percorso campo XDM per reporting:
    mediaReporting.playerStateData.time

API correlate related_apis_section

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb