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.
- Ordinare le richieste in base a più dimensioni/metriche
- Report sui canali
- 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
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
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
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
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
Report video
Mi piace e Non mi piace per tipo di contenuti
Questa query recupera il numero di Mi piace e Non mi piace per ogni tipo di contenuto su un canale.
dimensions=creatorContentType metrics=likes,dislikes
Report video
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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