Metrics

Questo documento definisce le metriche recuperate dall'API di reporting di YouTube. Questa API recupera report di dati collettivi che contengono 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 sull'attività utente includono elementi come i conteggi delle visualizzazioni dei video e le valutazioni (Mi piace e Non mi piace).

Metriche principali

Sebbene l'API di reporting di YouTube sia soggetta alle Norme relative alla dismissione definite nei Termini di servizio, le metriche non principali (e le dimensioni non principali) non sono soggette a queste norme. Nelle definizioni riportate in questa pagina, qualsiasi metrica principale viene identificata esplicitamente come tale.

L'elenco seguente identifica le metriche principali dell'API. Qualsiasi di queste metriche utilizzate anche nell'API di YouTube Analytics sono anche metriche principali in questa API.

Per ulteriori informazioni, consulta l'elenco delle API di YouTube soggette alle Norme relative alla dismissione.

Visualizza metriche

engaged_views (metrica principale)
Il numero di volte in cui i video del canale sono stati visualizzati oltre il primo fotogramma o in cui l'utente ha fatto clic/toccato per riprodurre.
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 segnalate 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. Si calcola dividendo i clic per le impressioni.

Metriche relative al tempo di visualizzazione

watch_time_minutes (metrica principale)
Il numero di minuti in cui gli utenti hanno guardato i video per il canale, il proprietario dei contenuti, il video o la playlist specificati. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
Il numero di minuti in cui 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 di un video. 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.
dislikes (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.
shares (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 acquisire o perdere iscritti in diverse posizioni, 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. 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 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 segnalati in modo simile a quelli della metrica subscribers_gained. Per identificare il numero di utenti che hanno annullato l'iscrizione ma non l'hanno fatto in 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. 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 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, 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.
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, 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 in una playlist:

  • Le metriche video aggregate forniscono metriche sull'attività utente e sulle 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.

    Per le definizioni delle metriche video aggregate supportate, consulta le sezioni relative alle metriche di visualizzazione e alle metriche sul tempo di visualizzazione di questo documento.

  • Le metriche in-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 di proprietà, ma vengono conteggiate solo le visualizzazioni avvenute nel contesto della playlist.

La maggior parte delle seguenti metriche sono metriche in-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 classificate come metriche video aggregate o metriche in-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 avvenute 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 playlist salvate.
playlist_saves_removed (supportata solo nell'API di reporting di YouTube)
Il numero di volte in cui gli utenti hanno rimosso la playlist dagli 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 playlist salvate.

Metriche delle 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 clic effettuati sulle annotazioni.
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 su cui è possibile fare clic. 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 delle annotazioni con link.
annotation_closable_impressions
Il numero di annotazioni visualizzate che è stato possibile chiudere.
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 per aggiungere schede ai video e al report sulle schede di YouTube Analytics.

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

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 è stato fatto clic sugli elementi della schermata finale.
end_screen_element_click_rate
La percentuale di clic degli elementi della schermata finale, calcolata come il rapporto tra i clic sugli elementi della schermata finale e le impressioni degli elementi della schermata finale.

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 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 delle entrate stimate, consulta il Centro assistenza YouTube.

L'API di reporting di YouTube segnala tutte le cifre relative alle entrate e agli utili stimati in dollari statunitensi.
estimated_partner_revenue (metrica principale)
Il totale delle entrate nette stimate da tutte le fonti di pubblicità venduta da Google, nonché da fonti non pubblicitarie per la regione e l'intervallo di date selezionati.
estimated_partner_ad_revenue
Il totale delle entrate nette stimate da tutte le fonti di pubblicità venduta 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 la pubblicità venduta e pubblicata da partner.
estimated_partner_ad_auction_revenue (supportata solo nell'API di reporting di YouTube)
Il totale degli utili stimati (entrate nette) dalla pubblicità venduta all'asta tramite AdSense per la regione e l'intervallo di date selezionati. Questa metrica era precedentemente denominata estimated_partner_ad_sense_revenue.
estimated_partner_ad_reserved_revenue (supportata solo nell'API di reporting di YouTube)
Il totale degli utili stimati (entrate nette) dalla pubblicità venduta con prenotazione tramite DoubleClick (DCLK) e altre fonti vendute da YouTube. Questa metrica era precedentemente denominata estimated_partner_double_click_revenue.
estimated_partner_red_revenue (supportata solo nell'API di reporting di YouTube)
Il totale degli utili stimati (entrate nette) dagli abbonamenti a YouTube Premium (in precedenza noto come YouTube Red).
estimated_partner_transaction_revenue (supportata solo nell'API di reporting di YouTube)
Il totale delle entrate stimate dalle transazioni, come i contenuti a pagamento e il finanziamento dei fan, al netto di eventuali rimborsi addebitati ai 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 da partner DoubleClick per la regione e l'intervallo di date selezionati. Le entrate lorde sono soggette ad aggiustamento di fine mese e non includono la pubblicità pubblicata da partner. Le entrate lorde non devono essere confuse con le entrate stimate o le entrate nette, che vengono considerate nei contratti relativi alla quota di proprietà e alla compartecipazione alle 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 lo spettatore interrompe la visione dell'annuncio prima che il video inizi. L'errore stimato previsto per questa cifra è ±2,0%.
estimated_playback_based_cpm
Le entrate lorde stimate per mille riproduzioni.