Richieste API di esempio

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.

  1. Ordinare le richieste in base a più dimensioni/metriche
  2. Report sui canali
  3. 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

Statistiche di base

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
.
Basato sull'ora

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
.
Area geografica

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
.
Luogo di visualizzazione

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
. .
Sorgente di traffico

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
.
Dispositivo/Sistema operativo

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
.
Dati demografici

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
.
Sociale

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
.
Fidelizzazione del pubblico

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
.
Entrate/Annunci

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

Statistiche di base

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.

In base al tempo

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
.
Area geografica

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
.
Dettagli sulla riproduzione

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
.
Luogo di visualizzazione

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
.
Sorgente di traffico

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
.
Dispositivo/Sistema operativo

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
.
Dati demografici

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
.
Sociale

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
.
Fidelizzazione del pubblico

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
.
Entrate/Annunci

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