Questo documento definisce le metriche recuperate dall'API di reporting di YouTube. Questa API recupera i report sui dati collettivi che contengono i dati di YouTube Analytics relativi a un canale o a un proprietario dei contenuti.
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
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, ogni metrica principale è identificata esplicitamente come tale.
L'elenco seguente identifica le metriche principali dell'API. Tutte queste metriche utilizzate anche nell'API YouTube Analytics sono metriche principali anche in quell'API.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Per saperne di più, consulta l'elenco delle API di YouTube soggette alle norme sul ritiro.
Visualizza metriche
- engaged_views (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)
- 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. Questa metrica include le visualizzazioni condivise quando più persone guardano insieme contenuti su uno schermo TV.
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 durante la visione del video o della playlist. This is a core metric and is subject to the Deprecation Policy.
Metriche di copertura
- video_thumbnail_impressions
- Il numero di volte in cui le miniature dei video sono state mostrate agli spettatori. Il conteggio avviene se la miniatura viene mostrata per più di un secondo ed è visibile sullo schermo per almeno il 50%. Per ulteriori informazioni, consulta il Centro assistenza YouTube.
- video_thumbnail_impressions_ctr
- La percentuale di impressioni che hanno generato un clic per guardare il video. Questo valore viene calcolato dividendo i clic per le impressioni.
Metriche relative al tempo di visualizzazione
- watch_time_minutes (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.
- red_watch_time_minutes
- Il numero di minuti di visualizzazione di un video da parte degli abbonati a YouTube Premium (in precedenza noto come YouTube Red).
- 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 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 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. - 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 visualizzata nella home page di YouTube. Per identificare il numero di nuovi iscritti al canale che non si sono iscritti tramite una pagina di visualizzazione del video, un report sull'attività dell'utente di base contiene una riga che non specifica un valore della dimensione video_id. La riga specifica anche un valore per la metricasubscribersLost, ma non specifica 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 relativi a questa metrica vengono registrati in modo simile alla metricasubscribers_gained. Per identificare il numero di utenti che hanno annullato l'iscrizione, ma non l'hanno fatto su una pagina di visualizzazione di un video, un report sull'attività dell'utente di base contiene una riga che non specifica un valore della dimensione video_id. La riga specifica anche un valore per la metricasubscribers_gained, ma non specifica i valori per altre metriche. - videos_added_to_playlists
- 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. - videos_removed_from_playlists
- 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.
- 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 della 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, 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 della playlist.
- playlist_saves_removed (supportata solo nell'API di reporting di YouTube)
- Il numero di volte in cui gli utenti hanno rimosso la playlist dai loro 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 della playlist.
Metriche delle annotazioni
- annotation_impressions
- Il numero totale di impressioni delle annotazioni.
- annotation_clickable_impressions
- Il numero di annotazioni che sono state visualizzate e che potevano essere selezionate tramite 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 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.
- annotation_closable_impressions
- Il numero di annotazioni che sono state 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 della scheda
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 sono state visualizzate le schede. Quando viene aperto il riquadro delle schede, viene registrata un'impressione per ciascuna scheda del video.
- card_clicks
- Il numero di volte in cui è stato fatto clic sulle schede.
- card_click_rate
- 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 delle schermate finali
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 video e sul report Schermate finali di YouTube Analytics.
- 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 sugli elementi delle schermate finali, calcolata come il rapporto tra i clic sugli elementi delle schermate finali e le impressioni degli elementi delle schermate finali.
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.
- estimated_partner_revenue (metrica principale)
- 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.
- estimated_partner_ad_revenue
- 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. - estimated_partner_ad_auction_revenue (supportata solo nell'API di reporting di YouTube)
- Il totale degli utili stimati (entrate nette) da 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_reserved_revenue (supportato solo nell'API di reporting di YouTube)
- Il totale utili stimati (entrate nette) generati dalla pubblicità venduta con prenotazione tramite DoubleClick (DCLK) e altre fonti vendute da YouTube. In precedenza, questa metrica era denominata
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (supportato solo nell'API di reporting di YouTube)
- Il totale degli utili stimati (entrate nette) derivanti 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 stimate totali provenienti dalle transazioni, come i contenuti a pagamento e i finanziamenti dei fan, al netto dei rimborsi addebitati ai partner.
Metriche sul rendimento degli annunci
- estimated_youtube_ad_revenue
- 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.
- 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 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%.
- estimated_playback_based_cpm
- Le entrate lorde stimate per mille riproduzioni.