Richieste API di esempio

Report video

Metriche giornaliere sul tempo di visualizzazione dei video di un canale

Questa query recupera il numero di visualizzazioni giornaliere, le metriche sul tempo di visualizzazione e il numero di nuovi iscritti per i video di un canale. Il report restituisce una riga di dati per ogni giorno nell'intervallo di date richiesto. Le righe sono ordinate in ordine cronologico.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Le metriche relative alle annotazioni giornaliere per i video di un canale

Questa richiesta recupera il numero di visualizzazioni giornaliere, le percentuali di clic e di chiusura delle annotazioni e le impressioni delle annotazioni per i contenuti del canale. I risultati sono ordinati in ordine cronologico.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Report sulle playlist

Visualizzazioni giornaliere delle playlist per un canale

Questa richiesta recupera i conteggi giornalieri delle visualizzazioni (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist), le iniziali delle playlist, i minuti guardati stimati e le visualizzazioni per inizio della playlist per il canale dell'utente autenticato. I risultati sono ordinati in ordine cronologico.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Report video

Metriche sul tempo di visualizzazione specifiche per paese per i video di un canale

Questa query recupera il numero di visualizzazioni, le metriche relative al tempo di visualizzazione e i dati sulle iscrizioni specifici per il paese per i video di un canale. Il report restituisce una riga di dati per ogni paese in cui sono stati guardati i video del canale. Le righe sono ordinate in ordine decrescente in base al numero di minuti guardati.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Metriche di annotazione specifiche per paese per i video di un canale

Questa richiesta recupera il numero di visualizzazioni, le percentuali di clic e di chiusura delle annotazioni e le impressioni delle annotazioni per i video del canale in base al paese. I risultati sono ordinati in base alla percentuale di clic sulle annotazioni in ordine decrescente, il che significa che il paese con la percentuale di clic sulle annotazioni più alta verrà elencato per primo.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Metriche specifiche per le province per gli stati degli Stati Uniti e Washington D.C.

Questa richiesta recupera un'analisi provincia per provincia relativa al numero di visualizzazioni, alla stima dei minuti guardati e alla durata di visualizzazione media dei video del canale. I dati riguardano gli stati degli Stati Uniti e Washington DC. I risultati sono ordinati in ordine alfabetico in base ai codici ISO 3166-2 delle province.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10: i video più guardati in un paese specifico

Questa query recupera i 10 video più visti del canale, misurati in base al numero di visualizzazioni durante l'intervallo di date specificato, in un paese specifico. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

Nota: questo report richiede di specificare un valore per il parametro di richiesta sort e di impostare il parametro maxResults su un valore intero pari o inferiore a 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Le 10 città più importanti degli Stati Uniti per visualizzazioni totali

Questa query restituisce un elenco delle 10 città degli Stati Uniti che hanno generato il maggior numero di visualizzazioni dei contenuti del canale durante l'intervallo di date specificato. La query potrebbe essere modificata per richiedere i dati di un altro paese scegliendo un altro valore valido per il filtro. Analogamente, la query potrebbe essere modificata per recuperare i dati relativi a un subcontinente, ad esempio l'Europa occidentale o il Sud-est asiatico, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Le prime 10 città degli Stati Uniti per visualizzazioni totali per ciascun tipo di contenuti

Questa query restituisce un elenco delle 10 città degli Stati Uniti che hanno generato il maggior numero di visualizzazioni dei contenuti del canale durante l'intervallo di date specificato per ogni creatorContentType supportato. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Le 10 città più importanti degli Stati Uniti per tempo di visualizzazione totale

Questa query restituisce un elenco dei 10 giorni migliori nell'intervallo di date specificato in cui una città degli Stati Uniti ha registrato il tempo di visualizzazione giornaliero totale più elevato per i contenuti del canale. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si è verificato e la città in cui si stima che i contenuti siano stati visualizzati. I risultati sono ordinati in ordine decrescente in base al tempo di visualizzazione totale.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10: i video più visti in Europa

Questa query recupera i 10 video più visti del canale in Europa, misurati in base al numero di visualizzazioni durante l'intervallo di date specificato. La query potrebbe essere modificata per richiedere i dati di un altro continente scegliendo un altro valore valido per il filtro. Analogamente, la query potrebbe essere modificata per recuperare i dati relativi a un subcontinente, come l'Europa occidentale o l'Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

Nota: questo report richiede di specificare un valore per il parametro di richiesta sort e di impostare il parametro maxResults su un valore intero pari o inferiore a 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Report sulle playlist

Metriche sul tempo di visualizzazione specifiche per paese per le playlist di un canale

Questa query recupera il numero di visualizzazioni per paese (metrica video aggregata), le visualizzazioni delle playlist (metrica all'interno della playlist) e le metriche sul tempo di visualizzazione per le playlist di un canale. Il report restituisce una riga di dati per ogni paese in cui sono state guardate le playlist del canale. Le righe sono ordinate in ordine decrescente in base al numero di minuti guardati.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10: le playlist più avviate negli Stati Uniti

Questa query recupera le 10 playlist che gli spettatori negli Stati Uniti hanno iniziato a guardare più spesso durante l'intervallo di date specificato. I risultati sono ordinati in ordine decrescente in base al numero di avviamenti della playlist.

Nota: poiché questo report utilizza la dimensione playlist, devi specificare un valore per il parametro di richiesta sort e impostare il parametro maxResults su un valore intero pari o inferiore a 10.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Report video

Visualizzazioni e tempo di visualizzazione da località di riproduzione diverse

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per i video di un determinato canale. I risultati vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video e sono ordinati in ordine decrescente in base al numero di visualizzazioni.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Numero di visualizzazioni giornaliere e tempo di visualizzazione da località di riproduzione diverse

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato negli Stati Uniti per i video di un determinato canale. I risultati vengono raggruppati per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per un determinato video o gruppo di video. I risultati vengono raggruppati in base al sito di terze parti in cui è stato incorporato il video. I risultati vengono ordinati in ordine decrescente in base al numero di visualizzazioni. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di uno o più ID video per i video caricati.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Report sulle playlist

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist da località di riproduzione diverse

Questa query recupera il numero di visualizzazioni (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist), il tempo di visualizzazione stimato e le iniziali delle playlist per le playlist di un determinato canale. I risultati vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video e sono ordinati in ordine decrescente in base all'inizio delle playlist.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da località di riproduzione diverse

Questa query recupera le avviamenti giornalieri delle playlist, i conteggi delle visualizzazioni (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist) e il tempo di visualizzazione stimato negli Stati Uniti per le playlist di un determinato canale. I risultati vengono raggruppati per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Report video

Mi piace e Non mi piace per tipo di contenuti

Questa query recupera il numero di Mi piace e Non mi piace per ogni tipo di contenuto su un canale.

dimensions=creatorContentType
metrics=likes,dislikes

Report video

Numero di visualizzazioni e tempo di visualizzazione da diverse sorgenti di traffico in un paese

Questa richiesta recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del canale in un paese specifico. Le metriche vengono aggregate in base alla sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto il video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Numero di visualizzazioni giornaliere e tempo di visualizzazione provenienti da diverse sorgenti di traffico

Questa richiesta recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato giornaliero per i video del canale. Le metriche vengono aggregate su base giornaliera per sorgente di traffico e ordinate in ordine cronologico.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10: i termini di ricerca di YouTube che generano più traffico per un video

Questa query recupera i 10 termini di ricerca che hanno generato il maggior numero di visualizzazioni dai risultati di ricerca di YouTube per uno o più video specifici. I risultati vengono ordinati per numero di visualizzazioni in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID video.

Ad esempio, puoi eseguire la query per un singolo video o sostituire VIDEO_ID per identificare i termini di ricerca che generano più traffico per quel video. Puoi anche elencare tutti i video di una determinata playlist per determinare quali termini di ricerca generano più traffico per uno qualsiasi dei video contenuti nella playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10: siti web esterni che generano il maggior volume di traffico per un video

Questa query recupera i 10 siti web esterni che hanno generato il maggior numero di visualizzazioni per un video o un gruppo di video specifico. I risultati sono ordinati in base al tempo di visualizzazione stimato in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID video per i video caricati.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Report sulle playlist

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist provenienti da diverse sorgenti di traffico in un paese

Questa richiesta recupera il numero di visualizzazioni (una metrica video aggregata), le visualizzazioni della playlist (una metrica in-playlist), gli avvii delle playlist e il tempo di visualizzazione stimato per le visualizzazioni delle playlist in un paese specificato. Le metriche vengono aggregate in base alla sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Conteggi giornalieri delle visualizzazioni delle playlist e tempo di visualizzazione provenienti da diverse sorgenti di traffico

Questa richiesta recupera le visualizzazioni giornaliere delle playlist di un canale (una metrica in-playlist), gli avviamenti delle playlist e il tempo di visualizzazione stimato. Recupera inoltre le visualizzazioni totali (una metrica video aggregata). Le metriche vengono aggregate su base giornaliera per sorgente di traffico e ordinate in ordine cronologico.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Report video

Metriche giornaliere relative al tipo di dispositivo per il sistema operativo Android

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato sui dispositivi Android per i video di un determinato canale. I risultati sono raggruppati per giorno per ogni tipo di dispositivo su cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Metriche giornaliere del sistema operativo per i dispositivi mobili

Questa query recupera il conteggio giornaliero delle visualizzazioni e il tempo di visualizzazione stimato sui dispositivi mobili per i video di un determinato canale. I risultati sono raggruppati per giorno per ciascun sistema operativo su cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Metriche giornaliere relative al sistema operativo e al tipo di dispositivo

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato per un canale. Le statistiche sono raggruppate per sistema operativo e tipo di dispositivo. I risultati sono ordinati in ordine cronologico.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Report sulle playlist

Statistiche giornaliere relative al tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android

Questa query recupera le visualizzazioni giornaliere (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist) e il tempo di visualizzazione stimato sui dispositivi Android per le playlist di un determinato canale. I risultati vengono raggruppati per giorno per ciascun tipo di dispositivo su cui si sono verificate visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Metriche giornaliere del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili

Questa query recupera le visualizzazioni giornaliere (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist) e il tempo di visualizzazione stimato sui dispositivi mobili per le playlist di un determinato canale. I risultati vengono agrupati per giorno per ciascun sistema operativo su cui si sono verificate le visualizzazioni delle playlist. I risultati sono ordinati in ordine cronologico.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Report video

Dati demografici degli spettatori in California (fascia d'età e genere)

Questo report recupera le statistiche relative alla fascia d'età e al genere degli spettatori in California che hanno guardato i video del canale. I risultati sono ordinati per genere e poi per fascia d'età. Questa query può essere modificata per recuperare le stesse statistiche per tutti gli spettatori di tutto il mondo o di un paese, un continente, un subcontinente o un altro stato degli Stati Uniti modificando il valore del parametro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Report sulle playlist

Dati demografici degli spettatori delle playlist in California (fascia d'età e genere)

Questo report recupera le statistiche relative alla fascia d'età e al genere degli spettatori in California che hanno guardato le playlist del canale. I risultati sono ordinati per genere e poi per fascia d'età. Questa query può essere modificata per recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o per tutti i visualizzatori in un paese, un continente, un subcontinente o un altro stato degli Stati Uniti regolando il valore del parametro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Metriche sulla condivisione, aggregate per servizio in cui i video sono stati condivisi

Questa richiesta recupera il numero di volte in cui gli utenti hanno utilizzato il pulsante Share per condividere i video di un canale. I risultati vengono aggregati per servizio di condivisione (Google+, Twitter e così via) e ordinati in ordine decrescente in base al numero di condivisioni.

dimensions=sharingService
metrics=shares
sort=-shares

Metriche sulla fidelizzazione del pubblico per un video

Questo report misura la capacità di un video di fidelizzare il pubblico. Il report può essere recuperato solo per un singolo video alla volta. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con l'ID di uno dei video che hai caricato. Tieni presente che i report sulla fidelizzazione del pubblico non supportano la possibilità di specificare più valori per il filtro video.

In questo esempio, il report utilizza il filtro audienceType per limitare la risposta in modo che contenga solo i dati relativi alle visualizzazioni organiche, che sono il risultato di un'azione diretta dell'utente, ad esempio la ricerca di un video o un clic su un video consigliato. Di conseguenza, il report non include i dati relativi alle visualizzazioni generate dagli annunci TrueView in-stream o in-display. Puoi rimuovere il filtro per recuperare i dati sulla fidelizzazione del pubblico del video da tutti i tipi di pubblico.

Tieni presente che i dati per il filtro audienceType sono disponibili a partire dal 25 settembre 2013. L'API non restituirà dati per le query che utilizzano il filtro per tentare di recuperare i dati di date precedenti. Le query che non utilizzano il filtro funzionano per qualsiasi data successiva al 1° luglio 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Metriche relative alle entrate del canale e al rendimento degli annunci

Questa richiesta recupera le metriche sul rendimento degli annunci e sulle entrate di un canale. Il report restituisce una singola riga di dati contenente i totali per ogni metrica richiesta nell'intervallo di date specificato.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Metriche giornaliere relative alle entrate e al rendimento degli annunci

Questa richiesta recupera le metriche giornaliere sul rendimento degli annunci e sulle entrate di un canale.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Metriche specifiche per paese sulle entrate e sul rendimento degli annunci

Questa richiesta recupera le metriche sul rendimento degli annunci e sulle entrate specifiche per paese di un canale. I risultati sono ordinati in ordine decrescente in base all'importo delle entrate, il che significa che il primo paese elencato sarà quello in cui il partner ha registrato le entrate nette più elevate.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10: video con le entrate più alte

Questa richiesta recupera le metriche relative a entrate e rendimento degli annunci per i 10 video del canale con le entrate maggiori. I risultati sono ordinati in ordine decrescente in base all'importo delle entrate, il che significa che il primo video sarà quello con le entrate stimate più elevate.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Metriche sul rendimento degli annunci per diversi tipi di annunci

Questa richiesta recupera le metriche sul rendimento degli annunci per i contenuti rivendicati dal proprietario. I risultati sono raggruppati per tipo di annuncio, il che ti consente di confrontare i valori di entrate e CPM tra diversi tipi di annunci.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Report video

Metriche giornaliere sul tempo di visualizzazione per i contenuti caricati dall'utente

Questa query recupera le metriche giornaliere sul tempo di visualizzazione, nonché il numero di visualizzazioni, il numero di riproduzioni monetizzate e il numero di impressioni per i video caricati dal proprietario dei contenuti. Il report restituisce una riga di dati per ogni giorno nell'intervallo di date richiesto e le righe sono ordinate in ordine cronologico.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Metriche di annotazione per i contenuti rivendicati

Questa richiesta recupera il numero di visualizzazioni giornaliere, le percentuali di clic delle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i contenuti rivendicati dal proprietario. I risultati sono ordinati in ordine cronologico.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Report sulle playlist

Visualizzazioni giornaliere delle playlist per un proprietario dei contenuti

Questa richiesta recupera le metriche relative alle interazioni giornaliere degli utenti con i video nelle playlist del proprietario dei contenuti. Le metriche recuperate nel report sono playlistViews, playlistStarts, playlistEstimatedMinutesWatched e viewsPerPlaylistStart. Tutte queste metriche sono metriche all'interno della playlist. Poiché tutte le metriche richieste sono metriche in-playlist, nella richiesta non è necessario includere anche il filtro playlist o gruppo.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Report video

Metriche sul tempo di visualizzazione specifiche per paese per i contenuti caricati dall'utente

Questa query recupera il numero di visualizzazioni, le metriche relative al tempo di visualizzazione e le entrate pubblicitarie stimate per ogni paese. Le metriche si riferiscono ai video caricati dal proprietario dei contenuti. Il report restituisce una riga di dati per ogni paese in cui i video sono stati guardati e le righe sono ordinate in ordine decrescente in base al numero di minuti guardati.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Metriche di annotazione specifiche per paese per i contenuti caricati dall'utente

Questa richiesta recupera i conteggi delle visualizzazioni, le percentuali di clic, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni specifiche del paese per i video caricati dal proprietario dei contenuti. I risultati sono ordinati in base alla percentuale di clic sulle annotazioni in ordine decrescente, il che significa che il paese con la percentuale di clic sulle annotazioni più alta verrà elencato per primo.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Metriche specifiche per le province degli Stati Uniti e per Washington D.C.

Questa richiesta recupera una suddivisione per provincia del numero di visualizzazioni, dei minuti di visualizzazione stimati e della durata di visualizzazione media dei video rivendicati dal proprietario dei contenuti. I dati riguardano gli stati degli Stati Uniti e Washington DC. I risultati sono ordinati in ordine alfabetico in base ai codici ISO 3166-2 delle province.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Prime 10 città degli Stati Uniti per visualizzazioni totali

Questa query restituisce un elenco delle 10 città degli Stati Uniti che hanno generato il maggior numero di visualizzazioni dei video rivendicati dal proprietario dei contenuti durante l'intervallo di date specificato. La query potrebbe essere modificata per richiedere i dati per un altro paese scegliendo un altro valore valido per il filtro in questione. Analogamente, la query potrebbe essere modificata per recuperare i dati relativi a un subcontinente, ad esempio l'Europa occidentale o il Sud-est asiatico, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Le 10 città più importanti degli Stati Uniti per visualizzazioni totali per ogni tipo di contenuto

Questa query restituisce un elenco delle 10 città degli Stati Uniti che hanno registrato il maggior numero di visualizzazioni dei contenuti rivendicati dal proprietario durante l'intervallo di date specificato per ogni creatorContentType supportato. I risultati vengono ordinati per numero di visualizzazioni in ordine decrescente.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Le 10 città più importanti degli Stati Uniti per tempo di visualizzazione totale

Questa query restituisce un elenco dei 10 giorni migliori nell'intervallo di date specificato in cui una città degli Stati Uniti ha registrato il tempo di visualizzazione giornaliero totale più elevato per i contenuti rivendicati dal proprietario. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si è verificato e la città in cui si stima che i contenuti siano stati visualizzati. I risultati sono ordinati in ordine decrescente in base al tempo di visualizzazione totale.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10: i video più visti in Europa

Questa query recupera i 10 video più guardati in Europa, tra i video rivendicati dal proprietario dei contenuti, in base al numero di visualizzazioni durante l'intervallo di date specificato. La query potrebbe essere modificata per richiedere i dati di un altro continente scegliendo un altro valore valido per il filtro. Analogamente, la query potrebbe essere modificata per recuperare i dati relativi a un subcontinente, ad esempio l'Europa occidentale o il Sud-est asiatico, utilizzando il filtro subContinent e uno dei suoi valori validi. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Report sulle playlist

Metriche sul tempo di visualizzazione specifiche per paese per le playlist di un proprietario di contenuti

Questa query recupera il numero di visualizzazioni e le metriche relative al tempo di visualizzazione delle playlist per ciascun paese per tutte le playlist dei canali del proprietario dei contenuti. Il report restituisce una riga di dati per ogni paese in cui sono state guardate le playlist. Le righe sono ordinate in ordine decrescente in base al numero di minuti guardati.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10: le playlist più avviate negli Stati Uniti

Questa query recupera le 10 playlist dei canali del proprietario dei contenuti che gli spettatori negli Stati Uniti hanno iniziato a guardare più di frequente durante l'intervallo di date specificato. I risultati sono ordinati in ordine decrescente in base al numero di avviamenti della playlist.

Nota: poiché questo report utilizza la dimensione playlist, devi specificare un valore per il parametro di richiesta sort e impostare anche il parametro maxResults su un valore intero pari o inferiore a 10.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Report video

Mi piace e Non mi piace per tipo di contenuti

Questa query recupera il numero di Mi piace e Non mi piace per ogni tipo di contenuti su un determinato canale o gruppo di canali. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Report video

Visualizzazioni e tempo di visualizzazione da località di riproduzione diverse

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato dei video caricati su un determinato canale o gruppo di canali. I risultati vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video e sono ordinati in ordine decrescente in base al numero di visualizzazioni. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Numero di visualizzazioni giornaliere e tempo di visualizzazione da località di riproduzione diverse

Questa query recupera il conteggio giornaliero delle visualizzazioni e il tempo di visualizzazione stimato negli Stati Uniti per i video caricati su un determinato canale o gruppo di canali. I risultati vengono raggruppati per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico inverso. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per un determinato video o gruppo di video. I risultati vengono raggruppati in base al sito di terze parti in cui è stato incorporato il video. I risultati vengono ordinati in ordine decrescente in base al numero di visualizzazioni. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID video per i video caricati.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Report sulle playlist

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist da località di riproduzione diverse

Questa query recupera il numero di visualizzazioni di playlist, il tempo di visualizzazione stimato della playlist e gli avvii delle playlist per tutte le playlist nei canali di un proprietario dei contenuti. I risultati vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video e sono ordinati in ordine decrescente in base all'inizio della playlist.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist da località di riproduzione diverse

Questa query recupera le visualizzazioni giornaliere delle playlist, il numero di visualizzazioni delle playlist e il tempo di visualizzazione stimato delle playlist negli Stati Uniti per tutte le playlist dei canali di un proprietario di contenuti. I risultati vengono restituiti per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni delle playlist.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Report video

Visualizzazioni e tempo di visualizzazione provenienti da diverse sorgenti di traffico

Questa richiesta recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del proprietario dei contenuti. Le metriche vengono aggregate in base alla sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto il video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Numero di visualizzazioni giornaliere e tempo di visualizzazione provenienti da diverse sorgenti di traffico

Questa richiesta recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione giornaliero stimato per i video del proprietario dei contenuti. Le metriche vengono aggregate su base giornaliera in base alla sorgente di traffico e ordinate in ordine cronologico inverso.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Nota: i due report di esempio che seguono sono supportati solo per sorgenti di traffico specifiche. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED sono alcune delle sorgenti di traffico non supportate.

Top 10: termini di ricerca di YouTube che generano il maggior volume di traffico per un video

Questa query recupera i 10 termini di ricerca che hanno generato il maggior numero di visualizzazioni dai risultati di ricerca di YouTube per un video o un gruppo di video specifico. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID video per i video caricati.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10: siti web esterni che generano il maggior volume di traffico per un video

Questa query recupera i 10 siti web esterni che hanno generato il maggior numero di visualizzazioni dai risultati di ricerca di Google per un video o un gruppo di video specifico. I risultati vengono ordinati in base al tempo di visualizzazione stimato in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID video per i video caricati.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Report sulle playlist

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist provenienti da diverse sorgenti di traffico in un paese

Questa richiesta recupera il numero di visualizzazioni della playlist, gli avvii della playlist e il tempo di visualizzazione stimato della playlist per le visualizzazioni della playlist in un paese specificato. Le metriche vengono aggregate in base alla sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist provenienti da diverse sorgenti di traffico

Questa richiesta recupera le visualizzazioni, le avviamenti e il tempo di visualizzazione stimato delle playlist per le playlist presenti in uno o più canali di un proprietario di contenuti. Le metriche vengono aggregate per sorgente di traffico. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Report video

Metriche giornaliere relative al tipo di dispositivo per i video rivendicati

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato per tipo di dispositivo per i video rivendicati da un determinato proprietario dei contenuti. I risultati sono raggruppati per giorno per ogni tipo di dispositivo su cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Metriche giornaliere relative al sistema operativo per i video rivendicati guardati su dispositivi mobili

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato per sistema operativo per le visualizzazioni dei video rivendicati da un proprietario dei contenuti specificato che si sono verificate su dispositivi mobili. I risultati vengono raggruppati per giorno per ogni sistema operativo in cui si sono verificate le riproduzioni dei video. I risultati sono ordinati in ordine cronologico.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Metriche giornaliere relative al sistema operativo e al tipo di dispositivo

Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato per i video rivendicati da un determinato proprietario dei contenuti. Le statistiche sono raggruppate per sistema operativo e tipo di dispositivo. I risultati sono ordinati in ordine cronologico.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Report sulle playlist

Metriche relative al tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato delle playlist sui dispositivi Android per le playlist presenti in uno o più canali di un proprietario di contenuti. I risultati vengono restituiti per ogni tipo di dispositivo su cui si sono verificate le visualizzazioni della playlist. Tieni presente che per eseguire questa query in APIs Explorer, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Metriche relative al sistema operativo per le visualizzazioni di playlist sui dispositivi mobili

Questa query recupera il numero di visualizzazioni e il tempo di visualizzazione stimato delle playlist sui dispositivi mobili per le playlist di uno qualsiasi dei canali di un proprietario di contenuti. I risultati vengono restituiti per ogni sistema operativo su cui si sono verificate le visualizzazioni della playlist.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Report video

Dati demografici degli spettatori in California (età e genere)

Questo report recupera le statistiche relative alla fascia d'età e al genere degli spettatori in California che hanno guardato i contenuti rivendicati dal proprietario. I risultati vengono ordinati per genere e poi per fascia d'età. Questa query può essere modificata per recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o per tutti i visualizzatori in un paese, un continente, un subcontinente o un altro stato degli Stati Uniti modificando il valore parametro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Metriche sulla condivisione, aggregate per servizio in cui i video sono stati condivisi

Questa richiesta recupera il numero di volte in cui gli utenti hanno utilizzato il pulsante Share per condividere i video caricati dal proprietario dei contenuti. I risultati vengono aggregati per servizio di condivisione (Google+, Twitter e così via) e ordinati in ordine decrescente in base al numero di condivisioni.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Metriche sulla fidelizzazione del pubblico per un video

Questo report misura la capacità di un video di fidelizzare il pubblico. Il report può essere recuperato solo per un singolo video alla volta. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore del parametro filters con l'ID video di uno dei tuoi video caricati. Tieni presente che i report sulla fidelizzazione del pubblico non supportano la possibilità di specificare più valori per il filtro video.

In questo esempio, il report utilizza il filtro audienceType per limitare la risposta in modo che contenga solo i dati relativi alle visualizzazioni organiche, che sono il risultato di un'azione diretta dell'utente, ad esempio la ricerca di un video o un clic su un video consigliato. Di conseguenza, il report non include i dati relativi alle visualizzazioni generate dagli annunci TrueView in-stream o in-display. Puoi rimuovere il filtro per recuperare i dati sulla fidelizzazione del pubblico del video da tutti i tipi di pubblico.

Tieni presente che i dati per il filtro audienceType sono disponibili a partire dal 25 settembre 2013. L'API non restituirà dati per le query che utilizzano il filtro per tentare di recuperare i dati di date precedenti. Le query che non utilizzano il filtro funzionano per qualsiasi data successiva al 1° luglio 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Metriche relative alle entrate e al rendimento degli annunci per i contenuti rivendicati

Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci per i contenuti rivendicati dal proprietario. Il report restituisce una singola riga di dati contenente i totali per ogni metrica richiesta nell'intervallo di date specificato.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Metriche giornaliere relative alle entrate e al rendimento degli annunci

Questa richiesta recupera le metriche giornaliere relative alle entrate e al rendimento degli annunci per i contenuti rivendicati dal proprietario.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Metriche sul rendimento degli annunci e sulle entrate specifiche per paese

Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci specifiche per paese per i contenuti rivendicati dal proprietario. I risultati sono ordinati in ordine decrescente in base all'importo delle entrate, il che significa che il primo paese elencato sarà quello in cui il partner ha registrato le entrate stimate più elevate.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10: video con le entrate più alte

Questa richiesta recupera le metriche sulle entrate e sul rendimento degli annunci per i 10 video rivendicati dal proprietario dei contenuti e che hanno generato le entrate più elevate. I risultati vengono ordinati in ordine decrescente in base all'importo delle entrate, il che significa che il primo video sarà quello con le entrate stimate più alte.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Metriche sul rendimento degli annunci per diversi tipi di annunci

Questa richiesta consente di recuperare le metriche sul rendimento degli annunci relative ai contenuti rivendicati del proprietario dei contenuti. I risultati sono raggruppati per tipo di annuncio, il che ti consente di confrontare i valori di entrate e CPM in base ai diversi tipi di annuncio.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType