Metrics

Questo documento definisce le metriche recuperate dall'API di reporting di YouTube. Questa API consente di recuperare report collettivi sui dati 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 i voti (Mi piace e Non mi piace) dei video.

Metriche principali

Sebbene l'API di reporting di YouTube 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. Tutte queste metriche utilizzate anche nell'API YouTube Analytics sono metriche fondamentali in questa API.

Per saperne di più, 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 (precedentemente noto come YouTube Red).
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
Il numero di minuti durante i quali gli abbonati a YouTube Premium (precedentemente noto come YouTube Red) hanno guardato un video.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
quote (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.
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 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. Per identificare il numero di nuovi iscritti al canale che non si sono iscritti tramite una pagina di visualizzazione di un video, un report di base sull'attività dell'utente contiene una riga che non specifica un valore della dimensione video_id. La riga specifica anche un valore per la metrica subscribersLost, ma non i valori per altre metriche.
subscribers_lost (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 metrica subscribers_gained. Per identificare il numero di utenti che hanno annullato l'iscrizione, ma non hanno annullato l'iscrizione su una pagina di visualizzazione di un video, un report di base sull'attività dell'utente contiene una riga che non specifica un valore della dimensione video_id. La riga specifica anche un valore per la metrica subscribers_gained, ma non i 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 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.
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 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 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.

playlist_starts
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.
playlist_saves_added (supportata 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, ovvero se un utente salva una playlist, la rimuove dall'elenco delle playlist salvate e la salva di nuovo, il valore della metrica riflette due salvataggi di playlist aggiunti.
playlist_saves_removed (supportato solo nell'API YouTube Reporting)
Il numero di volte in cui gli utenti hanno rimosso la playlist dai propri elenchi di playlist salvate. Questa metrica restituisce un numero assoluto, ovvero 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 e su cui è possibile fare clic.
annotation_clicks
Il numero di annotazioni che hanno ricevuto 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 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.
annotation_closable_impressions
Il numero di annotazioni che sono apparse e potrebbero 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 della scheda

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

card_impressions
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.
card_clicks
Il numero di volte in cui le schede hanno ricevuto un clic.
card_click_rate
La percentuale di clic delle schede, calcolata come il rapporto tra i clic e le impressioni della scheda.
card_teaser_impressions
Il numero di volte in cui i teaser delle schede sono stati visualizzati. Una visualizzazione video può generare più impressioni teaser.
card_teaser_clicks
Il numero di clic sui teaser delle schede. I clic sull'icona della scheda vengono attribuiti all'ultimo teaser mostrato all'utente.
card_teaser_click_rate
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 della schermata finale

Le schermate finali sono elementi che vengono visualizzati 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 tuoi video e il report sulle schermate finali di YouTube Analytics.

Nota: i dati per le metriche delle schermate finali sono disponibili a partire dal 1° maggio 2016.

end_screen_element_impressions
Il numero di elementi della schermata finale che sono stati visualizzati. Viene registrata un'impressione per ogni elemento della schermata finale visualizzato.
end_screen_element_clicks
Il numero di volte in cui è stato fatto clic sugli elementi della schermata finale.
end_screen_element_click_rate
La percentuale di clic relativa agli elementi delle schermate finali, calcolata come rapporto tra i clic sugli elementi delle schermate finali e le impressioni degli elementi delle schermate finali.

Metriche sulla fidelizzazione del pubblico

audience_retention_percentage
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 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 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 di 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 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 e 0.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 sarebbe 1.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.

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.

L'API di reporting di YouTube riporta tutti i dati stimati relativi a entrate e utili in dollari statunitensi.
estimated_partner_revenue (metrica principale)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (supportata solo nell'API YouTube Reporting)
Gli utili stimati totali (entrate nette) derivanti dalla pubblicità venduta all'asta tramite AdSense per la regione e l'intervallo di date selezionati. In precedenza questa metrica era denominata estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (supportata solo nell'API YouTube Reporting)
Gli utili stimati totali (entrate nette) derivanti dalla pubblicità AdSense venduta all'asta per la regione e l'intervallo di date selezionati.
estimated_partner_ad_reserved_revenue (supportato solo nell'API YouTube Reporting)
Gli utili stimati totali (entrate nette) da pubblicità prenotata e venduta attraverso DoubleClick (DCLK) e altre origini vendute da YouTube. In precedenza questa metrica era denominata estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (supportata solo nell'API di reporting di YouTube)
Gli utili stimati totali (entrate nette) derivanti da pubblicità prenotata e venduta attraverso DoubleClick (DCLK) e altre origini vendute su YouTube.
estimated_partner_red_revenue (supportata solo nell'API YouTube Reporting)
Gli utili stimati totali (entrate nette) generate dagli abbonamenti a YouTube Premium (precedentemente noto come YouTube Red).
estimated_partner_transaction_revenue (supportata solo nell'API YouTube Reporting)
Il totale delle entrate stimate provenienti dalle transazioni, come i contenuti a pagamento e i finanziamenti dei fan, meno eventuali rimborsi addebitati dai partner.

Metriche sul rendimento degli annunci

estimated_youtube_ad_revenue
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à.
estimated_cpm
Le entrate lorde stimate per mille impressioni dell'annuncio.
ad_impressions
Il numero di impressioni dell'annuncio verificate pubblicate.
estimated_monetized_playbacks
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%.
estimated_playback_based_cpm
Le entrate lorde stimate per mille riproduzioni.