Metrics

Questo documento definisce le metriche recuperate dall'API YouTube Reporting. Questa API recupera i report collettivi contenenti i dati di YouTube Analytics relativi a un canale o a un proprietario dei contenuti.

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 le valutazioni dei video (Mi piace e Non mi piace).

Metriche principali

Sebbene l'API YouTube Reporting sia soggetta alle norme relative al ritiro definite nei Termini di servizio, le metriche e le dimensioni non principali non sono soggette a queste norme. Nelle definizioni di questa pagina, qualsiasi metrica di base è identificata esplicitamente come tale.

L'elenco seguente identifica le metriche principali dell'API. Qualsiasi di queste metriche utilizzata anche nell'API YouTube Analytics è anche una metrica di base di quell'API.

Per ulteriori informazioni, consulta l'elenco delle API di YouTube soggette alle norme sul ritiro.

Visualizza metriche

visualizzazioni (metrica principale)
Il numero di volte in cui un video è stato visualizzato. In un report sulle playlist, la metrica indica il numero di volte in cui un video è stato visualizzato nel contesto di una playlist. Il Centro assistenza YouTube fornisce ulteriori informazioni su come vengono registrate le visualizzazioni. This is a core metric and is subject to the Deprecation Policy.
red_views
Il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Premium (in precedenza noto come YouTube Red).
views_percentage (metrica principale)
La percentuale di spettatori che hanno eseguito l'accesso mentre guardavano il video o la playlist. This is a core metric and is subject to the Deprecation Policy.

Metriche relative al tempo di visualizzazione

watch_time_minutes (metrica principale)
Il numero di minuti durante i quali 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.
red_watch_time_minutes
Il numero di minuti durante i quali gli abbonati a YouTube Premium (in precedenza noto come YouTube Red) hanno guardato un video.
average_view_duration_seconds (metrica principale)
La durata media, in secondi, delle riproduzioni dei 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 dei video avvenute nel contesto di una playlist. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
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.
share (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.
subscribers_gained (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 guadagnare 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. Per identificare il numero di nuovi iscritti al canale che non si sono iscritti tramite la pagina di visualizzazione di un video, un report di attività utente di base contiene una riga che non specifica un valore della dimensione video_id. Questa riga specifica anche un valore per la metrica subscribersLost, ma non specifica valori per altre metriche.
subscribers_lost (metrica principale)
Il numero di volte in cui gli utenti si sono cancellati da un canale. This is a core metric and is subject to the Deprecation Policy.

I dati per questa metrica vengono registrati in modo simile alla metrica subscribers_gained. Per identificare il numero di utenti che si sono iscritti alla newsletter, ma non hanno annullato l'iscrizione nella pagina di visualizzazione di un video, un report di attività utente di base contiene una riga che non specifica un valore della dimensione video_id. Questa riga specifica anche un valore per la metrica subscribers_gained, ma non specifica valori per altre metriche.
videos_added_to_playlists
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 alle playlist predefinite, come la playlist "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 lo aggiunge di nuovo, il valore della metrica riflette il video aggiunto due volte a una playlist. I dati per questa metrica non sono disponibili per le date precedenti al 1° ottobre 2014.
videos_removed_from_playlists
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 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 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 in che modo gli spettatori interagiscono con i video di una playlist:

  • Le metriche video aggregate forniscono metriche sulle impressioni e sull'attività utente aggregate per tutti i video della playlist che sono di proprietà del canale che possiede la playlist. Le metriche relative ai video di proprietà di altri canali non vengono calcolate nell'aggregazione. Di conseguenza, se un canale crea una playlist contenente solo video di proprietà di altri canali, i report relativi a queste playlist non forniranno valori per queste metriche.

    Per le definizioni delle metriche video aggregate supportate, consulta le sezioni Metriche sulle visualizzazioni e Metriche sul tempo di visualizzazione di questo documento.

  • Le metriche all'interno della 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 vengono conteggiate solo le visualizzazioni generate nel contesto della playlist.

La maggior parte delle metriche elencate di seguito si riferisce alla playlist; le metriche rimanenti nell'elenco, come la metrica playlistSaves, riguardano le interazioni degli utenti con la playlist stessa e non con i video al suo interno. Pertanto, queste metriche non possono essere considerate come metriche video aggregate o metriche all'interno delle playlist.

playlist_starts
Il numero di volte che gli spettatori hanno avviato la riproduzione di una playlist. Tieni presente che questa metrica include solo le visualizzazioni di playlist avvenute sul web.
playlist_saves_added (supportato solo nell'API di reporting di YouTube)
Il numero 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 assoluto, 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 due salvataggi di playlist.
playlist_saves_removed (supportato solo nell'API di reporting di YouTube)
Il numero di volte in cui gli utenti hanno rimosso la playlist dai propri elenchi di playlist salvate. Questa metrica restituisce un numero assoluto, il che significa che se un utente salva una playlist, la rimuove dall'elenco delle playlist salvate, la salva di nuovo e la rimuove di nuovo, il valore della metrica riflette la rimozione di due salvataggi di playlist.

Metriche relative alle annotazioni

annotation_impressions
Il numero totale di impressioni delle annotazioni.
annotation_clickable_impressions
Il numero di annotazioni visualizzate su cui è stato possibile fare clic.
annotation_clicks
Il numero di annotazioni su cui è stato fatto clic.
annotation_click_through_rate (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. Nel Centro assistenza YouTube puoi trovare ulteriori informazioni sulla creazione delle annotazioni e sull'utilizzo delle annotazioni con link.
annotation_closable_impressions
Il numero di annotazioni visualizzate e che potevano essere chiuse.
annotation_closes
Il numero di annotazioni chiuse.
annotation_close_rate (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 delle schede

Il Centro assistenza YouTube contiene istruzioni più dettagliate su come aggiungere schede ai video e sul report Schede di YouTube Analytics.

card_impressions
Il numero di volte in cui le schede sono state visualizzate. Quando viene aperto il riquadro delle schede, viene registrata un'impressione per ciascuna scheda del video.
card_clicks
Il numero di volte in cui le schede sono state selezionate.
card_click_rate
La percentuale di clic per le schede, calcolata come il rapporto tra clic e impressioni delle schede.
card_teaser_impressions
Il numero di volte in cui sono stati visualizzati i teaser della scheda. Una visualizzazione di un video può generare più impressioni di teaser.
card_teaser_clicks
Il numero di clic sui teaser della scheda. I clic sull'icona della scheda sono attribuiti all'ultimo teaser mostrato all'utente.
card_teaser_click_rate
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 delle schermate finali

Le schermate finali sono elementi che vengono mostrati negli ultimi 5-20 secondi di un video per promuovere i tuoi contenuti, il tuo canale e i tuoi siti web. Il Centro assistenza YouTube contiene istruzioni più dettagliate su come aggiungere le schermate finali ai video e sul report sulle schermate finali di YouTube Analytics.

Nota:i dati relativi alle metriche della schermata finale sono disponibili dal 1° maggio 2016.

end_screen_element_impressions
Il numero di elementi della schermata finale visualizzati. Viene registrata un'impressione per ogni elemento della schermata finale visualizzato.
end_screen_element_clicks
Il numero di volte in cui sono stati fatti clic sugli elementi della schermata finale.
end_screen_element_click_rate
Il tasso di clic per gli elementi della schermata finale, calcolato come il rapporto tra i clic sugli elementi della schermata finale e le impressioni degli elementi della schermata finale.

Metriche sulla fidelizzazione del pubblico

audience_retention_percentage
Il rapporto assoluto tra gli spettatori che guardano il video in un determinato momento. 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 elapsed_video_time_percentage 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 riavvanzano e guardano la stessa parte di un video più volte, 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. La metà degli spettatori smette di guardare il video dopo 15 secondi, mentre il resto lo guarda per intero. 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 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 al 30° secondo e guardano il resto 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 sarà 1.2 per gli intervalli di tempo nel terzo quarto del video, poiché il 100% degli spettatori ha guardato quel segmento del video, ma il 20% di questi spettatori lo ha guardato due volte.

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 di generazione 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 da partner. Per ulteriori informazioni e note sulle cifre stimate delle entrate, consulta il Centro assistenza YouTube.

L'API di reporting di YouTube riporta tutte le entrate e gli utili stimati in dollari statunitensi.
estimated_partner_revenue (metrica principale)
Le entrate nette stimate totali da tutte le origini pubblicitarie vendute da Google e da quelle non pubblicitarie per la regione e l'intervallo di date selezionati.
estimated_partner_ad_revenue
Le entrate nette stimate totali da tutte le sorgenti pubblicitarie vendute da Google per la regione e l'intervallo di date selezionati.

Le metriche relative alle entrate stimate sono soggette ad aggiustamento di fine mese e non includono le entrate pubblicitarie derivanti da annunci venduti o pubblicati dai partner.
estimated_partner_ad_auction_revenue (supportato solo nell'API di reporting di YouTube)
Utili stimati totali (entrate nette) da pubblicità venduta all'asta tramite AdSense per la regione e l'intervallo di date selezionati. In precedenza, questa metrica si chiamava estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (supportato solo nell'API di reporting di YouTube)
Utili stimati totali (entrate nette) provenienti dalla pubblicità AdSense venduta all'asta per la regione e l'intervallo di date selezionati.
estimated_partner_ad_reserved_revenue (supportato solo nell'API di reporting di YouTube)
Gli utili stimati totali (entrate nette) provenienti dalla pubblicità venduta con prenotazione tramite DoubleClick (DCLK) e altre sorgenti vendute da YouTube. In precedenza, questa metrica si chiamava estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (supportato solo nell'API di reporting di YouTube)
Gli utili stimati totali (entrate nette) provenienti dalla pubblicità venduta con prenotazione tramite DoubleClick (DCLK) e altre sorgenti vendute su YouTube.
estimated_partner_red_revenue (supportato solo nell'API di reporting di YouTube)
Gli utili stimati totali (entrate nette) provenienti dagli abbonamenti a YouTube Premium (in precedenza noto come YouTube Red).
estimated_partner_transaction_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate totali stimate derivanti dalle transazioni, come contenuti a pagamento e finanziamenti dei fan, al netto dei rimborsi addebitati dai partner.

Metriche sul rendimento degli annunci

estimated_youtube_ad_revenue
Le entrate lorde stimate, in dollari statunitensi, generate 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 o le entrate nette, che tengono conto della tua quota di proprietà e dei contratti di condivisione delle entrate.
estimated_cpm
Le entrate lorde stimate per mille impressioni dell'annuncio.
ad_impressions
Il numero di impressioni degli annunci verificate pubblicate.
estimated_monetized_playbacks
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 pre-roll, ma interrompe la visione dell'annuncio prima dell'inizio del video. L'errore stimato previsto per questo valore è ±2,0%.
estimated_playback_based_cpm
Le entrate lorde stimate per mille riproduzioni.