YouTube Analytics API: Content Owner Reports

Nota:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

Questa pagina elenca i report che i proprietari dei contenuti possono recuperare con l'API YouTube Analytics. I report dei proprietari dei contenuti contengono metriche per i canali collegati a un proprietario dei contenuti YouTube specificato. Le metriche sono misurazioni individuali dell'attività degli utenti, del rendimento degli annunci o delle entrate stimate.

  • I report sui video contengono metriche sull'attività utente, sul rendimento degli annunci e sulle entrate stimate per i video sui canali di un proprietario dei contenuti.

  • I report sulle playlist forniscono statistiche specificamente correlate alle visualizzazioni dei video che si verificano nel contesto di una playlist. I report sulle playlist utilizzano molte delle stesse dimensioni e degli stessi filtri dei report sui video.

  • 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 del proprietario dei contenuti, chiama il metodo reports.query dell'API e imposta il valore del parametro ids nella richiesta API su contentOwner==OWNER_NAME, dove OWNER_NAME specifica l'ID del proprietario dei contenuti. Chiedi al tuo Partner Manager se non hai la certezza del valore.

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 contrassegnate con un asterisco (*) richiedono un token di autorizzazione che conceda l'accesso all'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Filtri

Tutte le richieste API per recuperare i report dei proprietari dei contenuti devono filtrare i dati utilizzando la dimensione video, la dimensione channel o una combinazione supportata delle dimensioni claimedStatus e uploaderType. Le combinazioni supportate sono elencate nella definizione della dimensione uploaderType.

Le tabelle che spiegano i report supportati identificano i filtri che possono essere utilizzati per un determinato report. Nelle descrizioni, i filtri mostrati tra parentesi sono facoltativi. Ad esempio, se un report elenca video(,country) come opzione di filtro, il report può essere filtrato in modo da includere solo i dati relativi a un video specifico o solo i dati relativi a un video specifico in un paese specifico.

L'API supporta anche la possibilità di specificare più valori per i filtri video, playlist e channel. 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.
Importante:tutte le richieste API per recuperare i report sui video dei proprietari dei contenuti devono filtrare i dati utilizzando la dimensione video, la dimensione canale, la dimensione gruppo o una combinazione supportata delle dimensioni claimedStatus e uploaderType. Alcuni report non supportano tutte queste opzioni. Le combinazioni supportate, che sono elencate anche nella definizione della dimensione uploaderType, sono:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

Report video

Statistiche di base

Statistiche di base (incluso il numero di iscritti)

Questo report fornisce statistiche relative alle azioni degli utenti su tutti i canali di un proprietario dei contenuti. Puoi filtrare il report in modo che restituisca solo i dati relativi a un video o un paese specifico. Può essere utilizzato anche per recuperare solo le statistiche relative ai contenuti rivendicati, inclusi quelli caricati dal proprietario dei contenuti, da terze parti o da entrambi.

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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent

Statistiche di base 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:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio province

Basato sul tempo

Attività per periodi di tempo

Questo report fornisce statistiche relative alle azioni degli utenti su tutti i canali di un proprietario dei contenuti 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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent

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

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:
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:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio province

Regione degli utenti

Attività utente per paese

Questo report fornisce statistiche relative all'attività degli utenti paese per paese per tutti i canali di un proprietario dei contenuti. Puoi filtrare il report in modo che restituisca solo i dati di un video o un canale 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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 continent, subContinent

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:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio country==US

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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
Opzioni di ordinamento: -engagedViews
-views
-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?

Tecnicamente, le dimensioni dei dettagli di riproduzione supportate da questi report sono tutte facoltative. Se non includi le dimensioni dei dettagli di riproduzione nella richiesta, il report restituito sarà simile a uno dei report statistiche di base, basati sul tempo o geografia degli utenti.

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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent
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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio province
Facoltativo 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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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.

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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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:
Facoltativo country
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 continent, subContinent
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:
Facoltativo country
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 continent, subContinent
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:
Facoltativo province
Utilizza 0 o più creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio country==US
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:
Facoltativo province
Utilizza 0 o più creatorContentType, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio country==US
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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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 video player incorporati che hanno generato il maggior numero di visualizzazioni o il maggior tempo di visualizzazione per i contenuti di un proprietario. Quando recuperi questo report, devi impostare il filtro insightPlaybackLocationType su EMBEDDED.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationDetail
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio insightPlaybackLocationType==EMBEDDED
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Opzioni di ordinamento: -engagedViews
-views
-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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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 sulle visualizzazioni in base ai referrer che hanno generato il maggior numero di visualizzazioni per i contenuti del proprietario. 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 proprietario.

Sommario
Dimensioni:
Obbligatorio insightTrafficSourceDetail
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio insightTrafficSourceType (vedi la nota sotto la tabella)
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Opzioni di ordinamento: -engagedViews
-views
-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 tipo di dispositivo utilizzato dagli spettatori per guardare i tuoi contenuti. Ad esempio, identifica il numero di visualizzazioni avvenute su tablet o console di gioco.

Sommario
Dimensioni:
Obbligatorio deviceType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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 operatingSystem,deviceType
Utilizza 0 o più creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
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 esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più liveOrOnDemand, subscribedStatus
Nota:i valori di viewerPercentage in questo report non sono normalizzati per i diversi valori della dimensione dei dettagli di riproduzione subscribedStatus.

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

Puoi utilizzare i filtri per assicurarti che il report contenga solo i dati viewerPercentage per un valore della dimensione subscribedStatus.

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
Facoltativo creatorContentType, subscribedStatus
Metriche:
Utilizza uno o più azioni
Filtri:
Utilizza esattamente 1 video, canale, gruppo o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent
Facoltativo subscribedStatus

Fidelizzazione del pubblico

Questo report misura la capacità di un video di fidelizzare 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 mostrano il livello di fidelizzazione del pubblico del video. Il primo è un valore assoluto, mentre il secondo mostra il rendimento del video rispetto ad altri video di YouTube di durata simile.

Nota:i report 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:
Utilizza uno o più audienceWatchRatio, relativeRetentionPerformance
Filtri:
Obbligatorio (video)
Utilizza 0 o più audienceType, subscribedStatus, youtubeProduct

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.

I video più popolari in generale, per paese, per continente o per subcontinente (<= 200 risultati)

Questo report elenca i video principali del proprietario dei contenuti in base ai criteri di filtro e ordinamento specificati.

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 esattamente 1 channel o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent
Opzioni di ordinamento: -engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Video più visti in assoluto per stato degli Stati Uniti (<= 200 risultati)

Questo report elenca i video più popolari del proprietario dei contenuti 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:
Utilizza esattamente 1 channel o una combinazione supportata di uploaderType e claimedStatus
Obbligatorio province
Opzioni di ordinamento: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

Questo report elenca i video principali 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:
Utilizza esattamente 1 channel o una combinazione supportata di uploaderType e claimedStatus
Facoltativo subscribedStatus
Utilizza 0 o 1 country, continent, subContinent
Opzioni di ordinamento: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

Questo report elenca i video più popolari 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 esattamente 1 channel o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più subscribedStatus, youtubeProduct
Opzioni di ordinamento: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

Questo report elenca i video più popolari del proprietario dei contenuti, filtrati in base a una o più dimensioni dei dettagli di riproduzione: liveOrOnDemand, subscribedStatus e youtubeProduct. Il report supporta anche il filtro per regione.

Sommario
Dimensioni:
Obbligatorio (video)
Facoltativo creatorContentType
Metriche:
Utilizza uno o più engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtri:
Utilizza esattamente 1 channel o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, province, continent, subContinent
Utilizza 0 o più liveOrOnDemand, subscribedStatus, youtubeProduct
Opzioni di ordinamento: -engagedViews
-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 sui canali di un proprietario dei contenuti. Il report non ha dimensioni obbligatorie.

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

Basato sul tempo

Questo report fornisce statistiche relative alle interazioni degli utenti con i video nelle playlist dei canali di un proprietario dei contenuti in intervalli di tempo specifici. Puoi filtrare il report in modo che restituisca solo i dati di una playlist o di un canale specifici.

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 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

Regione degli utenti

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

Questo report fornisce statistiche sulle playlist per paese.

Sommario
Dimensioni:
Obbligatorio country
Metriche:
Utilizza uno o più engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filtri:
Utilizza 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Utilizza 0 o 1 continent, subContinent
Facoltativo channel

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, includi country==US nel valore del parametro filters.

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

Luoghi di visualizzazione

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

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

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 video player incorporati che hanno generato il maggior numero di visualizzazioni o il maggior tempo di visualizzazione per le playlist di un proprietario dei contenuti.

Sommario
Dimensioni:
Obbligatorio insightPlaybackLocationDetail
Metriche:
Utilizza uno o più engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtri:
Obbligatorio insightPlaybackLocationType==EMBEDDED
Utilizza 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel
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 derivanti da una ricerca Google o da una pagina del canale.

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

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 le playlist del proprietario dei contenuti. 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 proprietario dei contenuti.

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel
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 per le playlist

Questo report aggrega le statistiche di visualizzazione in base al tipo di dispositivo utilizzato dagli spettatori per guardare i contenuti della tua 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 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

Sistema operativo per le playlist

Questo report aggrega le statistiche di visualizzazione in base ai sistemi operativi degli spettatori. Ad esempio, identifica il numero di visualizzazioni di playlist avvenute 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 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

Sistema operativo e tipo di dispositivo per le playlist

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 di playlist avvenute su tablet Android o su computer Windows.

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

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel

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
Metriche:
Obbligatorio viewerPercentage
Filtri:
Utilizza 0 o 1* playlist, gruppo

Nota:se nel report viene richiesta una delle metriche visualizzazioni, estimatedMinutesWatched o averageViewDuration, deve essere specificato esattamente uno di questi filtri.
Facoltativo channel
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 e 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.

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 proprietario dei contenuti 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 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 esattamente 1 video, group o una combinazione supportata di uploaderType e claimedStatus
Utilizza 0 o 1 country, continent, subContinent