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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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à.
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
Metriche: |
|
Filtri: |
|
Dettagli della riproduzione con dimensione temporale facoltativa e metrica averageViewPercentage
Questo report fornisce statistiche dettagliate sulla riproduzione per intervalli di tempo specifici.
Sommario |
Dimensioni: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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
.
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: |
|
Metriche: |
|
Filtri: |
|
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.
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
Dati demografici degli spettatori
Questo report aggrega le statistiche di visualizzazione in base al gruppo di età e al genere degli spettatori.
Sommario |
Dimensioni: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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: |
|
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.
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.
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
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: |
|
Metriche: |
Utilizza uno o più |
engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtri: |
|
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: |
|
Metriche: |
Utilizza uno o più |
engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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.
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: |
|
Metriche: |
Utilizza uno o più |
engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtri: |
|
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: |
|
Metriche: |
Utilizza uno o più |
engagedViews, visualizzazioni, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
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: |
|
Metriche: |
|
Filtri: |
|
Dati demografici degli spettatori
Questo report aggrega le statistiche di visualizzazione in base al gruppo di età e al genere degli spettatori.
Sommario |
Dimensioni: |
|
Metriche: |
|
Filtri: |
|
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.
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.
Sommario |
Dimensioni: |
|
Metriche: |
|
Filtri: |
|