Metrics

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

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

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.
visualizzazioni_rosso
Il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Premium (precedentemente noti come YouTube Red).
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
Il numero di minuti in cui gli utenti abbonati a YouTube Premium (precedentemente noti 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 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.
percent_duration_percent_percentage
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.
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 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. Per identificare il numero di nuovi iscritti al canale che non si sono iscritti tramite la pagina di visualizzazione di un video, un report sull'attività dell'utente di base contiene una riga che non specifica un valore di dimensione video_id. La riga specifica anche un valore per la metrica subscribersLost, ma non 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 vengono registrati in modo simile alla metrica subscribers_gained. Per identificare il numero di utenti che hanno annullato l'iscrizione, ma non hanno annullato l'iscrizione in una pagina di visualizzazione del video, un report sull'attività di base dell'utente contiene una riga che non specifica un valore di dimensione video_id. La riga specifica anche un valore per la metrica subscribers_gained, ma non per altre metriche.
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_rimossi_da_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 delle playlist

playlist_starts
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.
playlist_saves_added (supportate solo nell'API di reporting di YouTube)
Il numero di volte in cui gli utenti hanno salvato una playlist. Consulta il Centro assistenza YouTube per scoprire di più sulle playlist salvate. Questa metrica restituisce un numero assoluto, pertanto se un utente salva una playlist, la rimuove dall'elenco di playlist salvate e la salva di nuovo, il valore della metrica riflette l'aggiunta di due playlist salvate.
playlist_saves_remove (supportato solo nell'API di reporting di YouTube)
Il numero di volte in cui gli utenti hanno rimosso la playlist dal proprio elenco di playlist salvate. Questa metrica restituisce un numero assoluto, vale a dire che se un utente salva una playlist, la rimuove dall'elenco di playlist salvate, la salva di nuovo e la rimozione di nuovo, il valore della metrica riflette la rimozione di due playlist salvate.

Metriche relative alle annotazioni

annot_impressioni
Il numero totale di impressioni delle annotazioni.
annot_impressioni_cliccabili
Il numero di annotazioni visualizzate e su cui è stato possibile fare clic.
clic_annotazione
Il numero di annotazioni selezionate.
percentuale_di_clic_annotazione (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.
annot_impressioni_closable
Il numero di annotazioni visualizzate e che potrebbero essere chiuse.
chiuse_annotazioni
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 sul 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 della scheda per ogni scheda del video.
clic_card
Il numero di clic sulle schede.
percentuale_di_clic_card
La percentuale di clic delle schede, che viene calcolata come il rapporto tra i clic della scheda e le impressioni della scheda.
impressioni_scheda_teaser
Il numero di volte in cui sono stati mostrati i teaser delle schede. Una visualizzazione video può generare più impressioni del teaser.
click_teaser_clic
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_card_teaser
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 della schermata finale

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

Nota: i dati per le metriche della schermata finale sono disponibili a partire dal 1° maggio 2016.

impressioni_elemento_schermata_fine
Il numero di elementi della schermata finale che sono stati visualizzati. Viene registrata un'impressione per ogni elemento della schermata finale visualizzato.
clic_elemento_schermata_fine
Il numero di volte in cui è stato fatto clic sugli elementi della schermata finale.
percentuale_di_clic_elemento_schermata_end
La percentuale di clic degli elementi della schermata finale, che viene calcolata come il rapporto tra i clic dell'elemento della schermata finale e le impressioni dell'elemento della schermata finale.

Metriche sulla fidelizzazione del pubblico

percentuale_di_fidelizzazione_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 elapsed_video_time_percentage 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.

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.

L'API di reporting di YouTube riporta tutti i dati relativi a entrate e utili stimati in dollari statunitensi.
estimated_partner_revenue (metrica principale)
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.
entrate_partner_stimate
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.
estimated_partner_ad_auction_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate stimate totali (entrate nette) della pubblicità venduta all'asta tramite AdSense per la regione e l'intervallo di date selezionati. Questa metrica era chiamata in precedenza estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate stimate totali (entrate nette) dalla pubblicità AdSense venduta all'asta per la regione e l'intervallo di date selezionati.
estimated_partner_ad_reservation_revenue (supportato solo nell'API di reporting di YouTube)
Il totale degli utili stimati (entrate nette) dalla pubblicità prenotata e venduta tramite DoubleClick (DCLK) e da altre origini vendute da YouTube. Questa metrica era chiamata in precedenza estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate stimate totali (entrate nette) dalla pubblicità prenotata e venduta tramite DoubleClick (DCLK) e da altre origini vendute su YouTube.
estimated_partner_red_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate stimate totali (entrate nette) generate dagli abbonamenti a YouTube Premium (precedentemente noti come YouTube Red).
estimated_partner_transaction_revenue (supportato solo nell'API di reporting di YouTube)
Le entrate totali stimate generate dalle transazioni, come i contenuti a pagamento e i finanziamenti dei fan, al netto di eventuali rimborsi addebitati ai partner

Metriche sul rendimento degli annunci

entrate_stimate_youtube_
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_stimato
Le entrate lorde stimate per mille impressioni dell'annuncio.
impressioni_annunci
Il numero di impressioni dell'annuncio verificate pubblicate.
stima_monetizzad_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 preroll, ma interrompe la visione dell'annuncio prima che inizi il video. L'errore stimato previsto per questa cifra è ±2,0%.
stima_playback_cpm_cpm
Le entrate lorde stimate per mille riproduzioni.