YouTube Analytics API: Channel Reports

Questa pagina elenca i report che i proprietari dei canali possono recuperare con l'API YouTube Analytics. I report sui canali forniscono metriche sull'attività utente per un canale specifico e misurano elementi come visualizzazioni, valutazioni e numero di iscrizioni ai video.

  • I report sui video forniscono statistiche su tutta l'attività utente relativa ai video di un canale.
  • I report sulle playlist forniscono statistiche specificamente correlate alle visualizzazioni dei video che si verificano nel contesto di una playlist.
  • I report sul rendimento degli annunci contengono metriche relative alle entrate e al rendimento degli annunci. Utilizzano la dimensione adType per raggruppare le metriche in base ai tipi di annunci pubblicati durante la riproduzione dei video. La sezione Report sul rendimento degli annunci spiega i due tipi di metriche sul rendimento degli annunci supportate dall'API.

Recuperare un report

Per recuperare un report sul canale, devi impostare il valore del parametro ids nella richiesta API su uno dei seguenti valori:

  • channel==MINE: l'API restituisce i dati del canale YouTube dell'utente autenticato.

  • channel==CHANNEL_ID: imposta CHANNEL_ID sull'ID canale univoco del canale per cui stai recuperando i dati. L'utente che autorizza la richiesta deve essere il proprietario del canale.

    L'ID canale è attualmente una stringa che inizia con le lettere UC, anche se il suo formato è soggetto a modifiche. Puoi trovare l'ID del tuo canale nella pagina Impostazioni avanzate dell'account del tuo canale YouTube oppure puoi recuperarlo in modo programmatico utilizzando il metodo YouTube Data API's channels.list.

Autorizzazione

Tutte le richieste all'API YouTube Analytics devono essere autorizzate. La guida all'autorizzazione spiega come utilizzare il protocollo OAuth 2.0 per recuperare i token di autorizzazione.

Le richieste all'API YouTube Analytics utilizzano i seguenti ambiti di autorizzazione:

Ambiti
https://www.googleapis.com/auth/yt-analytics.readonly Visualizzare i report di YouTube Analytics per i contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività degli utenti, come i conteggi delle visualizzazioni e delle valutazioni.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizzare i report Analytics su YouTube relativi al valore monetario per i contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività utente e alle metriche stimate su entrate e rendimento degli annunci.
https://www.googleapis.com/auth/youtube Gestire il tuo account YouTube. Nell'API YouTube Analytics, i proprietari dei canali utilizzano questo ambito per gestire i gruppi e gli elementi dei gruppi di YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Visualizzare e gestire le risorse di YouTube e i relativi contenuti su YouTube. Nell'API YouTube Analytics, i proprietari dei contenuti utilizzano questo ambito per gestire i gruppi e gli elementi dei gruppi di YouTube Analytics.

Nota:le metriche relative alle entrate stimate e al rendimento degli annunci non sono attualmente supportate per i report sui canali. Di conseguenza, l'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly al momento non concede l'accesso ai dati monetari in questi report.

Filtri

Le tabelle che spiegano i report supportati identificano i filtri che possono essere utilizzati per ciascun report. Nelle tabelle, i filtri mostrati tra parentesi sono facoltativi. Ad esempio, per l'opzione di filtro video(,country), il filtro video è obbligatorio, mentre il filtro paese è facoltativo.

L'API supporta anche la possibilità di specificare più valori per i filtri video e playlist. Se specifichi più valori per uno di questi filtri, puoi anche aggiungerlo all'elenco delle dimensioni specificate per la richiesta. Questo vale anche se il filtro non è elencato come dimensione supportata per un determinato report.

Consulta la definizione del parametro filters per una spiegazione completa di come filtrare i risultati dell'API per un valore o un insieme di valori specifici.

Comprendere le tabelle dei report

Questa sezione spiega la formattazione e la terminologia utilizzate nelle tabelle che definiscono i report supportati dall'API. La seguente tabella elenca le dimensioni, le metriche e i filtri supportati per il report video Dettagli riproduzione utilizzando la dimensione Tempo e la metrica averageViewPercentage.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

La tabella contiene due righe per le dimensioni, una riga per le metriche e tre righe per i filtri. Per dimensioni e filtri, i valori di ogni riga possono essere combinati in una richiesta API, a condizione che la combinazione rispetti le regole di utilizzo nella tabella. Ad esempio, i valori validi del parametro dimensions per questo report includono:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Tuttavia, il valore del parametro day,month non è valido perché utilizza due dimensioni basate sul tempo e la richiesta deve utilizzare 0 o 1.

Terminologia della tabella report

Le tabelle utilizzano la seguente terminologia per indicare se le dimensioni sono obbligatorie o facoltative:

  • Questi termini indicano che è necessario un valore:
    • Obbligatorio:devi includere il valore.
    • Utilizza esattamente 1:devi includere un valore del gruppo.
    • Utilizza uno o più valori:puoi includere uno o tutti i valori del gruppo, ma devi includerne almeno uno.
  • Questi termini indicano che un valore è facoltativo:
    • Facoltativo:puoi includere il valore.
    • Utilizza 0 o 1: hai la possibilità di includere un valore del gruppo.
    • Utilizza 0 o più: hai la possibilità di includere tutti i valori del gruppo o solo alcuni.

Report video

Statistiche di base

Statistiche di base sull'attività utente

Questo report fornisce statistiche relative alle azioni degli utenti su un canale. Puoi filtrare il report in modo che restituisca solo i dati relativi a un video o un paese specifico.

Sommario
Dimensioni:
[Nessuno]
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, redViews, commenti, Mi piace, Non mi piace, videosAddedToPlaylists, videosRemovedFromPlaylists, condivisioni, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
Filtri:
Utilizza 0 o 1 country, continent, subContinent
Utilizza 0 o 1 video, gruppo

Statistiche di base sull'attività utente per gli stati degli Stati Uniti

Questo report fornisce statistiche per un determinato stato degli Stati Uniti o per il Distretto di Columbia. Tieni presente che questo report supporta solo un sottoinsieme delle metriche disponibili nel report specifico per paese descritto sopra.

Sommario
Dimensioni:
[Nessuno]
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Obbligatorio province
Utilizza 0 o 1 video, gruppo

Basato sul tempo

Attività utente per paese per periodi di tempo specifici

Questo report fornisce statistiche relative alle azioni degli utenti su un canale per intervalli di tempo specifici. Puoi filtrare il report in modo che restituisca solo i dati relativi a un video o un paese specifico.

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
Filtri:
Utilizza 0 o 1 country, continent, subContinent
Utilizza 0 o 1 video, gruppo

Attività utente negli stati degli Stati Uniti per periodi di tempo specifici

Questo report fornisce statistiche relative all'attività utente per un determinato stato degli Stati Uniti o per il Distretto di Columbia. Tieni presente che questo report supporta solo un sottoinsieme delle metriche disponibili nel report specifico per paese descritto sopra.

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Obbligatorio province
Utilizza 0 o 1 video, gruppo

Regione degli utenti

Attività utente per paese

Questo report fornisce statistiche sull'attività utente paese per paese per un canale. Puoi filtrare il report in modo che restituisca solo i dati relativi a un video specifico.

Sommario
Dimensioni:
Obbligatorio country
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, redViews, commenti, Mi piace, Non mi piace, videosAddedToPlaylists, videosRemovedFromPlaylists, condivisioni, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
Filtri:
Utilizza 0 o 1 continent, subContinent
Utilizza 0 o 1 video, gruppo

Attività utente per provincia

Questo report fornisce statistiche sull'attività utente per gli stati degli Stati Uniti e il distretto di Columbia. Per questo report, devi impostare il valore del parametro filters su country==US.

Sommario
Dimensioni:
Obbligatorio province
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Obbligatorio country==US
Utilizza 0 o 1 video, gruppo

Attività utente per città (<= 250 risultati)

Nota:questo report richiede di impostare il parametro maxResults su un valore intero pari o inferiore a 250. A differenza della maggior parte degli altri report, questo report richiede anche di specificare un valore per il parametro di richiesta sort.

Questo report fornisce statistiche sull'attività utente per città.

Sommario
Dimensioni:
Obbligatorio city
Utilizza 0 o più creatorContentType, country, province, subscribedStatus

Nota:se includi la dimensione province, devi utilizzare anche il filtro country==US.
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Attività utente per DMA

Questo report fornisce statistiche sull'attività utente per area di mercato designata (DMA). Per questo report, devi impostare il valore del parametro filters su country==US o filtrare in base a una provincia (stato degli Stati Uniti) specifica.

Sommario
Dimensioni:
Obbligatorio dma
Utilizza 0 o 1 day
month
creatorContentType
subscribedStatus
Metriche:
Utilizza uno o più engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
Filtri:
Utilizza 0 o 1 country==US
province
Utilizza 0 o 1 video
di gruppo
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Dettagli della riproduzione

I report sui dettagli di riproduzione forniscono statistiche relative ai seguenti attributi di visualizzazione:

  • La visualizzazione riguardava una trasmissione video live o un video on demand?
  • Lo spettatore era iscritto al canale proprietario del video?
  • Su quale prodotto YouTube è avvenuta la visualizzazione?

Nota:la dimensione e il filtro liveOrOnDemand non possono essere utilizzati insieme alla metrica averageViewPercentage. Pertanto, ognuna delle seguenti sottosezioni elenca due report. Un report supporta la dimensione (e il filtro) liveOrOnDemand, mentre l'altro supporta la metrica averageViewPercentage.

Attività utente per stato di iscrizione

Questo report fornisce metriche sull'attività utente per gli spettatori iscritti e non iscritti. Le statistiche possono essere raggruppate per periodo di tempo (giorno o mese) e il report può essere filtrato anche per paese, continente o subContinent.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Utilizza 0 o 1 country, continent, subContinent
Utilizza 0 o 1 video, gruppo
Facoltativo subscribedStatus

Attività utente per stato di iscrizione per province

Questo report fornisce metriche sull'attività utente per gli spettatori iscritti e non iscritti negli stati degli Stati Uniti o nel Distretto di Columbia. Questo report supporta un numero inferiore di metriche rispetto al precedente.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più province, subscribedStatus

Dettagli della riproduzione con dimensione temporale facoltativa

La dimensione temporale (giorno o mese) è facoltativa per questi report perché, in ogni caso, devi utilizzare i parametri di richiesta startDate e endDate per specificare l'intervallo di date che il report coprirà. Se presente, la dimensione indica che vuoi che i dati del report vengano aggregati per giorno, mese e così via.

Dettagli di riproduzione con dimensione temporale facoltativa e statistiche liveOrOnDemand

Questo report fornisce statistiche dettagliate sulla riproduzione per intervalli di tempo specifici. Supporta la dimensione (e il filtro) liveOrOnDemand.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct
Dettagli della riproduzione con dimensione temporale facoltativa e metrica averageViewPercentage

Questo report fornisce statistiche dettagliate sulla riproduzione per intervalli di tempo specifici. Supporta la metrica averageViewPercentage.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Utilizza 0 o 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Dettagli della riproduzione per paese

Dettagli della riproduzione per paese con statistiche liveOrOnDemand

Questo report fornisce statistiche dettagliate sulla riproduzione paese per paese. Supporta la dimensione (e il filtro) liveOrOnDemand.

Sommario
Dimensioni:
Obbligatorio country
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza 0 o 1 continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct
Dettagli della riproduzione per paese con la metrica averageViewPercentage

Il seguente report è simile a quello precedente. Aggiunge il supporto per la metrica averageViewPercentage, ma non supporta liveOrOnDemand come dimensione o filtro.

Sommario
Dimensioni:
Obbligatorio country
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Dettagli della riproduzione per provincia

Dettagli della riproduzione per provincia con statistiche liveOrOnDemand

Questo report fornisce statistiche dettagliate sulla riproduzione per gli stati degli Stati Uniti e il distretto di Columbia. Supporta la dimensione (e il filtro) liveOrOnDemand.

Sommario
Dimensioni:
Obbligatorio province
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Obbligatorio country==US
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct
Dettagli della riproduzione per provincia con la metrica averageViewPercentage

Il seguente report è simile a quello precedente. Aggiunge il supporto per la metrica averageViewPercentage, ma non supporta liveOrOnDemand come dimensione o filtro.

Sommario
Dimensioni:
Obbligatorio province
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Obbligatorio country==US
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Luoghi di visualizzazione

Report sulla località di riproduzione video

Questo report fornisce statistiche relative al tipo di pagina o applicazione in cui si sono verificate le riproduzioni video.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus

Dettagli del luogo di visualizzazione (<= 25 risultati)

Nota:questo report richiede di impostare il parametro maxResults su un valore intero pari o inferiore a 25. A differenza della maggior parte degli altri report, questo report richiede anche di specificare un valore per il parametro di richiesta sort.

Questo report identifica i lettori video incorporati che hanno generato il maggior numero di visualizzazioni o tempo di visualizzazione per i video di un canale.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationDetail
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Obbligatorio insightPlaybackLocationType==EMBEDDED
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Sorgenti di traffico

Sorgente di traffico

Questo report aggrega le statistiche sulle visualizzazioni in base al modo in cui gli spettatori hanno raggiunto i tuoi contenuti video. Ad esempio, identifica il numero di visualizzazioni derivanti da una ricerca Google o da un link a un video correlato.

Nota:questo report restituisce un errore se il prodotto di numero di video sottoposti a query X numero di giorni nell'intervallo di date supera 50.000. Ad esempio, una query che recupera i dati per 500 ID video può richiedere dati per un massimo di 100 giorni. Per ridurre il numero di righe restituite da una richiesta, suddividi la query in più query che specificano un numero inferiore di video o imposta intervalli di date più brevi.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus

Dettagli della sorgente di traffico (<= 25 risultati)

Nota:questo report richiede di impostare il parametro maxResults su un valore intero pari o inferiore a 25. A differenza della maggior parte degli altri report, questo report richiede anche di specificare un valore per il parametro di richiesta sort.

Questo report aggrega le statistiche di visualizzazione in base ai referrer che hanno generato il maggior numero di visualizzazioni per i contenuti del canale. I referrer sono classificati in base al tipo di sorgente di traffico e la definizione della dimensione insightTrafficSourceDetail identifica le sorgenti di traffico per le quali è disponibile il report. Ad esempio, se imposti il filtro insightTrafficSourceType su ADVERTISING, il report elencherà i tipi di annunci che hanno generato il maggior numero di visualizzazioni o tempo di visualizzazione per i contenuti del canale.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceDetail
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Obbligatorio insightTrafficSourceType (vedi la nota sotto la tabella)
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Nota:questo report è supportato solo per origini di traffico specifiche. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED sono alcune delle sorgenti di traffico non supportate.

Tipo di dispositivo e sistema operativo

Tipo di dispositivo

Questo report aggrega le statistiche sulle visualizzazioni in base al modo in cui gli spettatori hanno raggiunto i tuoi contenuti video. Ad esempio, identifica il numero di visualizzazioni che si sono verificate su dispositivi mobili o console per videogiochi.

Sommario
Dimensioni:
Obbligatorio deviceType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistema operativo

Questo report aggrega le statistiche di visualizzazione in base ai sistemi operativi degli spettatori. Ad esempio, identifica il numero di visualizzazioni che si sono verificate su dispositivi Android o su PlayStation.

Sommario
Dimensioni:
Obbligatorio operatingSystem
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistema operativo e tipo di dispositivo

Questo report aggrega le statistiche di visualizzazione in base ai sistemi operativi e ai tipi di dispositivi degli spettatori. Ad esempio, identifica il numero di visualizzazioni che si sono verificate su tablet Android o su dispositivi desktop Windows.

Sommario
Dimensioni:
Obbligatorio deviceType, operatingSystem
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct

Dati demografici degli spettatori

Questo report aggrega le statistiche di visualizzazione in base al gruppo di età e al genere degli spettatori.

Sommario
Dimensioni:
Utilizza uno o più ageGroup, gender
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus
Metriche:
Utilizza uno o più viewerPercentage
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Nota:i valori di viewerPercentage in questo report non sono normalizzati per valori o combinazioni di valori diversi per le dimensioni dei dettagli di riproduzione (subscribedStatus, liveOrOnDemand o youtubeProduct).

Ad esempio, un report che utilizza la dimensione subscribedStatus restituisce dati viewerPercentage che sommati danno il 100% per le visualizzazioni degli iscritti e dati viewerPercentage che sommati danno il 100% per le visualizzazioni dei non iscritti. Il valore totale di tutti i campi viewerPercentage nel report è pari al 200%.

Puoi utilizzare i filtri per assicurarti che il report contenga solo i dati viewerPercentage per un valore (o una combinazione di valori) per le dimensioni dei dettagli di riproduzione.

Coinvolgimento e condivisione di contenuti

Questo report fornisce statistiche che mostrano la frequenza con cui i video del canale sono stati condivisi su diverse piattaforme social.

Sommario
Dimensioni:
Obbligatorio sharingService
Utilizza 0 o più creatorContentType, subscribedStatus
Metriche:
Utilizza uno o più azioni
Filtri:
Utilizza 0 o 1 country, continent, subContinent
Utilizza 0 o 1 video, gruppo
Facoltativo subscribedStatus

Fidelizzazione del pubblico

Questo report misura la capacità di un video di fidelizzare il pubblico e mostra anche la frequenza con cui sono state guardate parti specifiche di un video. La dimensione elapsedVideoTimeRatio misura la quantità di video trascorsa per i valori delle metriche corrispondenti. Le metriche possono essere suddivise in due categorie:

  • Fidelizzazione del pubblico

    Queste metriche mostrano la capacità del video di fidelizzare il pubblico.

    • audienceWatchRatio è un rapporto che confronta il numero di volte in cui una parte di un video è stata guardata con il numero totale di visualizzazioni del video.
    • relativeRetentionPerformance mostra la capacità di un video di mantenere l'attenzione degli spettatori durante la riproduzione rispetto ad altri video di YouTube di durata simile.
  • Statistiche granulari dello smartwatch

    Queste metriche forniscono informazioni sulla frequenza con cui sono state guardate parti specifiche di un video.

    • startedWatching indica la frequenza con cui gli spettatori hanno iniziato a guardare un video durante un determinato segmento del video.
    • stoppedWatching indica la frequenza con cui gli spettatori hanno smesso di guardare un video durante un determinato segmento del video.
    • totalSegmentImpressions indica la frequenza con cui è stato visualizzato un determinato segmento del video.

Nota:questo report non supporta la possibilità di specificare un elenco di valori separati da virgole per il filtro video; il valore deve specificare un singolo ID video.

Sommario
Dimensioni:
Obbligatorio elapsedVideoTimeRatio
Metriche:
Utilizza uno o più audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
Filtri:
Obbligatorio (video)
Utilizza 0 o più audienceType
subscribedStatus
youtubeProduct

Spettatori simultanei (per i live streaming)

Questo report mostra gli spettatori simultanei in una determinata posizione per un singolo video live streaming. Il filtro specifica il video. La dimensione Posizione in genere rappresenta un singolo minuto.

Sommario
Dimensioni:
Utilizza 0 o 1 livestreamPosition
Metriche:
Utilizza uno o più averageConcurrentViewers
peakConcurrentViewers
Filtri:
Obbligatorio (video)

Video principali

Nota:questi report richiedono di impostare il parametro maxResults su un valore intero pari o inferiore a 200. I dati precedenti al 1° gennaio 2013 sono disponibili solo per i primi 10 video. A differenza della maggior parte degli altri report, questi richiedono anche di specificare un valore per il parametro di richiesta sort.

Video più visti con filtri regionali facoltativi (<= 200 risultati)

Questo report elenca i video principali del canale. Il report può essere filtrato per elencare i video principali per paese, continente o subContinent.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, redViews, commenti, Mi piace, Non mi piace, videosAddedToPlaylists, videosRemovedFromPlaylists, condivisioni, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
Filtri:
Utilizza 0 o 1 country, continent, subContinent
Opzioni di ordinamento: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Video più popolari per stato (fino a 200 risultati)

Questo report elenca i video più popolari del canale in un determinato stato degli Stati Uniti o nel Distretto di Columbia. Tieni presente che questo report supporta solo un sottoinsieme delle metriche disponibili nel report specifico per paese descritto sopra.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Obbligatorio province
Facoltativo subscribedStatus
Opzioni di ordinamento: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video più visti per spettatori iscritti o non iscritti(<= 200 risultati)

Questo report elenca i video più popolari del canale per gli spettatori iscritti o non iscritti. Il report può essere filtrato per elencare i video principali per paese, continente o subContinent. Il report precedente consente di recuperare i video più popolari in un determinato stato degli Stati Uniti per gli spettatori iscritti o non iscritti, ma supporta meno metriche rispetto a questo report.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtri:
Facoltativo subscribedStatus
Utilizza 0 o 1 country, continent, subContinent
Opzioni di ordinamento: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video più popolari per prodotto YouTube (<= 200 risultati)

Questo report elenca i video più popolari del canale e supporta i filtri geografici e dei dettagli di riproduzione. Questo report è simile a quello precedente, ma supporta meno metriche e aggiunge il supporto per il filtro youtubeProduct.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più subscribedStatus, youtubeProduct
Opzioni di ordinamento: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video principali con filtri dei dettagli di riproduzione (<= 200 risultati)

Questo report elenca i video più popolari del canale, filtrati in base a una o più dimensioni dei dettagli di riproduzione: liveOrOnDemand, subscribedStatus e youtubeProduct. A differenza del report precedente, questo supporta il filtro liveOrOnDemand e non supporta la metrica averageViewPercentage.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct
Opzioni di ordinamento: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Report sulle playlist

I report sulle playlist contengono metriche relative all'attività degli utenti correlata ai video nelle playlist del proprietario del canale. Sono disponibili due versioni di questi report e, per ogni report disponibile, le seguenti sezioni contengono una descrizione di ogni versione:

Metriche video aggregate

Queste metriche forniscono dati aggregati sull'attività utente e sulle impressioni 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.

Consulta la sezione Metriche delle playlist supportate per un elenco delle metriche aggregate dei video supportate da YouTube.

Metriche all'interno della playlist

Queste metriche 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 che si sono verificate nel contesto della playlist.

Metriche delle playlist supportate

Sommario
Metriche video aggregate engagedViews, views, estimatedMinutesWatched, averageViewDuration
Metriche all'interno della playlist playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

Statistiche di base

Questo report fornisce statistiche relative alle interazioni degli utenti con i video nelle playlist del canale. Puoi filtrare il report in modo che restituisca solo i dati di una playlist specifica.

Sommario
Dimensioni:
[Nessuno]
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Basato sul tempo

Questo report fornisce statistiche relative alle interazioni degli utenti con i video nelle playlist del canale. Puoi filtrare il report in modo che restituisca solo i dati di una playlist specifica.

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Regione degli utenti

Attività delle playlist per paese

Questo report fornisce statistiche relative alle interazioni degli utenti di un determinato paese con i video nelle playlist del canale.

Sommario
Dimensioni:
Obbligatorio country
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filtri:
Utilizza esattamente 1 playlist, group
Utilizza 0 o 1 continent, subContinent

Attività delle playlist per provincia

Questo report fornisce statistiche sull'attività delle playlist per gli stati degli Stati Uniti e il distretto di Columbia. Per questo report, devi filtrare i risultati in modo da restituire i dati solo per gli Stati Uniti.

Sommario
Dimensioni:
Obbligatorio province
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filtri:
Obbligatorio country==US
Utilizza esattamente 1 playlist, group

Luoghi di visualizzazione

Questo report fornisce statistiche relative al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video della tua playlist.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationType
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Dettagli del luogo di visualizzazione (<= 25 risultati)

Nota:questo report richiede di impostare il parametro maxResults su un valore intero pari o inferiore a 25. A differenza della maggior parte degli altri report, questo report richiede anche di specificare un valore per il parametro di richiesta sort.

Questo report identifica i lettori video incorporati che hanno generato il maggior numero di visualizzazioni o tempo di visualizzazione per i video nelle playlist del canale.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationDetail
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Obbligatorio insightPlaybackLocationType==EMBEDDED
Utilizza esattamente 1 playlist, group
Opzioni di ordinamento: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Sorgenti di traffico

Questo report aggrega le statistiche sulle visualizzazioni in base al modo in cui gli spettatori hanno raggiunto i contenuti della tua playlist. Ad esempio, identifica il numero di visualizzazioni generate da una ricerca Google.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceType
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Dettagli della sorgente di traffico (<= 25 risultati)

Nota:questo report richiede di impostare il parametro maxResults su un valore intero pari o inferiore a 25. A differenza della maggior parte degli altri report, questo report richiede anche di specificare un valore per il parametro di richiesta sort.

Questo report aggrega le statistiche sulle visualizzazioni in base ai referrer che hanno generato il maggior numero di visualizzazioni per i video nelle playlist del canale. I referrer sono classificati in base al tipo di sorgente di traffico e la definizione della dimensione insightTrafficSourceDetail identifica le sorgenti di traffico per le quali è disponibile il report.

Ad esempio, se imposti il filtro insightTrafficSourceType su ADVERTISING, il report elencherà i tipi di annunci che hanno generato il maggior numero di visualizzazioni o tempo di visualizzazione per le playlist del canale.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceDetail
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Obbligatorio insightTrafficSourceType==ADVERTISING (o un altro valore supportato)
Utilizza esattamente 1 playlist, group
Opzioni di ordinamento: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Nota:questo report è supportato solo per origini di traffico specifiche. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED sono alcune delle sorgenti di traffico non supportate.

Tipo di dispositivo e sistema operativo

Tipo di dispositivo

Questo report aggrega le statistiche di visualizzazione in base al modo in cui gli spettatori hanno raggiunto i video nelle tue playlist. Ad esempio, identifica il numero di visualizzazioni che si sono verificate su dispositivi mobili o console per videogiochi.

Sommario
Dimensioni:
Obbligatorio deviceType
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Sistema operativo

Questo report aggrega le statistiche di visualizzazione in base ai sistemi operativi degli spettatori. Ad esempio, identifica il numero di visualizzazioni che si sono verificate su dispositivi Android o su PlayStation.

Sommario
Dimensioni:
Obbligatorio operatingSystem
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Sistema operativo e tipo di dispositivo

Questo report aggrega le statistiche di visualizzazione in base ai sistemi operativi e ai tipi di dispositivi degli spettatori. Ad esempio, identifica il numero di visualizzazioni su tablet Android o computer Windows.

Sommario
Dimensioni:
Obbligatorio deviceType, operatingSystem
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Utilizza esattamente 1 playlist, group

Dati demografici degli spettatori

Sommario
Dimensioni:
Utilizza uno o più ageGroup, gender
Metriche:
Obbligatorio viewerPercentage
Filtri:
Utilizza esattamente 1 playlist, group

Playlist principali

Nota:questi report richiedono di impostare il parametro maxResults su un valore intero pari o inferiore a 200. I dati precedenti al 1° gennaio 2013 sono disponibili solo per le prime 10 playlist. A differenza della maggior parte degli altri report, questi richiedono anche di specificare un valore per il parametro di richiesta sort.

Questo report elenca le playlist più popolari del canale in base ai criteri di filtro e ordinamento specificati.

Sommario
Dimensioni:
Obbligatorio playlist
Metriche:
Utilizza uno o più averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Opzioni di ordinamento: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Report sugli abbonamenti

Annullamenti degli abbonamenti

Questo report fornisce statistiche che mostrano i motivi per cui gli utenti hanno annullato i loro abbonamenti al canale.

Sommario
Dimensioni:
Utilizza 0 o 1 membershipsCancellationSurveyReason
Metriche:
Obbligatorio membershipsCancellationSurveyResponses

Report sul rendimento degli annunci

Nota:i report sul rendimento degli annunci richiedono un token di autorizzazione che conceda l'accesso all'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

I report sul rendimento degli annunci forniscono metriche basate sulle impressioni per gli annunci pubblicati durante la riproduzione dei video. Queste metriche tengono conto di ogni impressione dell'annuncio e ogni riproduzione video può generare più impressioni.

Le metriche sul rendimento degli annunci basate sulle impressioni sono:

Inoltre, alcuni report video supportano le seguenti metriche sul rendimento degli annunci basate sulla riproduzione. Tuttavia, queste metriche non sono incluse nei report sul rendimento degli annunci.

Rendimento degli annunci per tipo di annuncio

Sommario
Dimensioni:
Obbligatorio adType
Facoltativo day
Metriche:
Utilizza uno o più grossRevenue, adImpressions, cpm
Filtri:
Utilizza 0 o 1 video, gruppo
Utilizza 0 o 1 country, continent, subContinent