Questo documento definisce le metriche che puoi recuperare utilizzando l'API YouTube Analytics. Questa API supporta query in tempo reale per generare report personalizzati di YouTube Analytics.
Le metriche sono singole misurazioni dell'attività utente, del rendimento dell'annuncio o delle entrate stimate. Le metriche relative all'attività utente includono, ad esempio, il numero di visualizzazioni di video e le valutazioni (Mi piace e Non mi piace).
Metriche principali
Mentre l'API YouTube Analytics è 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, ogni metrica principale è identificata esplicitamente come tale.
L'elenco seguente identifica le metriche principali dell'API.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Per saperne di più, consulta l'elenco delle API di YouTube soggette alle norme sul ritiro.
Visualizza metriche
- engagedViews (metrica principale)
- Il numero di volte in cui i video del canale sono stati visualizzati oltre il primo frame o l'utente ha fatto clic/ha toccato per riprodurli.
- views (metrica principale)
- Questa metrica rappresenta numeri diversi in tipi di report diversi. Questa metrica include le visualizzazioni condivise quando più persone guardano insieme contenuti su uno schermo TV.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- Questa metrica è definita nella sezione Metriche delle playlist.
- redViews
- Il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Premium (in precedenza noto come YouTube Red).
- viewerPercentage (metrica principale)
- La percentuale di spettatori che hanno eseguito l'accesso durante la visione del video o della 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 di visualizzazione dei video da parte degli utenti per il canale, il proprietario dei contenuti, il video o la playlist specificati. Questa metrica include le visualizzazioni condivise quando più persone guardano insieme contenuti su uno schermo TV. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Il numero di minuti di visualizzazione di un video da parte degli abbonati a YouTube Premium (in precedenza noto come YouTube Red).
- averageViewDuration (metrica principale)
- La durata media, in secondi, delle riproduzioni video. A partire dal 13 dicembre 2021, questa metrica esclude il traffico dei 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 guardata durante la riproduzione. A partire dal 13 dicembre 2021, questa metrica esclude il traffico dei clip in loop.
Metriche sul coinvolgimento
- comments (metrica principale)
- Il numero di volte in cui gli utenti hanno commentato un video. Per ulteriori informazioni, consulta il Centro assistenza YouTube. 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 apprezzato 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. Per ulteriori informazioni, consulta il Centro assistenza YouTube. 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 visualizzata nella home page di YouTube. Nei report sul canale, questa metrica include gli iscritti acquisiti da uno di questi luoghi. Tuttavia, nei report che utilizzano la dimensionevideoo il parametrofilterper limitare la risposta in modo da includere solo i dati di un determinato video, la metricasubscribersGainedincluderà solo le statistiche della 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 relativi a questa metrica vengono registrati in modo simile alla metricasubscribersGained. Nei report sui canali, questa metrica include gli iscritti persi tramite qualsiasi meccanismo con cui gli utenti possono annullare l'iscrizione a un canale. Tuttavia, nei report che utilizzano la dimensionevideoo il parametrofilterper 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 dalla pagina di visualizzazione del video specificato. - videosAddedToPlaylists
- Il numero di volte in cui i video sono stati aggiunti a una 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 vengono conteggiate 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 di nuovo, il valore della metrica riflette l'aggiunta del video a una playlist due volte. I dati relativi a 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 dalle 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, il che significa che 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 riflette la rimozione del video da una playlist due volte. I dati relativi a questa metrica non sono disponibili per le date precedenti al 1° ottobre 2014.
Metriche delle playlist
I report sulle playlist contengono due tipi di metriche che spiegano in che modo gli spettatori interagiscono con i video di 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 relative ai 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.
Per le definizioni delle metriche aggregate dei video supportate, consulta le sezioni Metriche relative alle visualizzazioni e Metriche relative al tempo di visualizzazione di questo documento.
-
Le metriche relative alle playlist riflettono l'attività utente e il coinvolgimento nel contesto della pagina della playlist. Queste metriche includono le visualizzazioni di tutti i video della playlist, indipendentemente dal canale proprietario, ma conteggiano solo le visualizzazioni avvenute nel contesto della playlist.
La maggior parte delle metriche riportate di seguito sono metriche relative alle playlist. Le restanti metriche dell'elenco, come la metrica playlistSaves, riguardano le interazioni degli utenti con la playlist stessa e non con i video al suo interno. Di conseguenza, queste metriche non verrebbero classificate come metriche aggregate dei video o metriche della playlist.
- averageTimeInPlaylist
- Il tempo medio stimato, in minuti, in cui uno spettatore ha guardato i video di una playlist
dopo l'avvio della playlist. Tieni presente che questa metrica include solo le visualizzazioni della playlist che si sono verificate sul web.
- playlistAverageViewDuration
- La durata media stimata, in secondi, guardata per singola 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 che ogni spettatore trascorre guardando la playlist nel suo complesso. Questa metrica include i dati relativi ai video della 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. Il tempo di visualizzazione generato in altri contesti, ad esempio quello derivante dalle visualizzazioni generate quando gli spettatori guardavano lo stesso video nell'ambito di altre playlist, non viene conteggiato. Questa metrica include i dati relativi ai video della 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 variazione netta, il che significa che 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 un salvataggio della playlist.
- playlistStarts
- Il numero di volte che gli spettatori hanno avviato la riproduzione di una playlist. Tieni presente che questa metrica include solo le visualizzazioni della 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.
Questa metrica include i dati relativi ai video della playlist di proprietà di altri canali.
- viewsPerPlaylistStart
- 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 della playlist che si sono verificate sul web.
Metriche delle annotazioni
Nota: i report dell'API YouTube Analytics restituiscono solo i dati relativi alle metriche annotationClickThroughRate e annotationCloseRate a partire dal 10 giugno 2012. Inoltre, i report dell'API YouTube Analytics restituiscono solo i dati relativi alle metriche delle annotazioni rimanenti a partire dal 16 luglio 2013.
- annotationImpressions
- Il numero totale di impressioni delle annotazioni.
- annotationClickableImpressions
- Il numero di annotazioni che sono state visualizzate e che potevano essere selezionate tramite clic.
- annotationClicks
- Il numero di annotazioni su cui è stato fatto 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. Il Centro assistenza YouTube contiene ulteriori informazioni sulla creazione di annotazioni e sull'utilizzo di annotazioni con link.
- annotationClosableImpressions
- Il numero di annotazioni che sono state visualizzate e che potevano 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 sul report Schede di YouTube Analytics.
- cardImpressions
- Il numero di volte in cui sono state visualizzate le schede. Quando viene aperto il riquadro delle schede, viene registrata un'impressione per ciascuna scheda del video.
- cardClicks
- Il numero di volte in cui è stato fatto clic sulle schede.
- cardClickRate
- La percentuale di clic per le schede, calcolata come rapporto tra i clic sulle schede e le impressioni delle schede.
- Il numero di volte in cui sono stati visualizzati i teaser delle schede. Una visualizzazione di video può generare più impressioni del teaser.
- Il numero di clic sui teaser delle schede. I clic sull'icona della scheda sono attribuiti all'ultimo teaser visualizzato dall'utente.
- La percentuale di clic per i teaser delle schede, calcolata come il rapporto tra i clic sui teaser delle schede e il numero totale di impressioni dei teaser delle schede.
Metriche dei live streaming (spettatori simultanei)
- averageConcurrentViewers
- Il numero medio di spettatori simultanei per un determinato video. Questa metrica include i co-spettatori quando più persone guardano insieme i contenuti su uno schermo TV. Se per il report viene specificata la dimensione livestreamPosition, il valore
averageConcurrentViewersspecifica il numero medio di spettatori simultanei durante un determinato segmento - peakConcurrentViewers
- Il numero massimo di spettatori simultanei per un determinato video. Questa metrica include i co-spettatori quando più persone guardano insieme i contenuti su uno schermo TV. Se per il report è specificata la dimensione livestreamPosition, il valore
peakConcurrentViewersspecifica il numero massimo di spettatori simultanei durante un determinato segmento del video.
Metriche sulla fidelizzazione del pubblico
- audienceWatchRatio
- La percentuale assoluta di spettatori che guardano il video in un determinato punto. 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
elapsedVideoTimeRatioidentifica la porzione del video a cui corrisponde la metrica.
Tieni presente che una parte di un video potrebbe essere guardata più di una volta (o non essere guardata affatto) in una determinata visualizzazione di 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 superiore a1.
I seguenti esempi illustrano come viene calcolato il valore:- Un video di un minuto viene guardato 100 volte. Metà degli spettatori interrompe la visione dopo 15 secondi e l'altra metà guarda l'intero video. Nessuno degli spettatori guarda parti del video più di una volta. In questo caso, il valore di questa metrica sarebbe
1per i bucket di tempo nel primo quarto del video e0.50per il resto del video. - Un video di un minuto viene guardato 100 volte. Tutti gli spettatori guardano l'intero video, ma 20 di loro guardano fino al secondo 45, poi tornano indietro al secondo 30 e guardano il resto del video. In questo caso, il valore della metrica sarebbe
1per i bucket di tempo nella prima metà o nell'ultimo quarto del video. Tuttavia, il valore sarebbe1.2per i bucket di tempo nel terzo trimestre del video, poiché il 100% degli spettatori ha guardato quel segmento del video, ma il 20% di questi spettatori ha guardato il segmento due volte.
- Un video di un minuto viene guardato 100 volte. Metà degli spettatori interrompe la visione dopo 15 secondi e l'altra metà guarda l'intero video. Nessuno degli spettatori guarda parti del video più di una volta. In questo caso, il valore di questa metrica sarebbe
- relativeRetentionPerformance
- Una metrica che mostra la capacità di un video di fidelizzare gli spettatori durante le riproduzioni rispetto a tutti i video di YouTube di durata simile. La metrica ha un valore compreso tra
0e1che identifica il rendimento relativo della fidelizzazione del video in un determinato punto del video. Il punto nel video è fornito dalla dimensioneelapsedVideoTimeRatio.
Un valore pari a0indica che il video fidelizza gli spettatori peggio di qualsiasi altro video di durata simile, mentre un valore pari a1indica che il video fidelizza gli spettatori meglio di qualsiasi altro video di durata simile. Un valore mediano di0.5indica che metà dei video di durata simile fidelizza meglio gli spettatori, mentre l'altra metà li fidelizza peggio.
L'esempio ipotetico riportato di seguito illustra come potrebbero apparire i valori in un report. In media, il 90% degli spettatori che guardano video di 10 minuti continua la visione 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 questi spettatori continuano a guardare dopo otto minuti.- In corrispondenza del valore
elapsedVideoTimeRatioche indica il punto a tre minuti dall'inizio del video, la metricarelativeRetentionPerformanceavrebbe un valore inferiore a0.5, poiché in quel momento il video ha un rendimento peggiore rispetto alla media. - In corrispondenza del valore
elapsedVideoTimeRatiorelativo al punto che si trova a otto minuti dall'inizio del video, la metricarelativeRetentionPerformanceavrebbe un valore superiore a0.5, poiché in quel momento il video ha un rendimento migliore rispetto ad altri video di durata simile.
- In corrispondenza del valore
- startedWatching
- Il numero di volte in cui un determinato segmento del video è stato il primo segmento visualizzato durante la riproduzione di un video.
Ad esempio, supponiamo che il video X duri 5 minuti. Ai fini di questo report, YouTube divide il video in 100 segmenti di 3 secondi, identificati con la dimensione elapsedVideoTimeRatio. Uno spettatore visita YouTube e guarda il primo minuto e dieci secondi del video, che include tutti o parte dei primi 24 segmenti del video. In una visita successiva su YouTube, lo spettatore guarda il resto del video, riprendendo la riproduzione dal segmento 24 e continuando fino al segmento 100.
Questo esempio produrrebbe i seguenti valori delle metriche di visualizzazione:- Il valore della metrica
startedWatchingsarebbe1per i segmenti 1 e 24 e il valore della metrica sarebbe0per tutti gli altri segmenti. - Il valore della metrica
stoppedWatchingsarebbe1per i segmenti 24 e 100, mentre il valore della metrica sarebbe0per tutti gli altri segmenti. - Il valore della metrica
totalSegmentImpressionssarebbe2per il segmento 24 e il valore della metrica sarebbe1per tutti gli altri segmenti.
- Il valore della metrica
- stoppedWatching
- Il numero di volte in cui un determinato segmento del video è stato l'ultimo segmento visualizzato durante la riproduzione di un video. Consulta la definizione della metrica
startedWatchingper un esempio di come viene calcolato il valore di questa metrica. - totalSegmentImpressions
- Il numero di volte in cui è stato visualizzato un determinato segmento di un video. Per un esempio di come viene calcolato il valore di questa metrica, consulta la definizione della metrica
startedWatching. Tieni presente che uno spettatore può guardare lo stesso segmento di un video più volte durante la stessa riproduzione.
Metriche relative all'annullamento degli abbonamenti
- membershipsCancellationSurveyResponses
- Il numero di sondaggi completati dagli utenti di YouTube che hanno annullato l'abbonamento al canale specificato durante il periodo del report.
Metriche relative alle entrate stimate
Nota: le metriche relative alle entrate stimate sono soggette ad aggiustamenti di fine mese e non includono la pubblicità venduta e pubblicata dai partner. Per ulteriori informazioni e note sui dati relativi alle entrate stimate, consulta il Centro assistenza YouTube.
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) (precedentemente denominata
earnings) - Le entrate nette stimate totali da tutte le origini pubblicitarie vendute 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 a un aggiustamento di fine mese e non includono la pubblicità venduta e pubblicata dai partner.
- estimatedAdRevenue (precedentemente denominato
adEarnings) - Il totale delle entrate nette stimate da tutte le origini pubblicitarie vendute 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 la pubblicità venduta e pubblicata dai partner. - estimatedRedPartnerRevenue (in precedenza denominato
redPartnerRevenue) - Le entrate stimate totali generate dagli abbonamenti a YouTube Premium (in precedenza noto come YouTube Red) per le dimensioni del report selezionate. Il valore della metrica riflette le entrate generate sia dai contenuti musicali che da quelli non musicali ed è soggetto ad aggiustamenti di fine mese.
Metriche sul rendimento degli annunci
- grossRevenue
- Le entrate lorde stimate, in USD, 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 le entrate stimate o le entrate nette, che tengono conto della tua quota di proprietà e degli accordi di condivisione delle entrate.
- 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 volte in cui uno spettatore ha riprodotto il tuo video e gli è stata mostrata almeno un'impressione dell'annuncio. Una riproduzione monetizzata viene conteggiata se a uno spettatore viene mostrato un annuncio pre-roll, ma interrompe la visione dell'annuncio prima che il video venga avviato. L'errore stimato previsto per questo dato è ±2,0%.
- playbackBasedCpm
- Le entrate lorde stimate per mille riproduzioni.