Metrics

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 misurazioni individuali dell'attività degli utenti, del rendimento degli annunci o delle entrate stimate. Le metriche sull'attività degli utenti includono elementi come il numero di visualizzazioni dei video e le valutazioni (Mi piace e Non mi piace).

Metriche principali

Sebbene l'API YouTube Analytics sia soggetta alle norme di 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 principale è identificata esplicitamente come tale.

L'elenco seguente identifica le metriche principali dell'API.

Per saperne di più, consulta l'elenco delle API 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 i primi secondi.
Visualizzazioni (metrica principale)
Questa metrica rappresenta numeri diversi in diversi tipi di report. 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 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 in cui gli abbonati a YouTube Premium (in precedenza 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 dei clip in loop. In un report sulle playlist, la metrica indica la durata media, in secondi, delle riproduzioni di 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

commenti (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.
Condivisioni (metrica principale)
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 dei 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 una di queste posizioni. Tuttavia, nei report che utilizzano la dimensione video o il parametro filter per limitare la risposta in modo da includere solo i dati di un determinato video, la metrica subscribersGained includerà 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 per questa metrica vengono riportati in modo simile alla metrica subscribersGained. Nei report sui canali, questa metrica include gli iscritti persi tramite qualsiasi meccanismo attraverso 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 di 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 o alle playlist di altri canali.

Il valore della metrica include il numero di volte in cui i video sono stati aggiunti a playlist predefinite come "Guarda più tardi". Tuttavia, non vengono conteggiate le playlist a cui un video viene aggiunto automaticamente, ad esempio 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 per 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 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 per 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 come gli spettatori interagiscono con i video di una playlist:

  • Le metriche aggregate dei video forniscono metriche relative all'attività degli utenti e alle impressioni che sono aggregate per tutti i video della playlist di proprietà del canale che possiede la 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 Metriche delle visualizzazioni e Metriche del tempo di visualizzazione di questo documento per le definizioni delle metriche aggregate dei video supportate.

  • Le metriche nella playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono le visualizzazioni di tutti i video della playlist, indipendentemente dal canale di proprietà, ma conteggiano solo le visualizzazioni che si sono verificate nel contesto della playlist.

La maggior parte delle metriche seguenti si riferisce alle playlist. Le metriche rimanenti nell'elenco, come la metrica playlistSaves, riguardano le interazioni degli utenti con la playlist stessa e non con i video della playlist. Pertanto, queste metriche non sarebbero caratterizzate come metriche video aggregate o metriche nella playlist.

averageTimeInPlaylist
La quantità di tempo media stimata, 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 delle playlist che si sono verificate sul web.
playlistAverageViewDuration
La durata media stimata, in secondi, guardata per 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, al contrario, rappresenta il tempo medio che ogni spettatore trascorre a guardare la playlist nel suo complesso. Questa metrica include i dati dei video delle playlist di proprietà di altri canali.
playlistEstimatedMinutesWatched
Il numero di minuti in cui gli utenti hanno guardato i contenuti della playlist come parte della playlist. Il tempo di visualizzazione che si è verificato in altri contesti, ad esempio il tempo di visualizzazione delle visualizzazioni che si sono verificate quando gli spettatori guardavano lo stesso video nell'ambito di altre playlist, non viene conteggiato. Questa metrica include i dati dei 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 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 delle playlist avvenute 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 dei video delle 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 di playlist avvenute sul web.

Metriche delle annotazioni

Nota:a partire dal 10 giugno 2012, i report dell'API YouTube Analytics restituiscono solo i dati per le metriche annotationClickThroughRate e annotationCloseRate. Inoltre, i report dell'API YouTube Analytics restituiscono dati solo per le metriche delle annotazioni rimanenti 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 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 selezionabili. This is a core metric and is subject to the Deprecation Policy. Il Centro assistenza YouTube fornisce ulteriori informazioni sulla creazione di annotazioni e sull'utilizzo delle annotazioni con link.
annotationClosableImpressions
Il numero di annotazioni visualizzate 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 per aggiungere schede ai tuoi video e per il report sulle 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 delle schede, calcolata come rapporto tra clic e impressioni della scheda.
cardTeaserImpressions
Il numero di volte in cui sono stati visualizzati i teaser delle schede. Una visualizzazione del video può generare più impressioni del teaser.
cardTeaserClicks
Il numero di clic sui teaser delle schede. I clic sull'icona della scheda sono attribuiti all'ultimo teaser visualizzato dall'utente.
cardTeaserClickRate
La percentuale di clic per i teaser delle schede, calcolata come 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. Se per il report è specificata la dimensione livestreamPosition, il valore averageConcurrentViewers specifica il numero medio di spettatori simultanei durante un determinato segmento
peakConcurrentViewers
Il numero massimo di spettatori simultanei per un determinato video. Se per il report è specificata la dimensione livestreamPosition, il valore peakConcurrentViewers specifica il numero massimo di spettatori simultanei durante un particolare segmento del video.

Metriche sulla fidelizzazione del pubblico

audienceWatchRatio
Il rapporto assoluto tra gli spettatori che guardano il video in un determinato punto del video. Il rapporto viene calcolato confrontando il numero di volte in cui è stata guardata una parte di un video 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 essere guardata affatto) in una determinata visualizzazione del 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 a 1.

I seguenti esempi illustrano come viene calcolato il valore:
  • Un video di un minuto viene guardato 100 volte. Metà degli spettatori smette di guardare il video dopo 15 secondi, mentre l'altra metà lo guarda per intero. Nessuno spettatore guarda più di una volta le parti del video. In questo caso, il valore di questa metrica sarebbe 1 per i bucket temporali nel primo quarto del video e 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 di loro guardano fino al 45° secondo, poi tornano indietro al 30° secondo e guardano il resto del video. In questo caso, il valore della metrica sarebbe 1 per i bucket temporali nella prima metà o nell'ultimo quarto del video. Tuttavia, il valore sarebbe 1.2 per i bucket temporali nel terzo trimestre del video, poiché il 100% degli spettatori ha guardato quel segmento del video, ma il 20% di questi spettatori lo ha guardato due volte.
relativeRetentionPerformance
Una misurazione che mostra la capacità di un video di mantenere l'attenzione degli 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 della fidelizzazione del video in un determinato punto del video. Il punto nel video è fornito dalla dimensione elapsedVideoTimeRatio.

Un valore pari a 0 indica che il video fidelizza gli spettatori peggio di qualsiasi altro video di durata simile, mentre un valore pari a 1 indica che il video fidelizza gli spettatori meglio di qualsiasi altro video di durata simile. Un valore mediano di 0.5 indica che metà dei video di durata simile fidelizzano meglio gli spettatori, mentre l'altra metà li fidelizza meno.

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 guardarli dopo 3 minuti e il 70% dopo 8 minuti. Tuttavia, per un video specifico di 10 minuti, solo l'80% degli spettatori lo sta ancora guardando dopo tre minuti, ma tutti gli spettatori lo stanno ancora guardando dopo otto minuti.
  • Al valore elapsedVideoTimeRatio corrispondente al punto a tre minuti dall'inizio del video, la metrica relativeRetentionPerformance avrebbe un valore inferiore a 0.5, poiché in quel momento il rendimento del video è inferiore a quello del video medio.
  • Al valore elapsedVideoTimeRatio corrispondente al punto a otto minuti dall'inizio del video, la metrica relativeRetentionPerformance avrebbe un valore superiore a 0.5, poiché in quel momento il rendimento del video è migliore rispetto a quello di altri video di durata simile.
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 della metrica di controllo:
  • Il valore della metrica startedWatching sarebbe 1 per i segmenti 1 e 24, mentre il valore della metrica sarebbe 0 per tutti gli altri segmenti.
  • Il valore della metrica stoppedWatching sarebbe 1 per i segmenti 24 e 100, mentre il valore della metrica sarebbe 0 per tutti gli altri segmenti.
  • Il valore della metrica totalSegmentImpressions sarebbe 2 per il segmento 24, mentre il valore della metrica sarebbe 1 per tutti gli altri segmenti.
stoppedWatching
Il numero di volte in cui un determinato segmento del video è stato l'ultimo visto durante la riproduzione di un video. Per un esempio di come viene calcolato il valore di questa metrica, consulta la definizione della metrica startedWatching.
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 più volte lo stesso segmento di un video nella stessa riproduzione.

Metriche relative all'annullamento dell'abbonamento

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 delle entrate stimate sono soggette ad aggiustamenti di fine mese e non includono la pubblicità venduta e pubblicata dai partner. Per ulteriori informazioni e note sulle cifre delle entrate stimate, consulta il Centro assistenza YouTube.

Per impostazione predefinita, tutte le cifre delle entrate stimate sono riportate in dollari statunitensi. Tuttavia, l'API YouTube Analytics supporta il parametro currency per alcune metriche stimate relative alle entrate e al rendimento degli annunci, consentendoti di recuperare i dati sulle entrate stimate in altre valute.
estimatedRevenue (metrica principale) (in precedenza denominata earnings)
Il totale delle entrate nette stimate da tutte le sorgenti pubblicitarie vendute da Google e da sorgenti 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 delle entrate stimate sono soggette ad 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 delle entrate stimate sono soggette a rettifica di fine mese e non includono la pubblicità venduta e pubblicata dai partner.
estimatedRedPartnerRevenue (precedentemente 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 dai contenuti musicali e non musicali ed è soggetto a rettifica 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 le entrate stimate o le entrate nette, che tengono conto della tua quota di proprietà e degli accordi di condivisione delle entrate.
CPM (in precedenza denominato impressionBasedCpm)
Le entrate lorde stimate per mille impressioni dell'annuncio.
adImpressions (in precedenza denominato impressions)
Il numero di impressioni 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 lo spettatore interrompe la visione dell'annuncio prima che inizi la riproduzione del video. L'errore stimato previsto per questa cifra è ±2,0%.
playbackBasedCpm
Entrate lorde stimate per mille riproduzioni.