YouTube Analytics API: Channel Reports

Le dimensioni 7DayTotals e 30DayTotals sono state ritirate. Per ulteriori informazioni, consulta la Cronologia delle revisioni.

Questa pagina elenca i report che i proprietari di canali possono recuperare con l'API di YouTube Analytics. I report sul canale forniscono metriche sulle attività degli utenti per un determinato canale e consentono di misurare elementi quali le visualizzazioni di video, le valutazioni e il numero di iscrizioni.

  • I report Video forniscono statistiche su tutte le attività degli utenti relative ai video di un canale.
  • I report sulle playlist forniscono statistiche specifiche sulle visualizzazioni dei video nel contesto di una playlist.
  • I report sul rendimento degli annunci contengono metriche correlate alle entrate e al rendimento degli annunci. Utilizzano la dimensione adType per raggruppare le metriche in base ai tipi di annunci pubblicati durante le riproduzioni video. La sezione Report sul rendimento degli annunci illustra i due tipi di metriche sul rendimento degli annunci supportati dall'API.

Recupero di 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 per il canale YouTube dell'utente autenticato.

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

    Attualmente, l'ID canale è 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 delle impostazioni avanzate dell'account del tuo canale YouTube oppure puoi recuperare l'ID del tuo canale in modo programmatico usando il metodo YouTube Data API's channels.list.

Autorizzazione

Tutte le richieste all'API di 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 dell'API YouTube Analytics utilizzano i seguenti ambiti di autorizzazione:

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

Nota: al momento, le metriche relative a entrate pubblicitarie e rendimento degli annunci non sono supportate per i report sui canali. Di conseguenza, l'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly non consente attualmente 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. I filtri mostrati tra parentesi sono facoltativi. Ad esempio, per l'opzione di filtro video(,country), è necessario il filtro video, 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 aggiungere il filtro anche all'elenco delle dimensioni specificate per la richiesta. anche se il filtro non è elencato tra le dimensioni supportate per un determinato report.

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

Informazioni sulle tabelle dei report

Questa sezione spiega la formattazione e la terminologia utilizzate nelle tabelle che definiscono i report supportati dall'API. Nella tabella che segue vengono elencate le dimensioni, le metriche e i filtri supportati per i report playlist del canale basati sul tempo:

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Utilizza 0 o più subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

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

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Tuttavia, il valore parametro day,month non è valido perché utilizza due dimensioni basate sul tempo, ma la richiesta deve utilizzare esattamente 1. In questo caso, il valore del parametro subscribedStatus,youtubeProduct restituisce un report, ma le metriche non vengono aggregate per giorno, settimana, mese e così via (questo report è documentato separatamente nella documentazione).

Terminologia della tabella del 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ù: 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 uno o tutti i valori del gruppo.

Report video

Statistiche di base

Statistiche di base sull'attività utente

Questo report fornisce statistiche sulle azioni degli utenti su un canale. Puoi filtrare il report in modo da visualizzare solo i dati relativi a un video o a un paese specifico.

Sommario
Dimensioni:
[Nessuno]
Metriche:
Usa 1 o più
Filtri:
Utilizza 0 o 1 paese, continente, subcontinente
Utilizza 0 o 1 video, gruppo

Statistiche di base sulle attività degli utenti per gli Stati Uniti

Questo rapporto fornisce statistiche per un determinato stato degli Stati Uniti o 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:
Usa 1 o più <ph type="x-smartling-void-element"><br></ph> <ph type="x-smartling-void-element"><br></ph>
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 sulle azioni degli utenti su un canale per intervalli di tempo specifici. Puoi filtrare il report in modo da visualizzare solo i dati relativi a un video o a un paese specifico.

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Facoltativo creatorContentType
Metriche:
Usa 1 o più
Filtri:
Utilizza 0 o 1 paese, continente, subcontinente
Utilizza 0 o 1 video, gruppo

Attività utente negli stati degli USA per periodi di tempo specifici

Questo report fornisce statistiche sull'attività utente per un determinato stato degli USA o 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:
Usa 1 o più <ph type="x-smartling-void-element"><br></ph> <ph type="x-smartling-void-element"><br></ph>
Filtri:
Obbligatorio province
Utilizza 0 o 1 video, gruppo

Regione dell'utente

Attività utente per paese

Questo report fornisce statistiche sull'attività degli utenti per ogni singolo canale. Puoi filtrare il report in modo che restituisca soltanto i dati che riguardano un video specifico.

Sommario
Dimensioni:
Obbligatorio country
Facoltativo creatorContentType
Metriche:
Usa 1 o più
Filtri:
Utilizza 0 o 1 continente, subContinente
Utilizza 0 o 1 video, gruppo

Attività utente per provincia

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

Sommario
Dimensioni:
Obbligatorio province
Facoltativo creatorContentType
Metriche:
Usa 1 o più <ph type="x-smartling-void-element"><br></ph> <ph type="x-smartling-void-element"><br></ph>
Filtri:
Obbligatorio country==IT
Utilizza 0 o 1 video, gruppo

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

Nota: questo report richiede l'impostazione del 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:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Dettagli sulla riproduzione

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

  • La visualizzazione di un video in diretta o di un video on demand è stata vista?
  • Lo spettatore è iscritto al canale proprietario del video?
  • Su quale prodotto YouTube si è verificata la visualizzazione?

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

Attività utente per stato di iscrizione

Questo report fornisce metriche sulle attività degli utenti relative agli spettatori iscritti e non iscritti. Le statistiche possono essere raggruppate per periodo di tempo (giorno o mese) e il report può anche essere filtrato per paese, continente o subContinente.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus
Utilizza 0 o 1 giorno, mese
Metriche:
Usa 1 o più CANNOT TRANSLATE
Filtri:
Utilizza 0 o 1 paese, continente, subcontinente
Utilizza 0 o 1 video, gruppo
Facoltativo subscribedStatus

Attività utente per stato di iscrizione per province

Questo report fornisce metriche sulle attività degli utenti che hanno effettuato l'iscrizione e hanno annullato l'iscrizione negli stati degli Stati Uniti o nel District of Columbia. Questo report supporta meno metriche rispetto al report precedente.

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, subscribedStatus
Utilizza 0 o 1 giorno, mese
Metriche:
Usa 1 o più <ph type="x-smartling-void-element"><br></ph> <ph type="x-smartling-void-element"><br></ph>
Filtri:
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più province, subscribeedStatus

Dettagli sulla riproduzione con dimensione temporale facoltativa

La dimensione Ora (giorno o mese) è facoltativa per questi report, poiché in ogni caso devi utilizzare i parametri di richiesta startDate e endDate per specificare l'intervallo di date che verrà incluso nel report. La dimensione, se presente, indica che vuoi che i dati del report vengano aggregati per giorno, mese e così via.

Dettagli sulla riproduzione con dimensioni temporali facoltative e statistiche liveOrOnDemand

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

Sommario
Dimensioni:
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribeedStatus, youtubeProduct
Utilizza 0 o 1 giorno, mese
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration.
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribeedStatus, youtubeProduct
Dettagli sulla riproduzione con dimensione temporale opzionale 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:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Dettagli sulla riproduzione per paese

Dettagli sulla riproduzione per paese con statistiche liveOrOnDemand

Questo rapporto fornisce statistiche sui dettagli di riproduzione in base al paese. Supporta la dimensione liveOrOnDemand (e il filtro).

Sommario
Dimensioni:
Obbligatorio country
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribeedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration.
Filtri:
Utilizza 0 o 1 continente, subContinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribeedStatus, youtubeProduct
Dettagli sulla riproduzione per paese con la metrica averageViewPercentage

Il seguente report è simile al precedente. Aggiunge 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:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 continente, subContinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Dettagli sulla riproduzione per provincia

Dettagli sulla riproduzione per provincia con statistiche liveOrOnDemand

Questo rapporto fornisce statistiche sui dettagli della riproduzione per gli Stati Uniti e il Distretto di Columbia. Supporta la dimensione liveOrOnDemand (e il filtro).

Sommario
Dimensioni:
Obbligatorio province
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribeedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration.
Filtri:
Obbligatorio paese==US
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribeedStatus, youtubeProduct
Dettagli sulla riproduzione per provincia con la metrica averageViewPercentage

Il seguente report è simile al precedente. Aggiunge 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:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Obbligatorio paese==US
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Luoghi di visualizzazione

Report sulla posizione di riproduzione dei video

Questo report fornisce statistiche sul tipo di pagina o applicazione in cui sono state eseguite riproduzioni video.

Sommario
Dimensioni:
Obbligatorio insightRiproduzioneLocationType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, sottoscritto Stato

Dettaglio della posizione di riproduzione (<= 25 risultati)

Nota: questo report richiede l'impostazione del 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 video player incorporati che hanno generato il maggior numero di visualizzazioni o di tempo di visualizzazione per i video di un canale.

Sommario
Dimensioni:
Obbligatorio insightRiproduzioneLocationDetails
Facoltativo creatorContentType
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Obbligatorio insightRiproduzioneLocationType==EMBEDDED
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, sottoscritto Stato
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Sorgenti di traffico

Sorgente di traffico

Questo report aggrega le statistiche di visualizzazione 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.

Sommario
Dimensioni:
Obbligatorio Tipo di traffico traffico di informazioni
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, sottoscritto Stato

Dettaglio delle sorgenti di traffico (<= 25 risultati)

Nota: questo report richiede l'impostazione del 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 basate sui 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 insightTrafficSourceDetails identifica le sorgenti di traffico per le quali il report è disponibile. 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 il tempo di visualizzazione più elevato per i contenuti del canale.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceDetails
Facoltativo creatorContentType
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Obbligatorio insightTrafficSourceType (vedi la tabella sotto)
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, sottoscritto Stato
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched

Nota: questo report è supportato solo per sorgenti di traffico specifiche. Ad esempio, la sorgente di traffico NO_LINK_EMBEDDED non ha dettagli aggiuntivi e, pertanto, non supporta questo report. Consulta la definizione di insightTrafficSourceType per i dettagli sulle sorgenti di traffico che supportano questo report.

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 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:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
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 sui dispositivi Android o sulle PlayStation.

Sommario
Dimensioni:
Obbligatorio sistemaoperativo
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più deviceType, liveOrOnDemand, subscribeedStatus, 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 sui tablet Android o sui dispositivi desktop Windows.

Sommario
Dimensioni:
Obbligatorio deviceType, operatingSystem
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, subscribeedStatus, youtubeProduct

Dati demografici degli spettatori

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

Sommario
Dimensioni:
Usa 1 o più ageGroup, genere
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus
Metriche:
Usa 1 o più viewerPercentage
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 video, gruppo
Utilizza 0 o più liveOrOnDemand, sottoscritto Stato
Nota: i valori viewerPercentage in questo report non vengono normalizzati per valori o combinazioni di valori diversi per le dimensioni dei dettagli della riproduzione (subscribedStatus, liveOrOnDemand o youtubeProduct).

Ad esempio, un report che utilizza la dimensione subscribedStatus restituisce viewerPercentage dati sommati fino al 160% per le visualizzazioni con un numero di iscritti pari a {130%) e Il valore totale di tutti i campi viewerPercentage nel report è del 200%.

Puoi utilizzare i filtri per assicurarti che il report contenga solo 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:
Usa 1 o più condivisioni
Filtri:
Utilizza 0 o 1 paese, continente, subcontinente
Utilizza 0 o 1 video, gruppo
Facoltativo subscribedStatus

Fidelizzazione del pubblico

Questo report misura la capacità di un video di conservare il pubblico. La dimensione elapsedVideoTimeRatio misura la quantità di video trascorsa per i valori delle metriche corrispondenti. Le metriche audienceWatchRatio e relativeRetentionPerformance forniscono due misurazioni che dimostrano l'efficacia con cui il video fidelizza il suo pubblico. La prima è un valore assoluto, mentre la seconda mostra il rendimento del video rispetto ad altri video di YouTube di durata simile.

Nota:i report sulla fidelizzazione del pubblico non supportano 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
Facoltativo creatorContentType
Metriche:
Usa 1 o più audienceWatchRatio, relativoFidelizzazionePrestazioni
Filtri:
Obbligatorio video
Utilizza 0 o più audienceType, subscribedStatus, youtubeProduct

Video principali

Nota: per questi report è necessario impostare il parametro maxResults su un valore intero non superiore a 200. Prima del 1° gennaio 2013 i dati sono disponibili solo per i primi 10 video. A differenza della maggior parte degli altri report, questi report richiedono anche l'indicazione di un valore per il parametro di richiesta sort.

Video principali 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 subContinente.

Sommario
Dimensioni:
Obbligatorio video
Facoltativo creatorContentType
Metriche:
Usa 1 o più
Filtri:
Utilizza 0 o 1 paese, continente, subcontinente
Opzioni di ordinamento: !

Migliori video per stato (<= 200 risultati)

Questo report elenca i video principali del canale in un determinato stato degli Stati Uniti o nel District of 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:
Usa 1 o più <ph type="x-smartling-void-element"><br></ph> <ph type="x-smartling-void-element"><br></ph>
Filtri:
Obbligatorio province
Facoltativo subscribedStatus
Opzioni di ordinamento: -visualizzazioni
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video principali per gli spettatori iscritti o non iscritti(<= 200 risultati)

Questo report elenca i video principali del canale per gli spettatori iscritti o non iscritti. Il report può essere filtrato per elencare i video principali per paese, continente o subContinente. Il report precedente consente di recuperare i video principali 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:
Usa 1 o più CANNOT TRANSLATE
Filtri:
Facoltativo subscribedStatus
Utilizza 0 o 1 paese, continente, subcontinente
Opzioni di ordinamento: -visualizzazioni
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video principali per prodotto YouTube (<= 200 risultati)

Questo report elenca i video principali del canale e supporta i dettagli di riproduzione e i filtri geografici. Questo report è simile al precedente, ma supporta meno metriche e aggiunge il supporto per il filtro youtubeProduct.

Sommario
Dimensioni:
Obbligatorio video
Facoltativo creatorContentType
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o più subscribedStatus, youtubeProduct
Opzioni di ordinamento: -visualizzazioni
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Primi video con filtri dei dettagli di riproduzione (<= 200 risultati)

Questo report elenca i video principali del canale, filtrando in base a una o tutte le dimensioni dei dettagli della riproduzione: liveOrOnDemand, abbonatoStato 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:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration.
Filtri:
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o più liveOrOnDemand, subscribeedStatus, youtubeProduct
Opzioni di ordinamento: -visualizzazioni
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Report playlist

Statistiche di base

Questo report fornisce statistiche sulle interazioni degli utenti con le playlist di un canale. Puoi filtrare il report in modo da visualizzare solo i dati relativi a una playlist o un paese specifici.

Sommario
Dimensioni:
[Nessuno]
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Basato sul tempo

Questo report fornisce statistiche sulle interazioni degli utenti con le playlist di un canale. Puoi filtrare il report in modo da visualizzare solo i dati relativi a una playlist o un paese specifici.

Sommario
Dimensioni:
Utilizza esattamente 1 giorno, mese
Utilizza 0 o più subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Regione dell'utente

Attività della playlist per paese

Questo report fornisce statistiche sulle interazioni degli utenti con le playlist di un canale. Puoi filtrare il report in modo da visualizzare solo i dati relativi a una playlist, un gruppo di playlist o un paese specifico.

Sommario
Dimensioni:
Obbligatorio country
Utilizza 0 o più subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 continente, subContinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Attività della playlist per provincia

Questo report fornisce statistiche sull'attività delle playlist per gli Stati Uniti e il District of Columbia. Per questo report, includi country==US nel valore del parametro filters.

Sommario
Dimensioni:
Obbligatorio province
Utilizza 0 o più subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1;country==US
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Luoghi di visualizzazione

Questo report fornisce statistiche sul tipo di pagina o applicazione in cui sono state riprodotte le playlist.

Sommario
Dimensioni:
Obbligatorio insightRiproduzioneLocationType
Utilizza 0 o più giorno, subscribeedStatus
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Facoltativo subscribedStatus

Dettaglio della posizione di riproduzione (<= 25 risultati)

Nota: questo report richiede l'impostazione del 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 video player incorporati che hanno generato il maggior numero di visualizzazioni o di tempo di visualizzazione per le playlist di un canale.

Sommario
Dimensioni:
Obbligatorio insightRiproduzioneLocationDetails
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1;insightRiproduzioneLocationType==EMBEDDED
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Facoltativo subscribedStatus
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched
-playlistStarts

Sorgenti di traffico

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

Sommario
Dimensioni:
Obbligatorio Tipo di traffico traffico di informazioni
Utilizza 0 o più giorno, subscribeedStatus
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Facoltativo subscribedStatus

Dettaglio delle sorgenti di traffico (<= 25 risultati)

Nota: questo report richiede l'impostazione del 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 basate sui referrer che hanno generato il maggior numero di visualizzazioni per le playlist del canale. I referrer sono classificati in base al tipo di sorgente di traffico e la definizione della dimensione insightTrafficSourceDetails identifica le sorgenti di traffico per le quali il report è disponibile.

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 il tempo di visualizzazione per le playlist del canale.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceDetails
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1;insightTrafficSourceType
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Facoltativo subscribedStatus
Opzioni di ordinamento: -visualizzazioni
-estimatedMinutesWatched
-playlistStarts

Nota: questo report è supportato solo per sorgenti di traffico specifiche. Ad esempio, la sorgente di traffico NO_LINK_EMBEDDED non ha dettagli aggiuntivi e, pertanto, non supporta questo report. Consulta la definizione di insightTrafficSourceType per i dettagli sulle sorgenti di traffico che supportano questo report.

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 contenuti della playlist. 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ù giorno, subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più operatingSystem, 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 della playlist che si sono verificate sui dispositivi Android o sulle PlayStation.

Sommario
Dimensioni:
Obbligatorio sistemaoperativo
Utilizza 0 o più giorno, subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più deviceType, 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 della playlist che si sono verificate sui tablet Android o sui dispositivi desktop Windows.

Sommario
Dimensioni:
Obbligatorio deviceType, operatingSystem
Utilizza 0 o più giorno, subscribedStatus, youtubeProduct
Metriche:
Usa 1 o più visualizzazioni, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Utilizza 0 o più subscribedStatus, youtubeProduct

Dati demografici degli spettatori

Sommario
Dimensioni:
Usa 1 o più ageGroup, genere
Utilizza 0 o più subscribedStatus
Metriche:
Obbligatorio viewerPercentage
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o 1 playlist, gruppo
Facoltativo subscribedStatus
Nota: i valori viewerPercentage in questo report non vengono normalizzati per valori o combinazioni di valori diversi per le dimensioni dei dettagli della riproduzione (subscribedStatus e youtubeProduct).

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

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

Playlist principali

Nota: per questi report è necessario impostare il parametro maxResults su un valore intero non superiore a 200. Prima del 1° gennaio 2013 i dati sono disponibili solo per le prime 10 playlist. A differenza della maggior parte degli altri report, questi report richiedono anche l'indicazione di un valore per il parametro di richiesta sort.

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

Sommario
Dimensioni:
Obbligatorio playlist
Metriche:
Usa 1 o più visualizzazioni, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart e averageTimeInPlaylist
Filtri:
Obbligatorio isCurated==1
Utilizza 0 o 1 paese, provincia, continente, sottocontinente
Utilizza 0 o più playlist, subscribedStatus, youtubeProduct
Opzioni di ordinamento: -visualizzazioni
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Report sul rendimento degli annunci

Nota: i report sul rendimento degli annunci richiedono un token di autorizzazione che concede 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 che sono stati pubblicati durante le riproduzioni di 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 le seguenti:

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 in base al tipo

Sommario
Dimensioni:
Obbligatorio Tipo di annuncio
Facoltativo giorno
Metriche:
Usa 1 o più lordeEntrate, impressioni relative all'annuncio, cpm
Filtri:
Utilizza 0 o 1 video, gruppo
Utilizza 0 o 1 paese, continente, subcontinente