Questa pagina mostra esempi di richieste API di YouTube Analytics. Ogni esempio descrive brevemente il report recuperato e poi mostra i valori parametro dimensions, metrics, filters e sort corrispondenti. I report sui canali e i report sui proprietari dei contenuti identificano i report supportati dall'API.
Ogni esempio si collega e completa il programma Explorer API di Google con i valori mostrati. Gli esempi utilizzano anche le date di inizio e di fine predefinite (YYYY-MM-DD) di 2023-09-01 e 2024-03-31.
Dopo aver effettuato il collegamento a Explorer API, devi comunque specificare il canale o il proprietario dei contenuti per cui stai recuperando i report. Explorer API completerà il valore parametro ids con channel==MINE o contentOwner==CONTENT_OWNER_ID, a seconda della query su cui hai fatto clic. Per i report sui canali, potresti modificare MINE nell'ID canale dell'utente autenticato. Per i report del proprietario dei contenuti, devi sostituire CONTENT_OWNER_ID con il tuo ID proprietario dei contenuti.
Inoltre, devi eseguire l'autenticazione come proprietario del canale o dei contenuti specificato per consentire a Explorer API di autorizzare le richieste API utilizzando OAuth 2.0.
- Ordinare le richieste in base a più dimensioni/metriche
- Report sui canali
- Report dei proprietari dei contenuti
Ordinamento delle richieste in base a più dimensioni/metriche
L'API supporta la possibilità di ordinare i dati delle risposte utilizzando più dimensioni o metriche. Ad esempio, la richiesta riportata di seguito recupera i dati giornalieri sulle sorgenti di traffico per i video di un determinato canale. Ogni riga del set di risultati identifica il numero di visualizzazioni e il tempo di visualizzazione stimato che ha avuto origine da un determinato tipo di sorgente di traffico (ad es. EXT_URL) in un determinato giorno.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Nella risposta, i risultati sono in ordine cronologico. All'interno dell'insieme dei risultati relativi a ogni giorno, i risultati sono ordinati in ordine decrescente in base al numero di visualizzazioni. Pertanto, la prima riga del set di risultati contiene i dati relativi alla sorgente di traffico che ha generato il maggior numero di visualizzazioni il primo giorno dell'intervallo di date richiesto. La seconda riga contiene i dati relativi alla sorgente di traffico che ha generato il numero più elevato di visualizzazioni il primo giorno.
Report sui canali
Report video
Il numero totale di visualizzazioni, il tempo di visualizzazione stimato e altri dati per un canale
Questa query recupera metriche aggregate relative ai contenuti del canale. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Numero di visualizzazioni specifiche per paese (e altri) per un canale
Questa query recupera le metriche relative a un paese specifico per i video di un canale. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
Top 10 - Video più guardati su un canale
Questa query recupera i 10 video più guardati di un canale, misurati in base alla stima dei minuti guardati durante l'intervallo di date specificato. I risultati vengono ordinati in base alla stima dei minuti guardati 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=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Top 10 - Percentuali di clic sulle annotazioni per i video più visti di un canale
Questa richiesta recupera il numero di visualizzazioni, le percentuali di clic delle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni relative ai 10 video più visti del canale. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente, il che significa che il video più visto sarà elencato per primo.
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,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Report sulle playlist
Visualizzazioni totali delle playlist per un canale
Questa richiesta recupera gli avvii di playlist totali, la stima dei minuti guardati, le visualizzazioni (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist) e le visualizzazioni per avvio di playlist per le playlist sul canale dell'utente autenticato.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statistiche per una playlist specifica
Questa richiesta recupera gli avvii totali della playlist, la stima dei minuti guardati, le visualizzazioni (una
metrica video aggregata),
le visualizzazioni della playlist (una metrica in-playlist)
e le visualizzazioni per avvio di playlist relative a una playlist specifica. Tieni presente che, per eseguire questa query in Explorer API, devi sostituire la stringa PLAYLIST_ID nel valore parametro filters con l'ID playlist di una playlist nel canale dell'utente autenticato.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Per recuperare statistiche aggregate relative a più playlist, puoi anche sostituire la stringa PLAYLIST_ID con un elenco separato da virgole di massimo 500 ID playlist per le playlist sul canale dell'utente autenticato.
Top 10 - Playlist più guardate di un canale
Questa query recupera le 10 playlist più guardate di un canale, in base alle visualizzazioni delle playlist durante l'intervallo di date specificato. Vengono inoltre recuperati molte altre metriche relative alle playlist, come il numero di volte in cui gli spettatori hanno avviato la riproduzione di ogni playlist e la quantità media di tempo durante il quale uno spettatore ha guardato i video della playlist dopo l'avvio. I risultati sono ordinati in base alle visualizzazioni della playlist in ordine decrescente.
Nota:poiché questo report utilizza la dimensione playlist, devi specificare un valore per il parametro di richiesta sort e anche impostare il parametro maxResults su un valore intero pari o inferiore a 10.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Report video
Metriche giornaliere del tempo di visualizzazione per i video di un canale
Questa query recupera il numero di visualizzazioni giornaliere, le metriche relative al tempo di visualizzazione e il numero di nuovi iscritti relativi ai 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
Metriche giornaliere relative alle annotazioni per i video di un canale
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 relative ai contenuti del canale. I risultati vengono ordinati in ordine cronologico.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Report sulle playlist
Visualizzazioni giornaliere delle playlist di un canale
Questa richiesta recupera il numero di visualizzazioni giornaliere (una metrica video aggregata), le visualizzazioni di playlist (una metrica in-playlist), gli avvii di playlist, la stima dei minuti guardati e le visualizzazioni per avvio di playlist per il canale dell'utente autenticato. I risultati vengono ordinati in ordine cronologico.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Report video
Metriche relative al tempo di visualizzazione specifiche per paese per i video di un canale
Questa query recupera i conteggi delle visualizzazioni, le metriche sul tempo di visualizzazione e le iscrizioni ai video di un canale specifici per paese. 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 annotazioni specifiche per paese per i video di un canale
Questa richiesta recupera i conteggi delle visualizzazioni, le percentuali di clic delle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni specifiche per i video del canale. I risultati sono ordinati in base alla percentuale di clic delle annotazioni in ordine decrescente, il che significa che il paese con la percentuale di clic delle annotazioni più alta sarà elencato per primo.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Metriche specifiche per provincia per gli stati USA e Washington D.C.
Questa richiesta consente di ottenere un'analisi provincia per provincia del numero di visualizzazioni, della stima dei minuti guardati e della durata di visualizzazione media dei video del canale. I dati riguardano gli stati degli Stati Uniti e Washington D.C. I risultati sono 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 – Video più visti 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 specificato. I risultati sono ordinati per 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
Prime 10 città degli Stati Uniti per visualizzazioni totali
Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno rappresentato il maggior numero di visualizzazioni dei contenuti del canale durante l'intervallo di date specificato. La query può essere modificata per richiedere i dati per un altro paese scegliendo un altro valore valido per quel filtro. Allo stesso modo, la query può essere modificata per recuperare i dati relativi a un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei relativi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views
Le prime 10 città degli Stati Uniti in base alle visualizzazioni totali per ogni tipo di contenuti
Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno rappresentato il maggior numero di visualizzazioni dei contenuti del canale nell'intervallo di date specificato per ogni creatorContentType supportato. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views
Le 10 città principali degli Stati Uniti per tempo di visualizzazione totale
Questa query recupera un elenco dei primi 10 giorni dell'intervallo di date specificato, quando qualsiasi città degli Stati Uniti ha rappresentato il tempo di visualizzazione giornaliero totale maggiore per i contenuti del canale. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si è verificato il tempo di visualizzazione e la città in cui è stata stimata la visualizzazione dei contenuti. 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 – 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 può essere modificata in modo da richiedere i dati relativi a un altro continente scegliendo un altro valore valido per quel filtro. Allo stesso modo, la query può essere modificata per recuperare i dati relativi a un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei relativi valori validi. I risultati sono ordinati per 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 relative al tempo di visualizzazione specifiche per paese per le playlist di un canale
Questa query recupera il numero di visualizzazioni specifico per paese (una metrica video aggregata), le visualizzazioni delle playlist (una metrica in-playlist) e le metriche relative al 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 – Playlist più ascoltate negli Stati Uniti
Questa query recupera le 10 playlist che gli spettatori negli Stati Uniti hanno iniziato a guardare più di frequente durante l'intervallo di date specificato. I risultati vengono ordinati in base al numero di avvii della playlist in ordine decrescente.
Nota:poiché questo report utilizza la dimensione playlist, devi specificare un valore per il parametro di richiesta sort e anche 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
Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione
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 video. I risultati 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 diversi luoghi di visualizzazione
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 sono state eseguite riproduzioni video. I risultati vengono ordinati in ordine cronologico.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
Primi 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 dal sito di terze parti in cui il video è stato incorporato. I risultati 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 VIDEO_ID nel valore parametro filters con un elenco separato da virgole di uno o più ID video per i tuoi video caricati.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Report sulle playlist
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione da diverse posizioni di riproduzione
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 gli avvii di 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 video e vengono ordinati in ordine decrescente in base all'avvio della playlist.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diversi luoghi di riproduzione
Questa query recupera gli avvii di playlist giornalieri, il numero di 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 vengono 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 contenuti 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 consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del canale in un paese specificato. Le metriche vengono aggregate per 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 da diverse sorgenti di traffico
Questa richiesta consente di recuperare 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
Primi 10 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 sono 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 parametro filters con un elenco separato da virgole di massimo 500 ID video.
Ad esempio, potresti eseguire la query per un singolo video o sostituire VIDEO_ID per identificare i termini di ricerca che generano più traffico per quel video. Potresti anche elencare tutti i video presenti in una determinata playlist per individuare i termini di ricerca che generano più traffico per qualsiasi video contenuto nella playlist.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 10 - Siti web esterni che generano più 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 parametro filters con un elenco separato da virgole di massimo 500 ID video per i tuoi video caricati.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Report sulle playlist
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione 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 di playlist e il tempo di visualizzazione stimato per le visualizzazioni delle playlist in un paese specificato. Le metriche vengono aggregate per sorgente di traffico, descrivendo così il modo in cui gli utenti hanno raggiunto la playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diverse sorgenti di traffico
Questa richiesta recupera le visualizzazioni giornaliere della playlist di un canale (una metrica in-playlist), gli avvii di 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 vengono raggruppati per giorno per ciascun tipo di dispositivo su cui sono state eseguite le riproduzioni video. I risultati vengono 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 numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato sui dispositivi mobili per i video di un determinato canale. I risultati vengono raggruppati per giorno per ciascun sistema operativo su cui si sono verificate le riproduzioni video. I risultati vengono ordinati in ordine cronologico.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Metriche giornaliere del sistema operativo e del 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 vengono ordinati in ordine cronologico.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Report sulle playlist
Metriche giornaliere sul tipo di dispositivo per le visualizzazioni delle playlist sul sistema operativo Android
Questa query recupera le visualizzazioni giornaliere (una metrica video aggregata), le visualizzazioni di playlist (una metrica in-playlist) e il tempo di visualizzazione stimato su dispositivi Android per le playlist di un determinato canale. I risultati vengono raggruppati per giorno per ciascun tipo di dispositivo su cui sono state visualizzate le playlist. I risultati vengono 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 di playlist (una metrica in-playlist) e il tempo di visualizzazione stimato su dispositivi mobili per le playlist di un determinato canale. I risultati vengono raggruppati per giorno per ciascun sistema operativo su cui si sono verificate le visualizzazioni della playlist. I risultati vengono ordinati in ordine cronologico.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Report video
Dati demografici degli spettatori in California (età e genere)
Questo report recupera le statistiche sull'età e sul genere degli spettatori californiani 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 i visualizzatori del mondo o per tutti i visualizzatori 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 della playlist in California (età e genere)
Questo report recupera le statistiche sull'età e sul 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 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
Metriche di condivisione, aggregate in base al servizio in cui sono stati condivisi i video
Questa richiesta consente di recuperare il numero di volte in cui gli utenti hanno utilizzato il pulsante Share per condividere i video di un canale. I risultati vengono aggregati in base al servizio di condivisione (Google+, Twitter e così via) e ordinati in ordine decrescente per 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 conservare il pubblico. Il report può essere recuperato per un solo video alla volta. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore parametro filters con l'ID video di uno dei 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, come la ricerca di un video o un clic su un video consigliato. Pertanto, il report non include dati sulle visualizzazioni provenienti da annunci TrueView in-stream o TrueView 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 del 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 da date anteriori. 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 relative alle entrate e al rendimento degli annunci di un canale. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Metriche sulle entrate giornaliere e sul rendimento degli annunci
Questa richiesta recupera le metriche relative al rendimento degli annunci e alle entrate giornaliere di un canale.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Metriche relative a rendimento degli annunci e entrate specifiche per paese
Questa richiesta recupera le metriche relative al rendimento degli annunci e alle entrate specifiche per paese di un canale. I risultati vengono 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 maggiori entrate nette.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
Top 10 – Video con le entrate più elevate
Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci per i 10 video del canale con le entrate maggiori. 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 maxResults=10 sort=-estimatedRevenue
Metriche sul rendimento degli annunci per tipi di annuncio diversi
Questa richiesta consente di recuperare le metriche di rendimento degli annunci per i contenuti rivendicati del proprietario dei contenuti. I risultati vengono raggruppati per tipo di annuncio, per consentirti di confrontare i valori relativi a entrate e CPM di diversi tipi di annuncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Report del proprietario dei contenuti
Report video
Il numero totale di visualizzazioni, il tempo di visualizzazione stimato e altro ancora per tutti i contenuti rivendicati
Questa query recupera metriche aggregate relative ai contenuti rivendicati del proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Numero di visualizzazioni specifiche per paese (e altri) per tutti i video caricati autonomamente
Questa query recupera le metriche relative a un paese specifico relative ai video caricati dal proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Numero totale di visualizzazioni (e altro ancora) relativo a tutti i contenuti di terze parti rivendicati
Questa query recupera le metriche aggregate relative ai video che il proprietario dei contenuti ha rivendicato, ma non ha caricato. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Numero totale di visualizzazioni (e altro ancora) per tutti i contenuti caricati autonomamente
Questa query recupera le metriche aggregate relative ai video caricati dal proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Numero totale di visualizzazioni (e altro ancora) per tutti i contenuti rivendicati e caricati autonomamente
Questa query recupera le metriche aggregate relative ai video che il proprietario dei contenuti ha caricato e rivendicato. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
Top 10 – Video più visti per un proprietario di contenuti
Questa query recupera i 10 video più guardati, misurati in base al numero di visualizzazioni caricate dal proprietario dei contenuti nell'intervallo di date specificato. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
Top 10 – Video più guardati per un proprietario di contenuti
Questa query recupera i 10 video più guardati, in base alla stima dei minuti guardati durante l'intervallo di date specificato, caricati dal proprietario dei contenuti. I risultati vengono ordinati in base alla stima dei minuti guardati in ordine decrescente.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
Top 10 – Video più visti per il canale di un proprietario di contenuti
Questa query recupera i 10 video più visti per un canale o gruppo di canali specifico gestito dal proprietario dei contenuti. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API devi sostituire la stringa CHANNEL_ID nel valore parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Top 10 - Percentuali di clic sulle annotazioni per i video più visti di un canale
Questa richiesta recupera il numero di visualizzazioni, le percentuali di clic delle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i 10 video più visti in un canale o gruppo di canali specificato. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente, il che significa che il video più visto sarà elencato per primo. Tieni presente che per eseguire questa query in Explorer API devi sostituire la stringa CHANNEL_ID nel valore parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Report sulle playlist
Visualizzazioni playlist per i canali di un proprietario dei contenuti
Questa richiesta recupera gli avvii di playlist totali, i minuti guardati della playlist stimati, le visualizzazioni delle playlist e le visualizzazioni per avvio di playlist per le playlist nei canali del proprietario dei contenuti. La metrica playlistViews conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist. Poiché tutte le metriche richieste sono metriche in-playlist, la richiesta non
deve includere anche il filtro playlist o gruppo.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistiche per una playlist specifica
Questa richiesta recupera gli avvii totali della playlist, la stima dei minuti guardati, le visualizzazioni (una
metrica video aggregata),
le visualizzazioni della playlist (una metrica in-playlist)
e le visualizzazioni per avvio di playlist relative a una playlist specifica. Tieni presente che, per eseguire questa query in Explorer API, devi sostituire la stringa PLAYLIST_ID nel valore parametro filters con l'ID playlist di una playlist in uno dei canali del proprietario dei contenuti.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Per recuperare statistiche aggregate relative a più playlist, puoi anche sostituire la stringa PLAYLIST_ID con un elenco separato da virgole di massimo 500 ID playlist per le playlist nei canali del proprietario dei contenuti.
Report video
Metriche giornaliere del tempo di visualizzazione per i contenuti caricati autonomamente
Questa query recupera le metriche relative al tempo di visualizzazione giornaliero, nonché il numero di visualizzazioni, il numero di riproduzioni monetizzate e il numero di impressioni relative ai 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 relative ai contenuti rivendicati del proprietario dei contenuti. I risultati vengono 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 quotidiane 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 in-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 relative al tempo di visualizzazione specifiche per paese per i contenuti caricati autonomamente
Questa query recupera il numero di visualizzazioni, le metriche relative al tempo di visualizzazione e le entrate pubblicitarie stimate per ciascun 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 autonomamente
Questa richiesta recupera il numero di visualizzazioni specifico per paese, le percentuali di clic delle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni relative ai video caricati dal proprietario dei contenuti. I risultati sono ordinati in base alla percentuale di clic delle annotazioni in ordine decrescente, il che significa che il paese con la percentuale di clic delle annotazioni più alta sarà elencato per primo.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Metriche specifiche per provincia per gli stati USA e Washington D.C.
Questa richiesta consente di ottenere un'analisi provincia per provincia del numero di visualizzazioni, della stima dei minuti guardati e della durata di visualizzazione media dei video rivendicati del proprietario dei contenuti. I dati riguardano gli stati degli Stati Uniti e Washington D.C. I risultati sono 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 recupera un elenco delle 10 città degli Stati Uniti che hanno registrato il maggior numero di visualizzazioni per i video rivendicati del proprietario dei contenuti durante l'intervallo di date specificato. La query può essere modificata per richiedere i dati per un altro paese scegliendo un altro valore valido per quel filtro. Allo stesso modo, la query può essere modificata per recuperare i dati relativi a un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei relativi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views
Le prime 10 città degli Stati Uniti in base alle visualizzazioni totali per ogni tipo di contenuti
Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno rappresentato il maggior numero di visualizzazioni dei contenuti rivendicati del proprietario dei contenuti durante l'intervallo di date specificato per ogni creatorContentType supportato. I risultati sono 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à principali degli Stati Uniti per tempo di visualizzazione totale
Questa query recupera un elenco dei primi 10 giorni dell'intervallo di date specificato, quando qualsiasi città degli Stati Uniti ha rappresentato il tempo di visualizzazione giornaliero totale più elevato per i contenuti rivendicati del proprietario dei contenuti. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si è verificato il tempo di visualizzazione e la città in cui è stata stimata la visualizzazione dei contenuti. 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 – Video più guardati in Europa
Questa query recupera i 10 video più guardati in Europa, tra i video rivendicati dal proprietario dei contenuti, misurati in base al numero di visualizzazioni durante l'intervallo di date specificato. La query può essere modificata in modo da richiedere i dati relativi a un altro continente scegliendo un altro valore valido per quel filtro. Allo stesso modo, la query può essere modificata per recuperare i dati relativi a un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei relativi valori validi. I risultati sono ordinati per 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 relative al tempo di visualizzazione specifiche per paese per le playlist di un proprietario dei contenuti
Questa query recupera il numero di visualizzazioni delle playlist specifiche per paese e le metriche relative al tempo di visualizzazione delle playlist per tutte le playlist nei canali del proprietario dei contenuti. Il report restituisce una riga di dati per ogni paese in cui le playlist sono state guardate. 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 – Playlist più ascoltate negli Stati Uniti
Questa query recupera le 10 playlist dai 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 vengono ordinati in base al numero di avvii della playlist in ordine decrescente.
Nota:poiché questo report utilizza la dimensione playlist, devi specificare un valore per il parametro di richiesta sort e impostare anche un parametro maxResults su un valore intero uguale 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 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
Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione
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 video. I risultati 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 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 diversi luoghi di visualizzazione
Questa query recupera il numero di visualizzazioni giornaliere 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 sono state eseguite riproduzioni 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 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
Primi 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 dal sito di terze parti in cui il video è stato incorporato. I risultati 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 VIDEO_ID nel valore parametro filters con un elenco separato da virgole di massimo 500 ID video per i tuoi video caricati.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Report sulle playlist
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione da diverse posizioni di riproduzione
Questa query recupera il numero di visualizzazioni della playlist, il tempo di visualizzazione stimato della playlist e gli avvii di playlist per tutte le playlist presenti 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 video. I risultati vengono ordinati in ordine decrescente in base all'avvio della playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione da diverse posizioni di riproduzione
Questa query recupera gli avvii di playlist giornalieri, il numero di visualizzazioni delle playlist e il tempo di visualizzazione stimato delle playlist negli Stati Uniti per tutte le playlist presenti nei canali di un proprietario dei contenuti. I risultati vengono restituiti per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni della playlist.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Report video
Numero di visualizzazioni e tempo di visualizzazione da diverse sorgenti di traffico
Questa richiesta consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del proprietario dei contenuti. Le metriche vengono aggregate per 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 da diverse sorgenti di traffico
Questa richiesta consente di recuperare il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato giornaliero 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 successivi sono supportati solo per sorgenti di traffico specifiche. Ad esempio, la sorgente di traffico NO_LINK_EMBEDDED non dispone di ulteriori dettagli, per cui questi report non sono disponibili per quella sorgente. Consulta la definizione di insightTrafficSourceType per informazioni dettagliate sulle sorgenti di traffico per cui sono disponibili questi tipi di report.
Primi 10 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 un video o un gruppo di video specifico. I risultati sono 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 parametro filters con un elenco separato da virgole di massimo 500 ID video per i tuoi video caricati.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 10 - Siti web esterni che generano più 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 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 parametro filters con un elenco separato da virgole di massimo 500 ID video per i tuoi video caricati.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Report sulle playlist
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione 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 per sorgente di traffico, il che descrive il modo in cui gli utenti hanno raggiunto la playlist.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Il numero di visualizzazioni delle playlist e il tempo di visualizzazione da diverse sorgenti di traffico
Questa richiesta recupera le visualizzazioni di playlist, gli avvii di playlist e il tempo di visualizzazione stimato della playlist
per le playlist in uno o più canali di un proprietario dei 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 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 sul tipo di dispositivo per i video rivendicati
Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato in base al tipo di dispositivo per i video rivendicati da un determinato proprietario di contenuti. I risultati vengono raggruppati per giorno per ciascun tipo di dispositivo su cui sono state eseguite le riproduzioni video. I risultati vengono ordinati in ordine cronologico.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Metriche giornaliere del sistema operativo per i video rivendicati visualizzati sui dispositivi mobili
Questa query recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione stimato in base al sistema operativo per le visualizzazioni dei video rivendicati da un proprietario di contenuti specificato che hanno avuto luogo su dispositivi mobili. I risultati vengono raggruppati per giorno per ciascun sistema operativo in cui si sono verificate le riproduzioni video. I risultati vengono ordinati in ordine cronologico.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Metriche giornaliere del sistema operativo e del 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 di contenuti. Le statistiche sono raggruppate per sistema operativo e tipo di dispositivo. I risultati vengono 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 delle playlist sul sistema operativo Android
Questa query recupera il numero di visualizzazioni delle playlist e il tempo di visualizzazione stimato delle playlist sui dispositivi Android
per le playlist in uno o più canali di un proprietario dei contenuti. Vengono restituiti risultati per ciascun tipo di dispositivo su cui si sono verificate le visualizzazioni della playlist. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore 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 del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili
Questa query recupera il numero di visualizzazioni delle playlist e il tempo di visualizzazione stimato delle playlist su dispositivi mobili per le playlist nei canali di un proprietario di contenuti. I risultati vengono restituiti per ciascun 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 statistiche sull'età e sul genere degli spettatori in California che hanno guardato i contenuti rivendicati del proprietario dei contenuti. 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 del mondo o per tutti i visualizzatori 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=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Metriche di condivisione, aggregate in base al servizio in cui sono stati condivisi i video
Questa richiesta consente di recuperare 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 in base al servizio di condivisione (Google+, Twitter e così via) e ordinati in ordine decrescente per 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 conservare il pubblico. Il report può essere recuperato per un solo video alla volta. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore parametro filters con l'ID video di uno dei 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, come la ricerca di un video o un clic su un video consigliato. Pertanto, il report non include dati sulle visualizzazioni provenienti da annunci TrueView in-stream o TrueView 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 del 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 da date anteriori. 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 del proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali di ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Metriche sulle entrate giornaliere e sul rendimento degli annunci
Questa richiesta consente di recuperare metriche giornaliere relative alle entrate e al rendimento degli annunci relative ai contenuti rivendicati del proprietario dei contenuti.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Metriche relative a rendimento degli annunci e entrate specifiche per paese
Questa richiesta consente di recuperare metriche relative a rendimento degli annunci ed entrate specifiche per paese per i contenuti rivendicati del proprietario dei contenuti. I risultati vengono 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 maggiori.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
Top 10 – Video con le entrate più elevate
Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci per i 10 video che sono stati 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 tipi di annuncio diversi
Questa richiesta consente di recuperare le metriche di rendimento degli annunci per i contenuti rivendicati del proprietario dei contenuti. I risultati vengono raggruppati per tipo di annuncio, per consentirti di confrontare i valori relativi a entrate e CPM di diversi tipi di annuncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType