Richieste API di esempio

Questa pagina mostra esempi di richieste dell'API YouTube Analytics. Ogni esempio descrive brevemente il report recuperato e poi mostra i valori dei parametri dimensions, metrics, filters e sort corrispondenti. I documenti relativi ai report sui canali e ai report sui proprietari dei contenuti identificano i report supportati dall'API.

Ogni esempio rimanda a Explorer API di Google e viene compilato con i valori mostrati. Gli esempi utilizzano anche le date di inizio e di fine predefinite (YYYY-MM-DD) di 2022-01-01 e 2022-06-30.

Una volta eseguito il collegamento a Explorer API, devi comunque specificare il canale o il proprietario dei contenuti per cui recuperi i report. Explorer API compila 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 sostituire MINE con l'ID canale dell'utente autenticato. Per i report sui proprietari dei contenuti, devi sostituire CONTENT_OWNER_ID con il tuo ID proprietario dei contenuti.

Devi inoltre essere autenticato come proprietario del canale o dei contenuti specificato per consentire a Explorer API di 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 Proprietario dei contenuti

Richieste di ordinamento per più dimensioni/metriche

L'API supporta la possibilità di ordinare i dati di risposta utilizzando più dimensioni o metriche. Ad esempio, la richiesta riportata di seguito recupera i dati giornalieri relativi alle sorgenti di traffico per i video di un determinato canale. Ogni riga nel set di risultati identifica il numero di visualizzazioni e il tempo di visualizzazione stimato che hanno 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 ordinati in ordine cronologico. Nell'insieme dei risultati di ogni giorno, i risultati sono ordinati in ordine decrescente per numero di visualizzazioni. Di conseguenza, la prima riga nel set di risultati contiene dati per la sorgente di traffico che ha generato il maggior numero di visualizzazioni il primo giorno nell'intervallo di date richiesto. La seconda riga contiene i dati relativi alla sorgente di traffico che ha generato il maggior numero di visualizzazioni il primo giorno.

Report sui canali

Statistiche di base

Report video

Numero totale di visualizzazioni, tempo di visualizzazione stimato e molto altro per un canale

Questa query recupera 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 specifiche del paese (e altro ancora) per un canale

Questa query recupera metriche per un video specifico di un canale specifico. 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

Primi 10 – Video più guardati di un canale

Questa query recupera i 10 video più guardati di un canale, in base ai minuti stimati guardati durante l'intervallo di date specificato. I risultati vengono ordinati per minuti stimati 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 non superiore a 10.

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

Prime 10 – Percentuali di clic sulle annotazioni per i video più guardati di un canale

Questa richiesta recupera i conteggi delle visualizzazioni, le percentuali di clic sulle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i 10 video più visti del canale. I risultati vengono ordinati per numero di visualizzazioni in ordine decrescente, il che significa che i video più visti saranno elencati per primi.

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

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Report playlist

Visualizzazioni totali delle playlist di un canale

Questa richiesta consente di recuperare gli avvii totali della playlist, i minuti stimati guardati, le visualizzazioni e le visualizzazioni per avvio della playlist per le playlist nel canale dell'utente autenticato. La metrica views conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Statistiche relative a una playlist specifica

Questa richiesta recupera il numero totale di avvii, i minuti stimati guardati, le visualizzazioni e le visualizzazioni per avvio di una playlist specifica. La metrica views conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa PLAYLIST_ID nel valore parametro filters con l'ID playlist di una playlist nel canale dell'utente autenticato.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Per recuperare statistiche aggregate per 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.

Prime 10 – Playlist più guardate di un canale

Questa query recupera le 10 playlist più guardate di un canale, misurate in base ai minuti stimati guardati durante l'intervallo di date specificato. Recupera anche diverse altre metriche, come il numero di volte in cui gli spettatori hanno avviato la riproduzione di ogni playlist e la quantità media di tempo in cui uno spettatore ha guardato video nella playlist dopo l'avvio. I risultati vengono ordinati per minuti stimati guardati in ordine decrescente.

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

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
In base al tempo

Report video

Metriche giornaliere sul tempo di visualizzazione dei video di un canale

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

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

Metriche annotazioni giornaliere per i video di un canale

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

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

Report playlist

Visualizzazioni giornaliere delle playlist di un canale

Questa richiesta recupera i conteggi giornalieri delle visualizzazioni, gli avvii delle playlist, i minuti stimati guardati e le visualizzazioni per avvio della playlist per il canale dell'utente autenticato. I risultati sono ordinati in ordine cronologico.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Area geografica

Report video

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

Questa query recupera i conteggi delle visualizzazioni specifiche per paese, le metriche del tempo di visualizzazione e le cifre dell'iscrizione ai 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 di 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 specifiche per paese, le percentuali di clic sulle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i video del canale. I risultati vengono ordinati per percentuale di clic delle annotazioni in ordine decrescente, il che significa che il paese con la percentuale di clic delle annotazioni più elevata verrà elencato per primo.

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

Metriche specifiche per le province per Stati USA e Washington D.C.

Questa richiesta consente di recuperare i dati relativi a un'analisi specifica della provincia in termini di numero di visualizzazioni, minuti stimati guardati e durata di visualizzazione media dei video del canale. I dati riguardano gli Stati Uniti e il Washington D.C. I risultati sono in ordine alfabetico in base ai codici ISO 3166-2 delle province.

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

I 10 video più popolari in un paese specifico

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

Nota:questo report richiede di specificare un valore per il parametro di richiesta sort e di impostare il parametro maxResults su un valore intero non superiore 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 generato il maggior numero di visualizzazioni dei contenuti del canale durante l'intervallo di date specificato. La query potrebbe essere modificata in modo da richiedere i dati per un altro paese scegliendo un altro valore valido per il filtro in questione. Allo stesso modo, la query potrebbe essere modificata in modo da recuperare i dati per un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.

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

Prime 10 città degli Stati Uniti per visualizzazioni totali per ogni tipo di contenuti

Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno generato il maggior numero di visualizzazioni dei contenuti del canale durante l'intervallo di date specificato per ogni creatorContentType supportato. I risultati sono ordinati 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 rappresenta il maggiore tempo di visualizzazione totale dei contenuti del canale. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si sono verificati e la città in cui è stata stimata la visualizzazione dei contenuti. I risultati sono ordinati in ordine decrescente in base al tempo di visualizzazione totale.

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

I 10 video più visti in Europa

Questa query recupera i 10 video più guardati del canale in Europa, misurata in base al numero di visualizzazioni nell'intervallo di date specificato. La query potrebbe essere modificata in modo da richiedere i dati per un altro continente scegliendo un altro valore valido per il filtro in questione. Allo stesso modo, la query potrebbe essere modificata in modo da recuperare i dati per un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.

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

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

Report playlist

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

Questa query recupera il numero di visualizzazioni specifico e le metriche relative al tempo di visualizzazione per le playlist di un canale. Il report restituisce una riga di dati per ogni paese in cui sono state guardate le playlist del canale. Le righe sono ordinate in ordine decrescente di numero di minuti guardati.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

I 10 brani più ascoltati 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 delle playlist che iniziano in ordine decrescente.

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

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

Report video

Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione

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

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

Numero di visualizzazioni giornaliere e tempo di visualizzazione 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

Primi 10 – Siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato

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

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

Report playlist

Conteggi delle visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Numero giornaliero di visualizzazioni delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione

Questa query recupera l'avvio giornaliero delle playlist, il numero di visualizzazioni e il tempo di visualizzazione stimato negli Stati Uniti per le playlist di un determinato canale. I risultati sono raggruppati per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Sorgente di traffico

Report video

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

Questa richiesta consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per i video del canale relativi a un determinato paese. Le metriche sono aggregate per sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto il video.

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

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

Questa richiesta consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione giornaliero stimati relativi ai video del canale. Le metriche vengono aggregate su base giornaliera per sorgente di traffico e ordinate in ordine cronologico.

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

Primi 10 – Termini di ricerca di YouTube che generano più traffico per un video

Questa query recupera i 10 termini di ricerca che hanno generato il maggior numero di visualizzazioni dai risultati di ricerca di YouTube per uno o più video specifici. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa VIDEO_ID nel valore 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 in una determinata playlist per determinare quali termini di ricerca generano più traffico per qualsiasi video della playlist in questione.

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

Primi 10 – Siti web esterni che generano più traffico per un video

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

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

Report playlist

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

Questa richiesta recupera il numero di visualizzazioni, l'inizio delle playlist e il tempo di visualizzazione stimato per le visualizzazioni della playlist in un determinato paese. Le metriche sono aggregate per sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

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

Questa richiesta consente di recuperare le visualizzazioni giornaliere della playlist, l'inizio della playlist e il tempo di visualizzazione stimato del canale. Le metriche vengono aggregate su base giornaliera per sorgente di traffico e ordinate in ordine cronologico.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
sort=day
Dispositivo/sistema operativo

Report video

Metriche giornaliere sul tipo di dispositivo per il sistema operativo Android

Questa query recupera i conteggi giornalieri delle visualizzazioni e il tempo di visualizzazione stimato sui dispositivi Android per i video di un determinato canale. I risultati vengono raggruppati per giorno per ogni 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 giornaliero di visualizzazioni e il tempo di visualizzazione stimato sui dispositivi mobili relativi ai video di un determinato canale. I risultati sono raggruppati per giorno per ogni 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 sul sistema operativo e sul tipo di dispositivo

Questa query recupera i conteggi giornalieri delle visualizzazioni 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 playlist

Metriche giornaliere del tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android

Questa query recupera i conteggi giornalieri delle visualizzazioni delle playlist e il tempo di visualizzazione stimato sui dispositivi Android per le playlist di un determinato canale. I risultati sono raggruppati per giorno per ogni tipo di dispositivo su cui si sono verificate le visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico.

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

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

Questa query recupera i conteggi giornalieri delle visualizzazioni e il tempo di visualizzazione stimato sui dispositivi mobili delle playlist di un determinato canale. I risultati sono raggruppati per giorno per ogni 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=isCurated==1;deviceType==MOBILE
sort=day
Gruppo demografico

Report video

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

Questo report recupera le statistiche sull'età e sul genere degli spettatori in California che hanno guardato i video del canale. I risultati vengono ordinati per genere e quindi per fascia di età. Questa query potrebbe essere modificata per recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o per tutti i visualizzatori di un paese, continente, subcontinente o altro stato degli Stati Uniti regolando il valore parametro filters.

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

Report playlist

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

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Social

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 di numero di condivisioni.

dimensions=sharingService
metrics=shares
sort=-shares
Fidelizzazione del pubblico

Metriche sulla fidelizzazione del pubblico per un video

Questo report misura la capacità di un video di conservare il pubblico. È possibile recuperare il report per un solo 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 dati sulle visualizzazioni organiche, derivanti da un'azione diretta dell'utente, ad esempio la ricerca di un video o un clic su un video suggerito. Di conseguenza, il report non include i dati per le visualizzazioni da annunci TrueView in-stream o TrueView in-display. Puoi rimuovere il filtro per recuperare i dati sulla fidelizzazione del pubblico del video da tutti i tipi di pubblico.

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

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

Metriche sul rendimento degli annunci e sulle entrate del canale

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

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

Metriche giornaliere sulle entrate e sul rendimento degli annunci

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

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

Metriche specifiche per paese per entrate e rendimento degli annunci

Questa richiesta recupera le metriche sul rendimento degli annunci e sul rendimento degli annunci specifiche di un canale. I risultati sono ordinati in ordine decrescente in base all'importo delle entrate. Ciò significa che il primo paese indicato 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

Prime 10 – Video con le entrate più elevate

Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci per i 10 video del canale con le maggiori entrate. I risultati vengono ordinati in ordine decrescente in base all'importo, 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 recupera le metriche sul rendimento degli annunci per i contenuti rivendicati del proprietario dei contenuti. I risultati sono raggruppati per tipo di annuncio, in modo da poter confrontare i valori delle entrate e del CPM in tipi di annunci diversi.

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

Report proprietario di 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 metriche aggregate 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,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Numero di visualizzazioni specifiche del paese (e altro ancora) per tutti i video caricati autonomamente

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 di visualizzazioni totali (e altri ancora) per tutti i contenuti di terze parti rivendicati

Questa query recupera le metriche aggregate per i 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 non solo) per tutti i contenuti caricati autonomamente

Questa query recupera le metriche aggregate 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,estimatedMinutesWatched
filters=uploaderType==self

Numero totale di visualizzazioni (e non solo) per tutti i contenuti rivendicati caricati autonomamente

Questa query recupera le metriche aggregate per i video che il proprietario dei contenuti ha caricato e anche rivendicato. 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

Primi 10 – Video più visti per un proprietario di contenuti

Questa query recupera i 10 video più visti, misurati in base al numero di visualizzazioni nell'intervallo di date specificato, che sono state caricate dal proprietario dei contenuti. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Prime 10 - Video più guardati per un proprietario dei contenuti

Questa query recupera i 10 video più guardati, misurati in base ai minuti stimati guardati durante l'intervallo di date specificato, che sono stati caricati dal proprietario dei contenuti. I risultati vengono ordinati per minuti stimati guardati in ordine decrescente.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

I primi 10 video più visti del canale di un proprietario di contenuti

Questa query recupera i 10 video più visti di un canale o di un gruppo specifico di canali gestiti dal proprietario dei contenuti. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore 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 sulle annotazioni per i video più guardati di un canale

Questa richiesta recupera i conteggi delle visualizzazioni, le percentuali di clic sulle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i 10 video più visti in un canale o un gruppo di canali specificati. I risultati vengono ordinati per numero di visualizzazioni in ordine decrescente, il che significa che i video più visti saranno elencati per primi. 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 playlist

Visualizzazioni delle playlist dei canali di un proprietario di contenuti

Questa richiesta consente di recuperare gli avvii totali della playlist, i minuti stimati guardati, le visualizzazioni e le visualizzazioni per avvio della playlist nei canali del proprietario dei contenuti. La metrica views conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Visualizzazioni delle playlist per un determinato canale

Questa richiesta consente di recuperare gli avvii totali della playlist, i minuti stimati guardati, le visualizzazioni e le visualizzazioni per avvio della playlist nei canali del proprietario dei contenuti. La metrica views conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist. 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.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

Statistiche di una playlist

Questa richiesta recupera il numero totale di avvii, i minuti stimati guardati, le visualizzazioni e le visualizzazioni per avvio di una playlist specifica. La metrica views conteggia solo le visualizzazioni di video che si sono verificate nel contesto di una playlist. Tieni presente che per eseguire questa query in Explorer API è necessario sostituire la stringa PLAYLIST_ID nel valore del parametro filters con l'ID della playlist di uno dei canali del proprietario dei contenuti.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Per recuperare le statistiche aggregate di 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.

Le 10 migliori playlist per i proprietari di contenuti

Questa query recupera le 10 playlist più guardate del proprietario dei contenuti, misurata in base ai minuti stimati guardati durante l'intervallo di date specificato. Recupera anche diverse altre metriche, come il numero di volte in cui gli spettatori hanno avviato la riproduzione di ogni playlist e la quantità media di tempo in cui uno spettatore ha guardato video nella playlist dopo l'avvio. I risultati vengono ordinati per minuti stimati guardati in ordine decrescente.

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

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
In base al tempo

Report video

Metriche giornaliere sul tempo di visualizzazione dei contenuti caricati autonomamente

Questa query recupera le metriche relative al tempo di visualizzazione giornaliero, nonché il numero di visualizzazioni, quello di riproduzione monetizzato e quello relativo alle impressioni dei video caricati dal proprietario dei contenuti. Il report restituisce una riga di dati per ogni giorno nell'intervallo di date richiesto, mentre le righe sono ordinate in ordine cronologico.

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

Metriche relative alle annotazioni per i contenuti rivendicati

Questa richiesta recupera i conteggi giornalieri delle visualizzazioni, le percentuali di clic sulle annotazioni, le percentuali di chiusura delle annotazioni e le impressioni delle annotazioni per i 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 playlist

Visualizzazioni giornaliere di playlist per un proprietario di contenuti

Questa richiesta recupera i conteggi giornalieri delle visualizzazioni, gli avvii delle playlist, i minuti stimati guardati e le visualizzazioni per avvio della playlist per tutte le playlist nei canali del proprietario dei contenuti. I risultati sono ordinati in ordine cronologico.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Area geografica

Report video

Metriche relative al tempo di visualizzazione specifiche per paese per i contenuti caricati autonomamente

Questa query recupera i conteggi delle visualizzazioni, le metriche del tempo di visualizzazione e le entrate pubblicitarie stimate per ogni paese. Le metriche riguardano i video caricati dal proprietario dei contenuti. Il report restituisce una riga di dati per ogni paese in cui i video sono stati guardati, mentre le righe sono ordinate in ordine decrescente di numero di minuti guardati.

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

Metriche relative alle annotazioni specifiche per paese per i contenuti caricati autonomamente

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

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

Metriche specifiche per le province per Stati USA e Washington D.C.

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

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

Prime 10 città degli Stati Uniti per visualizzazioni totali

Questa query recupera un elenco delle 10 città degli Stati Uniti che hanno generato il maggior numero di visualizzazioni dei video rivendicati del proprietario dei contenuti durante l'intervallo di date specificato. La query potrebbe essere modificata in modo da richiedere i dati per un altro paese scegliendo un altro valore valido per il filtro in questione. Allo stesso modo, la query potrebbe essere modificata in modo da recuperare i dati per un subcontinente, ad esempio Europa occidentale o Asia sudorientale, utilizzando il filtro subContinent e uno dei suoi valori validi. Sono supportati anche altri filtri. I risultati sono ordinati per numero di visualizzazioni in ordine decrescente.

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

Prime 10 città degli Stati Uniti per visualizzazioni totali per ogni tipo di contenuti

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

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

Le 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 una città statunitense rappresenta il maggiore tempo di visualizzazione totale dei contenuti rivendicati dal proprietario dei contenuti. I risultati della query identificano il tempo di visualizzazione totale, la data in cui si sono verificati e la città in cui è stata stimata la visualizzazione dei contenuti. I risultati sono ordinati in ordine decrescente in base al tempo di visualizzazione totale.

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

I 10 video più guardati in Europa

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

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

Report playlist

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

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

I 10 brani più ascoltati negli Stati Uniti

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

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

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

Report video

Mi piace e Non mi piace per tipo di contenuti

La query recupera il numero di Mi piace e Non mi piace per ogni tipo di contenuto su uno specifico 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 riproduzione

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 su un determinato gruppo di canali. I risultati vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni video e i risultati sono ordinati in ordine decrescente per numero di visualizzazioni. Tieni presente che per eseguire questa query in Explorer API, devi sostituire la stringa CHANNEL_ID nel valore del parametro filters con un elenco separato da virgole di massimo 500 ID canale per i tuoi canali.

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

Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione

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

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

Primi 10 – Siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato

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

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

Report playlist

Conteggi delle visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Numero giornaliero di visualizzazioni delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione

Questa query recupera l'avvio giornaliero delle playlist, il numero di visualizzazioni e il tempo di visualizzazione stimato negli Stati Uniti per tutte le playlist nei canali di un proprietario dei contenuti. I risultati sono raggruppati per giorno per ogni tipo di pagina o applicazione in cui si sono verificate le visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Sorgente di traffico

Report video

Conteggi delle visualizzazioni e tempo di visualizzazione da sorgenti di traffico diverse

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

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

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

Questa richiesta recupera il numero di visualizzazioni giornaliere e il tempo di visualizzazione giornaliero stimati 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 ha dettagli aggiuntivi e, di conseguenza, questi report non sono disponibili per quella sorgente. Consulta la definizione di insightTrafficSourceType per i dettagli sulle sorgenti di traffico per cui sono disponibili questi tipi di report.

Primi 10 – Termini di ricerca di YouTube che generano più traffico per un video

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

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

Primi 10 – Siti web esterni che generano più traffico per un video

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

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

Report playlist

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

Questa richiesta recupera il numero di visualizzazioni, l'inizio delle playlist e il tempo di visualizzazione stimato per le visualizzazioni della playlist in un determinato paese. Le metriche sono aggregate per sorgente di traffico, che descrive il modo in cui gli utenti hanno raggiunto la playlist.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
Dispositivo/sistema operativo

Report video

Metriche giornaliere sui tipi di dispositivi per i video rivendicati

Questa query recupera i conteggi giornalieri delle visualizzazioni e il tempo di visualizzazione stimato in base al tipo di dispositivo per i video rivendicati da un determinato proprietario dei contenuti. I risultati vengono raggruppati per giorno per ogni 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 del sistema operativo giornaliero per i video rivendicati visualizzati sui 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 di contenuti che hanno avuto luogo sui dispositivi mobili. I risultati vengono raggruppati per giorno per ogni 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 sul sistema operativo e sul tipo di dispositivo

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

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

Report playlist

Metriche giornaliere del tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android

Questa query recupera i conteggi giornalieri delle visualizzazioni delle playlist e il tempo di visualizzazione stimato sui dispositivi Android per le playlist presenti in uno o più canali dei proprietari dei contenuti. I risultati sono raggruppati per giorno per ogni tipo di dispositivo su cui si sono verificate le visualizzazioni della playlist. I risultati sono ordinati in ordine cronologico. 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,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

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

Questa query recupera i conteggi giornalieri delle visualizzazioni delle playlist e il tempo di visualizzazione stimato sui dispositivi mobili delle playlist presenti in tutti i canali di un proprietario di contenuti. I risultati sono raggruppati per giorno per ogni 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=isCurated==1;deviceType==MOBILE
sort=day
Dati demografici

Report video

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

Questo report recupera le statistiche relative all'età e al genere degli spettatori in California che hanno guardato i contenuti rivendicati del proprietario dei contenuti. I risultati vengono ordinati per genere e quindi per fascia di età. Questa query potrebbe essere modificata per recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o per tutti i visualizzatori di un paese, continente, subcontinente o altro stato degli Stati Uniti regolando il valore parametro filters.

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

Report playlist

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

Questo report recupera le statistiche relative all'età e al genere degli spettatori in California che hanno guardato le playlist in uno qualsiasi dei canali del proprietario dei contenuti. I risultati vengono ordinati per genere e quindi per fascia di età. Questa query potrebbe essere modificata per recuperare le stesse statistiche per tutti i visualizzatori a livello mondiale o per tutti i visualizzatori di un paese, continente, subcontinente o altro stato degli Stati Uniti regolando il valore parametro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Social

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 di numero di condivisioni.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares
Fidelizzazione del pubblico

Metriche sulla fidelizzazione del pubblico per un video

Questo report misura la capacità di un video di conservare il pubblico. È possibile recuperare il report per un solo 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 dati sulle visualizzazioni organiche, derivanti da un'azione diretta dell'utente, ad esempio la ricerca di un video o un clic su un video suggerito. Di conseguenza, il report non include i dati per le visualizzazioni da annunci TrueView in-stream o TrueView in-display. Puoi rimuovere il filtro per recuperare i dati sulla fidelizzazione del pubblico del video da tutti i tipi di pubblico.

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

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

Metriche sul rendimento degli annunci e sulle entrate per i contenuti rivendicati

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

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

Metriche giornaliere sulle entrate e sul rendimento degli annunci

Questa richiesta recupera le metriche giornaliere relative al fatturato e al rendimento degli annunci per i 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 per entrate e rendimento degli annunci

Questa richiesta recupera le metriche relative al rendimento degli annunci e alle entrate specifiche per paese relative ai contenuti rivendicati del proprietario dei contenuti. I risultati vengono ordinati in ordine decrescente in base all'importo delle entrate. Ciò significa che il primo paese indicato sarà quello in cui il partner ha registrato le maggiori entrate stimate.

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

Prime 10 – Video con le entrate più elevate

Questa richiesta recupera le metriche relative alle entrate e al rendimento degli annunci per i 10 video che hanno rivendicato dal proprietario dei contenuti e che hanno registrato le entrate maggiori. I risultati vengono ordinati in ordine decrescente in base all'importo, 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 recupera le metriche sul rendimento degli annunci per i contenuti rivendicati del proprietario dei contenuti. I risultati sono raggruppati per tipo di annuncio, in modo da poter confrontare i valori delle entrate e del CPM in tipi di annunci diversi.

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