Questo documento definisce le metriche che puoi recuperare utilizzando l'API YouTube Analytics. Questa API supporta le query in tempo reale per generare report personalizzati di YouTube Analytics.
Le metriche sono misurazioni individuali dell'attività utente, del rendimento degli annunci o delle entrate stimate. Le metriche relative all'attività utente includono, ad esempio, il numero di visualizzazioni e i voti (Mi piace e Non mi piace) dei video.
Metriche principali
Sebbene l'API di YouTube Analytics sia soggetta alle norme sul ritiro definite nei Termini di servizio, le metriche non principali (e le dimensioni non principali) non sono soggette a queste norme. Nelle definizioni di questa pagina, qualsiasi metrica principale viene identificata esplicitamente come tale.
Il seguente elenco identifica le metriche principali dell'API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
- La metrica principale
earnings
è stata ritirata il 4 agosto 2016 e ha cambiato nome inestimatedRevenue
. In conformità alle norme sul ritiro definite nei Termini di servizio, le metricheearnings
eestimatedRevenue
sono state supportate contemporaneamente fino al 10 agosto 2017. - Le metriche principali
favoritesAdded
efavoritesRemoved
sono state ritirate il 31 marzo 2015. Queste metriche possono essere recuperate solo tramite l'API YouTube Analytics.
Per saperne di più, consulta l'elenco delle API di YouTube soggette alle Norme sul ritiro.
Visualizza metriche
- visualizzazioni (metrica principale)
- Questa metrica rappresenta numeri diversi nei vari tipi di report:
- Nei report relativi ai video, questa metrica indica il numero di volte in cui un video è stato visualizzato.
- Nei report sulle playlist che non utilizzano la dimensione
isCurated
, questa metrica indica il numero totale di visualizzazioni dei video nella playlist, indipendentemente dal fatto che tali visualizzazioni siano avvenute nel contesto della playlist. Tieni presente che il valore della metrica include solo le visualizzazioni dei video del proprietario del canale.
In questi report, la metricaplaylistViews
indica il numero di volte in cui i video della playlist sono stati visualizzati nel contesto di una playlist specifica. - Nei report sulle playlist che utilizzano la dimensione
isCurated
, questa metrica indica il numero di volte in cui i video sono stati visualizzati nel contesto di una playlist specifica. Tieni presente che la metricaplaylistViews
non è supportata per questi report.
- playlistViews
- Questa metrica viene definita nella sezione metriche delle playlist.
- redViews
- Il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Premium (precedentemente noto come YouTube Red).
- utenti unici (ritirata il 27 settembre 2016)
- Il numero di spettatori unici che hanno guardato un video. Questo calcolo si basa sul numero di cookie unici e, pertanto, verrà conteggiato un numero eccessivo di utenti che utilizzano più dispositivi o browser.
La metricauniques
è stata ritirata il 27 settembre 2016. Non è una metrica principale e sarà supportata fino al 31 ottobre 2016. - viewerPercentage (metrica principale)
- La percentuale di spettatori che hanno eseguito l'accesso per guardare il video o la playlist. This is a core metric and is subject to the Deprecation Policy.
Metriche relative al tempo di visualizzazione
- estimatedMinutesWatched (metrica principale)
- Il numero di minuti in cui gli utenti hanno guardato i video del canale, del proprietario dei contenuti, del video o della playlist specificati. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Il numero di minuti durante i quali gli abbonati a YouTube Premium (precedentemente noto come YouTube Red) hanno guardato un video.
- averageViewDuration (metrica principale)
- La durata media, in secondi, delle riproduzioni video. A partire dal 13 dicembre 2021, questa metrica esclude il traffico di clip in loop. In un report sulle playlist, la metrica indica la durata media, in secondi, delle riproduzioni video avvenute nel contesto di una playlist. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- La percentuale media di un video guardato durante la riproduzione di un video. A partire dal 13 dicembre 2021, questa metrica esclude il traffico di clip in loop.
Metriche sul coinvolgimento
- commenti (metrica principale)
- Il numero di volte in cui gli utenti hanno commentato un video. Consulta il Centro assistenza YouTube per ulteriori informazioni. This is a core metric and is subject to the Deprecation Policy.
- Mi piace (metrica principale)
- Il numero di volte in cui gli utenti hanno indicato di aver apprezzato un video assegnandogli una valutazione positiva. This is a core metric and is subject to the Deprecation Policy.
- Non mi piace (metrica principale)
- Il numero di volte in cui gli utenti hanno indicato di non aver messo Mi piace a un video assegnandogli una valutazione negativa. This is a core metric and is subject to the Deprecation Policy.
- Il numero di volte in cui gli utenti hanno condiviso un video tramite il pulsante
Share
. Consulta il Centro assistenza YouTube per ulteriori informazioni. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (metrica principale)
- Il numero di volte in cui gli utenti si sono iscritti a un canale. This is a core metric and is subject to the Deprecation Policy.
I canali possono acquisire o perdere iscritti in diversi punti, tra cui la pagina di visualizzazione del video, la pagina del canale e la guida che appare sulla home page di YouTube. Nei report sui canali, questa metrica include gli iscritti acquisiti da una di queste posizioni. Tuttavia, nei report che utilizzano la dimensionevideo
o il parametrofilter
per limitare la risposta in modo da includere solo i dati relativi a un determinato video, la metricasubscribersGained
includerà solo le statistiche provenienti dalla pagina di visualizzazione del video specificato. - subscribersLost (metrica principale)
- Il numero di volte in cui gli utenti hanno annullato l'iscrizione a un canale. This is a core metric and is subject to the Deprecation Policy.
I dati di questa metrica sono riportati in modo simile alla metricasubscribersGained
. Nei report sui canali, questa metrica include gli iscritti persi tramite qualsiasi meccanismo che consente agli utenti di annullare l'iscrizione a un canale. Tuttavia, nei report che utilizzano la dimensionevideo
o il parametrofilter
per limitare la risposta in modo da includere solo i dati relativi a un determinato video, questa metrica include solo gli utenti che hanno annullato l'iscrizione alla pagina di visualizzazione del video specificato. - videosAddedToPlaylists
- Il numero di volte in cui i video sono stati aggiunti a qualsiasi playlist di YouTube. I video potrebbero essere stati aggiunti alla playlist del proprietario del video o alle playlist di altri canali.
Il valore della metrica include il numero di volte in cui i video sono stati aggiunti alle playlist predefinite come la playlist "Guarda più tardi". Tuttavia, non conteggia le playlist a cui viene aggiunto automaticamente un video, come la playlist dei caricamenti su un canale o la cronologia delle visualizzazioni di un utente.
Questa metrica restituisce un numero assoluto, ovvero se un utente aggiunge un video a una playlist, lo rimuove e poi lo aggiunge di nuovo, il valore della metrica riflette il video che viene aggiunto due volte a una playlist. I dati di questa metrica non sono disponibili per le date precedenti al 1° ottobre 2014. - videosRemovedFromPlaylists
- Il numero di volte in cui i video sono stati rimossi da qualsiasi playlist di YouTube. I video potrebbero essere stati rimossi dalla playlist del proprietario del video o dalle playlist di altri canali.
Il valore della metrica include il numero di volte in cui i video sono stati rimossi dalle playlist predefinite come la playlist "Guarda più tardi".
Questa metrica restituisce un numero assoluto, ovvero se un utente aggiunge un video a una playlist, lo rimuove, lo aggiunge di nuovo e poi lo rimuove di nuovo, il valore della metrica indica due volte il video rimosso da una playlist. I dati di questa metrica non sono disponibili per le date precedenti al 1° ottobre 2014.
Metriche sul coinvolgimento obsolete
Le seguenti metriche erano entrambe metriche principali che sono state ritirate il 31 marzo 2015.
- favoritesAdded (metrica principale) (ritirata il 31 marzo 2015)
- Il numero di volte in cui un video è stato contrassegnato come preferito dagli utenti. Consulta il Centro assistenza YouTube per ulteriori informazioni. This is a core metric and is subject to the Deprecation Policy.
- favoritesRemoved (metrica principale) (ritirata il 31 marzo 2015)
- Il numero di volte in cui gli utenti hanno rimosso un video dai propri elenchi dei video preferiti. Consulta il Centro assistenza YouTube per ulteriori informazioni. This is a core metric and is subject to the Deprecation Policy.
Metriche delle playlist
I report sulle playlist contengono due tipi di metriche che spiegano il modo in cui gli spettatori interagiscono con i video in una playlist:
-
Le metriche video aggregate forniscono metriche relative all'attività utente e alle impressioni aggregate per tutti i video della playlist che sono anche di proprietà del canale proprietario della playlist. Le metriche per i video di proprietà di altri canali non vengono calcolate nell'aggregazione. Di conseguenza, se un canale crea una playlist che contiene solo video di proprietà di altri canali, i report per queste playlist non forniranno valori per queste metriche.
Consulta le sezioni sulle metriche relative alle viste e sulle metriche del tempo di visualizzazione di questo documento per le definizioni delle metriche video aggregate supportate.
-
Le metriche in-playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono le visualizzazioni di tutti i video contenuti nella playlist, indipendentemente dal canale di sua proprietà, ma conteggiano solo le visualizzazioni che si sono verificate nel contesto della playlist.
La maggior parte delle metriche elencate di seguito riguarda metriche in-playlist; le altre metriche nell'elenco, ad esempio
la metrica playlistSaves
, riguardano le interazioni degli utenti con la playlist stessa e non
con i video contenuti nella playlist. Pertanto, queste metriche non si presenterebbero come metriche video aggregate o metriche in-playlist.
- averageTimeInPlaylist
- La quantità di tempo media stimata, in minuti, durante la quale uno spettatore ha visualizzato i video di una playlist dopo l'avvio della playlist. Tieni presente che questa metrica include solo le visualizzazioni delle playlist che
si sono verificate sul web.
- playlistAverageViewDuration
- La durata media stimata, in secondi, di visualizzazione per ogni visualizzazione della playlist. Tieni presente che questa metrica rappresenta la durata media delle visualizzazioni dei singoli video all'interno di una playlist; la metrica
averageTimeInPlaylist
, invece, rappresenta il tempo medio trascorso da ogni spettatore a guardare la playlist nel suo complesso. Questa metrica include i dati relativi ai video delle playlist di proprietà di altri canali. - playlistEstimatedMinutesWatched
- Il numero di minuti durante i quali gli utenti hanno guardato i contenuti della playlist all'interno della playlist. Non viene conteggiato il tempo di visualizzazione registrato in altri contesti, ad esempio quello delle visualizzazioni che si sono verificate durante la visione dello stesso video di altre playlist da parte degli spettatori. Questa metrica include i dati relativi ai video delle playlist di proprietà di altri canali.
- playlistSaves
- Il numero netto di volte in cui gli utenti hanno salvato una playlist. Per ulteriori informazioni sulle playlist salvate, consulta il Centro assistenza YouTube. Questa metrica restituisce un numero di variazioni nette, ovvero se un utente salva una playlist, la rimuove dall'elenco delle playlist salvate e la salva di nuovo, il valore della metrica riflette l'aggiunta di una playlist salvata.
- playlistStarts
- Numero di volte in cui gli spettatori hanno avviato la riproduzione di una playlist. Tieni presente che questa metrica include solo le visualizzazioni delle playlist che si sono verificate sul web.
- playlistViews
- Il numero di volte in cui i video della playlist sono stati visualizzati nel contesto della playlist in questione.
Questa metrica include i dati relativi ai video delle playlist di proprietà di altri canali.
- viewsPerPlaylistStart
- Il numero medio di visualizzazioni di video registrate ogni volta che è stata avviata una playlist. Tieni presente che questa metrica include solo le visualizzazioni delle playlist che si sono verificate sul web.
Metriche relative alle annotazioni
Nota: i report dell'API di YouTube Analytics restituiscono solo i dati relativi alle metriche annotationClickThroughRate
e annotationCloseRate
a partire dal 10 giugno 2012. Inoltre, i report dell'API di YouTube Analytics restituiscono solo i dati relativi alle restanti metriche relative alle annotazioni a partire dal 16 luglio 2013.
- annotationImpressions
- Il numero totale di impressioni delle annotazioni.
- annotationClickableImpressions
- Il numero di annotazioni visualizzate e su cui è possibile fare clic.
- annotationClicks
- Il numero di annotazioni che hanno ricevuto clic.
- annotationClickThroughRate (metrica principale)
- Il rapporto tra le annotazioni su cui gli spettatori hanno fatto clic e il numero totale di impressioni delle annotazioni cliccabili. This is a core metric and is subject to the Deprecation Policy. Nel Centro assistenza YouTube puoi trovare ulteriori informazioni sulla creazione delle annotazioni e sull'utilizzo delle annotazioni dei link.
- annotationClosableImpressions
- Il numero di annotazioni che sono apparse e potrebbero essere chiuse.
- annotationCloses
- Il numero di annotazioni chiuse.
- annotationCloseRate (metrica principale)
- Il rapporto tra le annotazioni chiuse dagli spettatori e il numero totale di impressioni delle annotazioni. This is a core metric and is subject to the Deprecation Policy.
Metriche della scheda
Il Centro assistenza YouTube contiene istruzioni più dettagliate su come aggiungere schede ai video e il report sulle schede di YouTube Analytics.
- cardImpressions
- Il numero di volte in cui le schede sono state visualizzate. Quando il riquadro della scheda viene aperto, viene registrata un'impressione per ciascuna scheda del video.
- cardClicks
- Il numero di volte in cui le schede hanno ricevuto un clic.
- cardClickRate
- La percentuale di clic delle schede, calcolata come il rapporto tra i clic e le impressioni della scheda.
- Il numero di volte in cui i teaser delle schede sono stati visualizzati. Una visualizzazione video può generare più impressioni teaser.
- Il numero di clic sui teaser delle schede. I clic sull'icona della scheda vengono attribuiti all'ultimo teaser mostrato all'utente.
- La percentuale di clic sui teaser delle schede, calcolata come rapporto tra i clic sui teaser della scheda e il numero totale di impressioni dei teaser delle schede.
Metriche sulla fidelizzazione del pubblico
- audienceWatchRatio
- Il rapporto assoluto tra gli spettatori che guardano il video nel punto specifico del video. Il rapporto viene calcolato confrontando il numero di volte in cui una parte di un video è stata guardata con il numero totale di visualizzazioni del video. La dimensione
elapsedVideoTimeRatio
identifica la parte del video a cui corrisponde la metrica.
Tieni presente che una parte di un video potrebbe essere guardata più di una volta (o non guardarla affatto) in una determinata visualizzazione video. Ad esempio, se gli utenti riavvolgono e guardano più volte la stessa parte di un video, il rapporto assoluto per quella parte del video potrebbe essere maggiore di1
.
I seguenti esempi illustrano come viene calcolato il valore:- Un video di un minuto viene guardato 100 volte. La metà degli spettatori smette di guardare il video dopo 15 secondi e gli altri guardano l'intero video. Nessuno degli spettatori guarda una qualsiasi parte del video più di una volta. In questo caso, il valore di questa metrica sarà
1
per i bucket di tempo nel primo quarto del video e0.50
per la parte restante del video. - Un video di un minuto viene guardato 100 volte. Tutti gli spettatori guardano l'intero video, ma 20 spettatori lo guardano fino all'inizio dei 45 secondi di riproduzione, quindi tornano all'ora dei 30 secondi del video e guardano la parte restante del video. In questo caso, il valore della metrica sarà
1
per i bucket di tempo nella prima metà o nell'ultimo quarto del video. Tuttavia, il valore sarebbe1.2
per gli intervalli di tempo nel terzo trimestre del video, poiché il 100% degli spettatori ha guardato quel segmento del video, ma il 20% ha guardato il segmento due volte.
- Un video di un minuto viene guardato 100 volte. La metà degli spettatori smette di guardare il video dopo 15 secondi e gli altri guardano l'intero video. Nessuno degli spettatori guarda una qualsiasi parte del video più di una volta. In questo caso, il valore di questa metrica sarà
- relativeRetentionPerformance
- Una misurazione che mostra l'efficacia con cui un video fidelizza gli spettatori durante le riproduzioni rispetto a tutti i video di YouTube di durata simile. La metrica ha un valore compreso tra
0
e1
che identifica il rendimento della fidelizzazione relativa del video in un determinato punto del video. Il punto del video è fornito dalla dimensioneelapsedVideoTimeRatio
.
Il valore0
indica che il video fidelizza gli spettatori meno di qualsiasi altro video di durata simile, mentre il valore1
indica che il video fidelizza gli spettatori meglio di qualsiasi altro video di durata simile. Un valore mediano pari a0.5
indica che metà dei video di durata simile fidelizzano meglio gli spettatori, mentre la metà mantiene gli spettatori ancora peggio.
Il seguente esempio ipotetico illustra come potrebbero apparire i valori in un report. In media, il 90% degli spettatori che guardano video di 10 minuti continua a guardare dopo tre minuti, mentre il 70% lo guarda ancora dopo otto minuti. Tuttavia, per uno specifico video di 10 minuti, solo l'80% degli spettatori continua a guardare dopo tre minuti, ma tutti gli spettatori lo guardano ancora dopo otto minuti.- Al valore
elapsedVideoTimeRatio
corrispondente al punto che appare a tre minuti dall'inizio del video, la metricarelativeRetentionPerformance
avrà un valore inferiore a0.5
poiché, in quel momento, il rendimento del video è inferiore alla media del video. - Al valore
elapsedVideoTimeRatio
corrispondente al punto che appare agli otto minuti di inizio del video, la metricarelativeRetentionPerformance
avrà un valore maggiore di0.5
poiché in quel momento il video ha un rendimento migliore di altri video di durata simile.
- Al valore
Metriche sulle entrate stimate
Nota:le metriche relative alle entrate stimate sono soggette ad aggiustamenti di fine mese e non includono pubblicità venduta e offerta dai partner. Consulta il Centro assistenza YouTube per ulteriori informazioni e note sui dati stimati relativi alle entrate.
currency
per alcune metriche relative alle entrate stimate e al rendimento degli annunci, consentendoti di recuperare i dati sulle entrate stimate in altre valute.- estimatedRevenue (metrica principale) (in precedenza
earnings
) - Le entrate nette totali stimate da tutte le origini di pubblicità venduta da Google e da origini non pubblicitarie per la regione e l'intervallo di date selezionati.
This is a core metric and is subject to the Deprecation Policy.
Le metriche relative alle entrate stimate sono soggette ad aggiustamento di fine mese e non includono pubblicità venduta e pubblicata dai partner.
- estimatedAdRevenue (in precedenza
adEarnings
) - Le entrate nette stimate totali da tutte le origini di pubblicità venduta da Google per la regione e l'intervallo di date selezionati.
Le metriche relative alle entrate stimate sono soggette a un aggiustamento di fine mese e non includono pubblicità venduta da partner e offerta dai partner. - estimatedRedPartnerRevenue (in precedenza
redPartnerRevenue
) - Le entrate stimate totali generate dagli abbonamenti a YouTube Premium (precedentemente noto come YouTube Red) per le dimensioni del rapporto selezionate. Il valore della metrica riflette le entrate derivanti dai contenuti musicali e non musicali ed è soggetto a un aggiustamento di fine mese.
Metriche sul rendimento degli annunci
- grossRevenue
- Le entrate lorde stimate, in dollari statunitensi, da tutta la pubblicità venduta da Google o dai partner DoubleClick per la regione e l'intervallo di date selezionati. Queste entrate lorde sono soggette a un aggiustamento di fine mese e non includono pubblicità offerta da partner. Le entrate lorde non devono essere confuse con l'andamento delle entrate stimate o delle entrate nette, che sono considerate nei contratti di condivisione delle entrate e quota di proprietà.
- cpm (precedentemente denominato
impressionBasedCpm
) - Le entrate lorde stimate per mille impressioni dell'annuncio.
- adImpressions (in precedenza
impressions
) - Il numero di impressioni dell'annuncio verificate pubblicate.
- monetizedPlaybacks
- Il numero di casi in cui uno spettatore ha riprodotto il tuo video e gli è stata mostrata almeno un'impressione dell'annuncio. Viene conteggiata una riproduzione monetizzata se uno spettatore visualizza un annuncio pre-roll, ma smette di guardare l'annuncio prima che il video inizi. L'errore stimato previsto per questo valore è ±2,0%.
- playbackBasedCpm
- Le entrate lorde stimate per mille riproduzioni.