Questa pagina mostra esempi di richieste API di YouTube Analytics. Ogni esempio descrive brevemente il report recuperato e mostra i valori parametro dimensions
, metrics
, filters
e sort
corrispondenti. I documenti relativi ai report sul canale e ai report sui proprietari dei contenuti identificano i report supportati dall'API.
Ogni esempio si collega all'Explorer API di Google e lo compila 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
.
Una volta 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 del parametro ids
con channel==MINE
o contentOwner==CONTENT_OWNER_ID
, a seconda della query su cui hai fatto clic. Per i report sui canali, puoi modificare MINE
nell'ID canale dell'utente autenticato. Per i report sul proprietario dei contenuti, devi sostituire CONTENT_OWNER_ID
con il tuo ID proprietario dei contenuti.
Devi inoltre disporre dell'autenticazione come proprietario del canale o dei contenuti specificato affinché l'Explorer API possa autorizzare le tue 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 dell'insieme 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 di risultati per 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 successivo numero di visualizzazioni più alto nel primo giorno.
Report sul canale
Report video
Numero totale di visualizzazioni, tempo di visualizzazione stimato e altro ancora per un canale.
Questa query recupera le metriche aggregate per i contenuti del canale. Il report restituisce una singola riga di dati contenente i totali per ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Numero di visualizzazioni di un canale specifico per paese (e altro ancora)
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 per ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
Top 10: i video più guardati di un canale
Questa query recupera i 10 video più guardati di un canale, in base alla stima dei minuti guardati durante l'intervallo di date specificato. I risultati sono 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
Prime 10: percentuali di clic nelle annotazioni per i video più visti di un canale
Questa richiesta recupera il numero di visualizzazioni, le percentuali di clic delle annotazioni, i tassi di chiusura delle annotazioni e le impressioni delle annotazioni relative ai 10 video più visti del canale. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente, il che significa che il video più visualizzato 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 della playlist per un canale
Questa richiesta recupera il totale degli avvii delle playlist, la stima dei minuti guardati, le visualizzazioni (una metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) e le visualizzazioni per playlist iniziano per le playlist sul canale dell'utente autenticato.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statistiche per una playlist specifica
Questa richiesta recupera il totale degli avvii delle playlist, la stima dei minuti guardati, le visualizzazioni (una
metrica video aggregata),
Visualizzazioni di playlist (una metrica in-playlist)
e visualizzazioni per playlist
per una playlist specifica. Tieni presente che per eseguire questa query nelle API
Explorer, devi sostituire la stringa PLAYLIST_ID
nel campo filters
con l'ID playlist per una playlist nel canale dell'utente autenticato.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Per recuperare le 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 nel canale dell'utente autenticato.
Top 10: playlist più guardate di un canale
Questa query recupera le 10 playlist più guardate di un canale, misurate in termini di visualizzazioni di playlist durante l'intervallo di date specificato. Vengono inoltre recuperate altre metriche relative alle playlist, come il numero di volte in cui gli spettatori hanno avviato la riproduzione di ogni playlist e il numero medio la quantità di tempo in cui 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 impostare anche 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 per i video di un canale. Il report restituisce una riga di dati per ogni giorno dell'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 i conteggi giornalieri delle visualizzazioni, le percentuali di clic delle annotazioni, i tassi di chiusura delle annotazioni e le impressioni delle annotazioni relative ai 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 della playlist per un canale
Questa richiesta recupera i conteggi giornalieri delle visualizzazioni (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) avvii di playlist, stima dei minuti guardati e visualizzazioni per avvio di playlist per gli utenti autenticati canale dell'utente. I risultati sono ordinati in ordine cronologico.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Report video
Metriche del tempo di visualizzazione specifiche per paese relative ai 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 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 del canale. I risultati vengono ordinati in base alla percentuale di clic dell'annotazione in ordine decrescente, il che significa che il paese con la percentuale di clic più alta dell'annotazione sarà elencato per primo.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Metriche specifiche per provincia per 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 lo stato di Washington D.C. I risultati sono in ordine alfabetico per provincia. Codici ISO 3166-2.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Top 10 - I video più visti in un paese specifico
Questa query recupera i 10 video più visti del canale, in base al numero di visualizzazioni durante l'intervallo di date specificato, in un paese specificato. I risultati vengono 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 registrato il maggior numero di visualizzazioni dei contenuti del canale 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, come l'Europa occidentale o l'Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati vengono 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 per visualizzazioni totali per ciascun 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 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=country==US maxResults=10 sort=-views
Le prime 10 città degli Stati Uniti per tempo di visualizzazione totale
Questa query recupera un elenco dei primi 10 giorni durante l'intervallo di date specificato quando qualsiasi città degli Stati Uniti ha registrato il tempo di visualizzazione totale giornaliero massimo dei 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 si stima che i contenuti siano stati visualizzati. I risultati vengono visualizzati 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, in base al numero di visualizzazioni durante l'intervallo di date specificato. La query potrebbe essere modificata per richiedere i dati per un altro continente scegliendo un altro valore valido per il filtro in questione. 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 vengono 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 del tempo di visualizzazione specifiche per paese per le playlist di un canale
Questa query recupera i conteggi delle visualizzazioni specifiche per paese (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) e sul tempo di visualizzazione per le playlist di un canale. Il report restituisce una riga di dati per ogni il 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ù iniziate 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 base al numero di avvii delle 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 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 dei video e i risultati vengono ordinati in ordine decrescente in base al numero di visualizzazioni.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Numero di visualizzazioni e tempo di visualizzazione giornalieri da diverse posizioni di riproduzione.
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 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 dei video caricati.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Report sulle playlist
Numero di visualizzazioni e tempo di visualizzazione della playlist da diverse posizioni di riproduzione.
Questa query recupera il numero di conteggi delle visualizzazioni (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) il tempo di visualizzazione stimato e gli avvii della playlist per le playlist di un determinato canale. I risultati sono aggregati in base al tipo di pagina o applicazione in cui si sono verificate riproduzioni dei video e i risultati vengono ordinati in ordine decrescente in base agli avvii delle playlist.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse posizioni di riproduzione.
Questa query recupera gli avvii giornalieri delle playlist, i conteggi delle visualizzazioni (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) e il tempo di visualizzazione stimato negli Stati Uniti per le playlist di un determinato canale. Risultati sono raggruppate per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni delle playlist. 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 specificato. Le metriche vengono aggregate in base alle sorgenti di traffico, che descrivono 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 recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione giornaliero stimato 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: 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 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 di un video o 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 dei video caricati.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Report sulle playlist
Numero di visualizzazioni della playlist e tempo di visualizzazione da diverse sorgenti di traffico in un paese
Questa richiesta recupera il numero di visualizzazioni (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) avvii della playlist e tempo di visualizzazione stimato per le visualizzazioni della playlist in un paese specificato. La vengono aggregate per sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse sorgenti di traffico.
Questa richiesta recupera le visualizzazioni giornaliere della playlist di un canale (una in-playlist), degli avvii della playlist e del tempo di visualizzazione stimato. Inoltre, recupera le visualizzazioni totali (uno 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 sul 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 si sono verificate le riproduzioni 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 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 sono 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 sono ordinati in ordine cronologico.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Report sulle playlist
Metriche giornaliere del tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android
Questa query recupera le visualizzazioni giornaliere (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) e il tempo di visualizzazione stimato sui dispositivi Android per le playlist di un determinato canale. I risultati sono raggruppate per giorno per ogni 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 (un metrica video aggregata), Visualizzazioni di playlist (una metrica in-playlist) e il tempo di visualizzazione stimato sui dispositivi mobili per le playlist di un determinato canale. I risultati sono raggruppate per giorno per ciascun sistema operativo su cui si sono verificate le visualizzazioni della 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 (età e genere)
Questo report recupera le statistiche sulla fascia di età e sul genere degli spettatori in California che hanno guardato i video del canale. 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=province==US-CA sort=gender,ageGroup
Report sulle playlist
Dati demografici degli spettatori delle playlist in California (età e genere)
Questo report recupera le statistiche sull'età e sul genere degli spettatori in California che
ha guardato le playlist del canale. I risultati vengono ordinati per genere e poi per fascia d'età. Questo
la query potrebbe essere modificata in modo da recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o
di spettatori in 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 per servizio in cui sono stati condivisi i video
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 ecc.) e ordinati in ordine decrescente in base al numero di condivisioni.
dimensions=sharingService metrics=shares sort=-shares
Metriche relative alla fidelizzazione del pubblico per un video
Questo report misura la capacità di un video di conservare 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 per le 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. Di conseguenza, il report non include i dati sulle visualizzazioni provenienti dagli 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 dal 25 settembre 2013. L'API non restituirà dati per le query che utilizzano il filtro per cercare di recuperare dati da 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 entrate di un canale e le metriche sul rendimento degli annunci. Il report restituisce una singola riga di dati contenente i totali per 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 entrate giornaliere di un canale e le metriche sul rendimento degli annunci.
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 consente di recuperare le metriche relative a entrate e rendimento degli annunci 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 dalle entrate maggiori
Questa richiesta recupera le metriche relative a entrate e 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 annunci diversi
Questa richiesta consente di recuperare le metriche sul rendimento degli annunci relative ai contenuti rivendicati del proprietario dei contenuti. I risultati vengono raggruppati per tipo di annuncio, in modo da poter confrontare le entrate e i valori CPM tra diversi tipi di annuncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Report proprietari dei contenuti
Report video
Numero totale di visualizzazioni, tempo di visualizzazione stimato e altro ancora per tutti i contenuti rivendicati.
Questa query recupera le metriche aggregate relative ai contenuti rivendicati del proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali per ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Numero di visualizzazioni specifico per paese (e altro ancora) per tutti i video autocaricati
Questa query recupera le metriche relative a un paese specifico per i video caricati dal proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali per 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) per 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 per 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 autocaricati
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 per 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 autocaricati
Questa query recupera le metriche aggregate relative ai video caricati e rivendicati dal proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali per ogni metrica richiesta durante l'intervallo di date specificato.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
Top 10: i video più visti per un proprietario dei contenuti
Questa query recupera i 10 video più visti, misurati in base al numero di visualizzazioni durante l'intervallo di date specificato, che il proprietario dei contenuti ha caricato. I risultati vengono 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: i video più guardati per un proprietario dei contenuti
Questa query recupera i 10 video più guardati, in base alla stima dei minuti guardati durante l'intervallo di date specificato, che il proprietario dei contenuti ha caricato. I risultati sono 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: i video più visti dal canale di un proprietario dei contenuti
Questa query recupera i 10 video più visti per un canale o un gruppo di canali specifico gestito dal proprietario dei contenuti. 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 CHANNEL_ID
nel valore del 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
Prime 10: percentuali di clic nelle annotazioni per i video più visti di un canale
Questa richiesta recupera il numero di visualizzazioni, le percentuali di clic delle annotazioni, i tassi di chiusura delle annotazioni e le impressioni delle annotazioni per i 10 video più visti in un canale o gruppo di canali specifico. I risultati sono ordinati in base al numero di visualizzazioni in ordine decrescente, il che significa che il video più visualizzato sarà elencato per primo. 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=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 il totale degli avvii delle playlist, la stima dei minuti guardati della playlist e la playlist
le visualizzazioni e le visualizzazioni per playlist iniziano per le playlist nei canali del proprietario dei contenuti. La
La metrica playlistViews
conteggia solo le visualizzazioni di video avvenute nel contesto di una
playlist. Poiché tutte le metriche richieste sono metriche in-playlist, la richiesta non
Devi includere anche il filtro playlist o gruppo.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistiche per una playlist specifica
Questa richiesta recupera il totale degli avvii delle playlist, la stima dei minuti guardati, le visualizzazioni (una
metrica video aggregata),
Visualizzazioni di playlist (una metrica in-playlist)
e visualizzazioni per playlist
per una playlist specifica. Tieni presente che per eseguire questa query nelle API
Explorer, devi sostituire la stringa PLAYLIST_ID
nel campo filters
con l'ID playlist per una playlist in uno dei canali del proprietario dei contenuti.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Per recuperare le 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 autocaricati
Questa query recupera le metriche giornaliere relative al tempo di visualizzazione, 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 dell'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 i conteggi giornalieri delle visualizzazioni, le percentuali di clic delle annotazioni, i tassi di chiusura delle annotazioni e le impressioni delle annotazioni relative ai contenuti rivendicati del proprietario dei contenuti. I risultati sono ordinati in ordine cronologico.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Report sulle playlist
Visualizzazioni di playlist giornaliere per un proprietario dei contenuti
Questa richiesta recupera le metriche relative alle interazioni giornaliere degli utenti con i video nel playlist. Le metriche recuperate nel report sono playlistViews, playlistStarts. playlistEstimatedMinutesWatched e viewsPerPlaylistStart. Tutte queste metriche sono metriche in-playlist. Poiché tutte le metriche richieste sono metriche in-playlist, è necessario che la richiesta Includi anche il filtro playlist o gruppo.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Report video
Metriche del tempo di visualizzazione specifiche per paese per i contenuti autocaricati
Questa query recupera il numero di visualizzazioni, le metriche del 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 autocaricati
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 vengono ordinati in base alla percentuale di clic dell'annotazione in ordine decrescente, il che significa che il paese con la percentuale di clic più alta dell'annotazione sarà elencato per primo.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Metriche specifiche per provincia per 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 rivendicati del proprietario dei contenuti. I dati riguardano gli stati degli Stati Uniti e di Washington D.C. I risultati sono in ordine alfabetico per provincia. Codici ISO 3166-2.
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 totalizzato il maggior numero di visualizzazioni dei video rivendicati del 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, come l'Europa occidentale o l'Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati vengono 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 per visualizzazioni totali per ciascun tipo di contenuti
Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno registrato il maggior numero di visualizzazioni dei contenuti rivendicati dal proprietario dei contenuti 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 prime 10 città degli Stati Uniti per tempo di visualizzazione totale
Questa query recupera un elenco dei primi 10 giorni durante l'intervallo di date specificato quando qualsiasi città degli Stati Uniti ha registrato il tempo di visualizzazione totale giornaliero massimo dei 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 si stima che i contenuti siano stati visualizzati. I risultati vengono visualizzati 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ù guardati 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 per un altro continente scegliendo un altro valore valido per il filtro in questione. 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 vengono 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 del tempo di visualizzazione specifiche per paese per le playlist di un proprietario dei contenuti
Questa query recupera i conteggi delle visualizzazioni delle playlist e le metriche relative al tempo di visualizzazione specifici per paese per tutte le playlist nei canali del proprietario dei contenuti. Il report restituisce una riga di dati per ogni paese in cui sono state guardate le playlist. Le righe vengono ordinate in ordine decrescente in base al numero di minuti guardati.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Top 10 – Playlist più iniziate negli Stati Uniti
Questa query recupera le 10 playlist dai canali del proprietario dei contenuti che gli spettatori nel Stati Uniti ha iniziato a guardare i video con maggiore frequenza durante l'intervallo di date specificato. I risultati sono ordinate per numero di playlist inizia in ordine decrescente.
Nota: poiché questo report utilizza la classe
playlist
, è necessario
specifica un valore per il parametro di richiesta sort
e imposta anche th
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 contenuto 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
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 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 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 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 e tempo di visualizzazione giornalieri da diverse posizioni di riproduzione.
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 si sono verificate le riproduzioni video. I risultati vengono 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 dei video caricati.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Report sulle playlist
Numero di visualizzazioni e tempo di visualizzazione della playlist da diverse posizioni di riproduzione.
Questa query recupera il numero di visualizzazioni di playlist, il tempo di visualizzazione stimato per la playlist e playlist viene avviata per tutte le playlist nei canali di un proprietario dei contenuti. I risultati vengono aggregati in base sul tipo di pagina o applicazione in cui si sono verificate le riproduzioni video e i risultati sono ordinati in ordine decrescente per inizio playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Numero di visualizzazioni e tempo di visualizzazione della playlist da diverse posizioni di riproduzione.
Questa query recupera gli avvii giornalieri delle playlist, il numero di visualizzazioni della playlist e le visualizzazioni stimate della playlist negli Stati Uniti per tutte le playlist dei canali di un proprietario dei contenuti. Vengono restituiti i risultati per ogni tipo di pagina o applicazione in cui si sono verificate 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 recupera il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del proprietario dei contenuti. Le metriche vengono aggregate in base alle sorgenti di traffico, che descrivono il modo in cui gli utenti hanno raggiunto il video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Numero di visualizzazioni e tempo di visualizzazione giornalieri 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 per 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 questa sorgente. Per informazioni dettagliate sulle sorgenti di traffico per le quali sono disponibili questi tipi di report, consulta la definizione di insightTrafficSourceType.
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 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 dei 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 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 dei video caricati.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Report sulle playlist
Numero di visualizzazioni della playlist e tempo di visualizzazione da diverse sorgenti di traffico in un paese
Questa richiesta recupera il numero di visualizzazioni della playlist, gli avvii delle playlist e le visualizzazioni stimate della playlist tempo per le visualizzazioni della playlist in un paese specificato. Le metriche vengono aggregate per sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Numero di visualizzazioni e tempo di visualizzazione delle playlist da diverse sorgenti di traffico.
Questa richiesta recupera le visualizzazioni della playlist, gli avvii delle 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
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 una virgola
un elenco di massimo 500 ID canale per i tuoi canali.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Report video
Metriche giornaliere del 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 si sono verificate le riproduzioni video. I risultati sono ordinati in ordine cronologico.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Metriche giornaliere del sistema operativo relative ai video rivendicati visualizzati su dispositivi mobili
Questa query recupera i conteggi giornalieri delle visualizzazioni e il tempo di visualizzazione stimato in base al sistema operativo per le visualizzazioni dei video rivendicati da un determinato proprietario dei contenuti e eseguiti su dispositivi mobili. I risultati vengono raggruppati per giorno per ciascun sistema operativo in cui si sono verificate le riproduzioni video. I risultati sono 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 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 delle playlist e il tempo di visualizzazione stimato della playlist sui dispositivi Android
per le playlist in uno o più canali di un proprietario dei contenuti. Vengono restituiti risultati per
ogni tipo di dispositivo su cui
si verifica la visualizzazione della playlist. Tieni presente che per eseguire questa query nelle API
Explorer, devi sostituire la stringa CHANNEL_ID
nel campo 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 della playlist e il tempo di visualizzazione stimato della playlist sui dispositivi mobili per le playlist in uno qualsiasi dei canali di un proprietario dei contenuti. Vengono restituiti risultati per ogni il 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 sulla fascia di età e sul genere degli spettatori in California che hanno guardato i contenuti rivendicati del proprietario dei contenuti. 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 di condivisione, aggregate per servizio in cui sono stati condivisi i video
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 ecc.) e ordinati in ordine decrescente in base al numero di condivisioni.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Metriche relative alla fidelizzazione del pubblico per un video
Questo report misura la capacità di un video di conservare 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 per le 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. Di conseguenza, il report non include i dati sulle visualizzazioni provenienti dagli 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 dal 25 settembre 2013. L'API non restituirà dati per le query che utilizzano il filtro per cercare di recuperare dati da 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 a entrate e rendimento degli annunci per i contenuti rivendicati
Questa richiesta consente di recuperare le metriche relative a entrate e rendimento degli annunci per i contenuti rivendicati del proprietario dei contenuti. Il report restituisce una singola riga di dati contenente i totali per 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 recupera le entrate giornaliere e le metriche sul 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 specifiche per paese sulle entrate e sul rendimento degli annunci
Con questa richiesta vengono recuperate metriche specifiche per paese sulle entrate e sul rendimento degli annunci 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 dalle entrate maggiori
Questa richiesta recupera le metriche relative a entrate e rendimento degli annunci per i 10 video rivendicati dal proprietario dei contenuti e che hanno registrato 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 filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Metriche sul rendimento degli annunci per tipi di annunci diversi
Questa richiesta consente di recuperare le metriche sul rendimento degli annunci relative ai contenuti rivendicati del proprietario dei contenuti. I risultati vengono raggruppati per tipo di annuncio, in modo da poter confrontare le entrate e i valori CPM tra diversi tipi di annuncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType