Metrics

Questo documento definisce le metriche che puoi recuperare utilizzando l'API di YouTube Analytics. Questa API supporta 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 alle attività degli utenti includono, ad esempio, il numero di visualizzazioni e di valutazioni (Mi piace e Non mi piace).

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 alle norme. Nelle definizioni di questa pagina, qualsiasi metrica che è una metrica principale viene identificata esplicitamente come tale.

Il seguente elenco identifica le metriche principali dell'API.

Nota: le seguenti metriche di base sono state completamente ritirate:
  • La metrica principale earnings è stata ritirata il 4 agosto 2016 e ha rinominato estimatedRevenue. In conformità con le Norme sul ritiro definite nei Termini di servizio, le metriche earnings e estimatedRevenue sono state supportate contemporaneamente fino al 10 agosto 2017.
  • Le metriche principali di favoritesAdded e favoritesRemoved sono state ritirate il 31 marzo 2015. Queste metriche possono essere recuperate solo tramite l'API di YouTube Analytics.

Consulta l'elenco delle API di YouTube soggette alle norme sul ritiro per saperne di più.

Visualizza metriche

visualizzazioni (metrica principale)
Il numero di volte in cui un video è stato visualizzato. In un report relativo alle playlist, la metrica indica il numero di volte in cui un video è stato visualizzato nel contesto di una playlist. Il Centro assistenza YouTube offre ulteriori informazioni sulla modalità di registrazione delle visualizzazioni. This is a core metric and is subject to the Deprecation Policy.
redView
Il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Premium (precedentemente noti come YouTube Red).
uniques (ritirato il 27 settembre 2016)
Il numero di spettatori unici che hanno guardato un video. Questo calcolo si basa sul numero di cookie unici e, di conseguenza, verrà conteggiato in eccesso per gli utenti che utilizzano più dispositivi o browser.
La metrica uniques è stata ritirata il 27 settembre 2016. Non è una metrica fondamentale e verrà supportata fino al 31 ottobre 2016.
viewerPercentage (metrica principale)
La percentuale di spettatori che hanno eseguito l'accesso quando hanno guardato 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 video per il canale, il proprietario dei contenuti, il video o la playlist specificato. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Il numero di minuti in cui gli utenti abbonati a YouTube Premium (precedentemente noti 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 dei clip con loop. In un report relativo alle playlist, la metrica indica la durata media, in secondi, delle riproduzioni video che si sono verificate nel contesto di una playlist. This is a core metric and is subject to the Deprecation Policy.
AverageViewPercentage
La percentuale media di un video che è stato guardato durante la riproduzione. A partire dal 13 dicembre 2021, questa metrica esclude il traffico dei clip con 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 apprezzare un video dando un voto positivo. 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 apprezzare un video dando un voto negativo. This is a core metric and is subject to the Deprecation Policy.
condivisioni (metrica principale)
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.
iscrittoIscritti (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 ottenere o perdere iscritti in varie posizioni, tra cui la pagina di visualizzazione del video, la pagina del canale e la guida che viene visualizzata sulla home page di YouTube. Nei report del canale, questa metrica include gli iscritti provenienti da uno qualsiasi di questi luoghi. Tuttavia, nei report che utilizzano la dimensione video o il parametro filter per limitare la risposta in modo da includere solo i dati relativi a un video specifico, la metrica subscribersGained include solo le statistiche dalla pagina di visualizzazione del video specificato.
iscrittoPersi (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 vengono registrati in modo simile alla metrica subscribersGained. Nei report del canale, questa metrica include gli iscritti persi tramite qualsiasi meccanismo tramite il quale gli utenti possono annullare l'iscrizione a un canale. Tuttavia, nei report che utilizzano la dimensione video o il parametro filter per limitare la risposta in modo da includere solo i dati relativi a un video specifico, questa metrica include solo gli utenti che hanno annullato l'iscrizione alla pagina di visualizzazione del video specificato.
video aggiunti alle playlist
Il numero di volte in cui i video sono stati aggiunti a una playlist di YouTube. I video avrebbero potuto essere aggiunti alla playlist del proprietario del video o a quelle 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 un video viene aggiunto automaticamente, come la playlist dei caricamenti di un canale o la cronologia delle visualizzazioni di un utente.

Questa metrica restituisce un numero assoluto, il che significa che se un utente aggiunge un video a una playlist, lo rimuove e poi lo aggiunge nuovamente, il valore della metrica riflette il video aggiunto a una playlist due volte. I dati per questa metrica non sono disponibili per date anteriori al 1° ottobre 2014.
video rimossidai Playlist
Il numero di volte in cui i video sono stati rimossi da una playlist di YouTube. I video potrebbero essere stati rimossi dalla playlist del proprietario del video o da quelle 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, il che significa che se un utente aggiunge un video a una playlist, lo aggiunge nuovamente e poi lo rimuove di nuovo, il valore della metrica riflette il video rimosso due volte da una playlist. I dati per questa metrica non sono disponibili per date anteriori al 1° ottobre 2014.

Metriche sul coinvolgimento obsolete

Le seguenti metriche erano metriche principali che sono state ritirate il 31 marzo 2015.

preferitiAggiunti (metrica principale) (deprecato il 31 marzo 2015)
Il numero di volte in cui gli utenti hanno contrassegnato un video come preferito. Consulta il Centro assistenza YouTube per ulteriori informazioni. This is a core metric and is subject to the Deprecation Policy.
preferiti rimossi (metrica principale) (deprecato il 31 marzo 2015)
Il numero di volte in cui gli utenti hanno rimosso un video dai loro elenchi di 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

playlistStart
Il 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.
visualizzazioniPerPlaylist
Il numero medio di visualizzazioni di video che si sono verificate ogni volta che è stata avviata una playlist. Tieni presente che questa metrica include solo le visualizzazioni delle playlist che si sono verificate sul Web.
MediaTimeInPlaylist
La quantità di tempo media stimata, in minuti, in cui 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.

Metriche relative alle annotazioni

Nota: a partire dal 10 giugno 2012, i report dell'API di YouTube Analytics restituiscono solo i dati delle metriche annotationClickThroughRate e annotationCloseRate. Inoltre, a partire dal 16 luglio 2013, i report dell'API di YouTube Analytics restituiscono solo i dati delle metriche relative alle annotazioni rimanenti.

annotazione impressioni
Il numero totale di impressioni delle annotazioni.
annotazioni impressioni cliccabili
Il numero di annotazioni visualizzate e su cui è stato possibile fare clic.
click-annotazione
Il numero di annotazioni selezionate.
Percentuale di clic per annunci (metrica principale)
Il rapporto tra le annotazioni su cui gli spettatori hanno fatto clic e il numero totale di impressioni selezionabili. This is a core metric and is subject to the Deprecation Policy. Il Centro assistenza YouTube offre ulteriori informazioni sulla creazione di annotazioni e sull'utilizzo di annotazioni sui link.
annotazioneClosableImpressioni
Il numero di annotazioni visualizzate e che potrebbero essere chiuse.
annotazione
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 sul 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 della scheda per ogni scheda del video.
schedeClic
Il numero di clic sulle schede.
percentuale di clic delle schede
La percentuale di clic delle schede, che viene calcolata come il rapporto tra i clic della scheda e le impressioni della scheda.
cardTeaserImpressioni
Il numero di volte in cui sono stati mostrati i teaser delle schede. Una visualizzazione video può generare più impressioni del teaser.
cardTeaserClicks
Il numero di clic sui teaser delle schede. I clic sull'icona della scheda vengono attribuiti all'ultimo teaser visualizzato per l'utente.
Percentuale di clic per le schede
La percentuale di clic sui teaser delle schede, calcolata come rapporto tra i clic sui teaser delle schede e il numero totale di impressioni dei teaser delle schede.

Metriche sulla fidelizzazione del pubblico

rapporto di visualizzazione del pubblico
Il rapporto assoluto degli spettatori che lo guardano in un determinato momento. Il rapporto viene calcolato confrontando il numero di volte in cui un video è stato guardato con il numero totale di visualizzazioni. La dimensione elapsedVideoTimeRatio identifica la porzione del video a cui corrisponde la metrica.

Tieni presente che una parte del video potrebbe essere guardata più di una volta (o non guardarla affatto) in una determinata visualizzazione. Ad esempio, se gli utenti riavvolgono e guardano la stessa porzione di un video più volte, il rapporto assoluto per quella porzione del video potrebbe essere maggiore di 1.

Gli esempi seguenti illustrano come viene calcolato il valore:
  • Un video di un minuto viene guardato 100 volte. La metà degli spettatori smette di guardare dopo 15 secondi e il resto guarda l'intero video. Nessuno degli spettatori guarda parti del video più di una volta. In questo caso, il valore di questa metrica sarà 1 per i bucket di tempo nel primo trimestre del video e il valore sarà 0.50 per il resto del video.
  • Un video di un minuto viene guardato 100 volte. Tutti gli spettatori guardano l'intero video, ma 20 spettatori lo guardano fino al termine dei 45 secondi, quindi tornano ai 30 secondi e poi guardano il resto del video. In questo caso, il valore della metrica sarà 1 per i bucket temporali nella prima metà o nell'ultimo trimestre del video. Tuttavia, il valore sarebbe 1.2 per i bucket di tempo nel terzo trimestre del video, in quanto il 100% degli spettatori ha guardato quel segmento del video, ma il 20% di questi lo ha guardato due volte.
Rendimento relative alla fidelizzazione
Una misurazione che mostra l'efficacia con cui un video fidelizza gli spettatori durante la riproduzione rispetto a tutti i video di YouTube di durata simile. La metrica ha un valore compreso tra 0 e 1 che identifica il rendimento relativo di fidelizzazione del video in un determinato momento del video. Il punto nel video è fornito dalla dimensione elapsedVideoTimeRatio.

Il valore 0 indica che il video fidelizza gli spettatori peggio di qualsiasi altro video di durata simile, mentre il valore 1 indica che gli spettatori fidelizzano meglio gli altri video di qualsiasi durata simile. Un valore mediano di 0.5 indica che metà dei video di durata simile fidelizza meglio gli spettatori, mentre metà li fidelizza.

Il seguente esempio ipotetico illustra come potrebbero apparire i valori in un report. In media, il 90% degli spettatori che guardano video della durata di 10 minuti continua a guardare dopo tre minuti e il 70% dopo otto minuti. Tuttavia, per un video specifico di 10 minuti, solo l'80% degli spettatori continua a guardare dopo tre minuti, ma tutti gli spettatori continuano a guardare dopo otto minuti.
  • Al valore elapsedVideoTimeRatio che corrisponde al punto che si trova a tre minuti dall'inizio del video, la metrica relativeRetentionPerformance avrebbe un valore inferiore a 0.5 perché, in quel momento, il video aveva un rendimento inferiore alla media.
  • Con il valore elapsedVideoTimeRatio corrispondente al punto di otto minuti dopo il video, la metrica relativeRetentionPerformance avrebbe un valore superiore a 0.5 perché, in quel momento, il video aveva un rendimento migliore di altri video di durata simile.

Metriche sulle entrate stimate

Nota: le metriche relative alle entrate stimate sono soggette ad aggiustamenti di fine mese e non includono pubblicità venduta da partner e pubblicata da partner. Consulta il Centro assistenza YouTube per ulteriori informazioni e note sulle cifre relative alle entrate stimate.

Per impostazione predefinita, tutti i dati sulle entrate stimate sono espresse in dollari statunitensi. Tuttavia, l'API di YouTube Analytics supporta il parametro currency per alcune metriche sulle entrate stimate e sul rendimento degli annunci, consentendoti di recuperare i dati sulle entrate stimate in altre valute.
estimatedEntrate (metrica principale) (in precedenza earnings)
Le entrate nette stimate totali provenienti da tutte le origini pubblicitarie vendute da Google e da origini non pubblicitarie per l'intervallo di date e la regione 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 da partner e pubblicata da partner.
estimatedAdEntrate (in precedenza adEarnings)
Le entrate nette totali stimate 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 all'aggiustamento di fine mese e non includono pubblicità venduta da partner e pubblicata da partner.
estimatedRedPartnerEntrate (in precedenza redPartnerRevenue)
Le entrate stimate totali generate dagli abbonamenti a YouTube Premium (precedentemente noti come YouTube Red) per le dimensioni del report selezionate. Il valore della metrica riflette le entrate provenienti sia dai contenuti musicali che non musicali ed è soggetto a un aggiustamento di fine mese.

Metriche sul rendimento degli annunci

lordeEntrate
Le entrate lorde stimate, espresse in dollari, da tutta la pubblicità venduta da Google o da partner di 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 le entrate stimate, ovvero le entrate nette considerate nella tua quota di proprietà e nei contratti di compartecipazione alle entrate.
cpm (in precedenza impressionBasedCpm)
Le entrate lorde stimate per mille impressioni dell'annuncio.
adImpressioni (in precedenza impressions)
Il numero di impressioni dell'annuncio verificate pubblicate.
Riproduzione monetizzata
Il numero di volte in cui uno spettatore ha riprodotto il tuo video e gli è stata mostrata almeno un'impressione dell'annuncio. Viene conteggiata una riproduzione monetizzata se a uno spettatore viene mostrato un annuncio preroll, ma interrompe la visione dell'annuncio prima che inizi il video. L'errore stimato previsto per questa cifra è ±2,0%.
CPM basato sulla riproduzione
Le entrate lorde stimate per mille riproduzioni.