Questo documento definisce le dimensioni supportate dall'API YouTube Analytics. Questa API supporta query mirate in tempo reale per generare report personalizzati di YouTube Analytics.
Le dimensioni sono criteri comuni utilizzati per aggregare dati, ad esempio la data in cui si è verificata l'attività utente o il paese in cui si trovavano gli utenti.
Ogni report sulle query identifica le dimensioni che supporta. Ad esempio, quando recuperi l'attività utente in base al tempo, puoi scegliere il periodo di tempo per il quale verranno registrati i dati: giorno o mese. In qualsiasi report, ogni riga di dati ha una combinazione univoca di valori delle dimensioni.
Per recuperare un report sulle query, chiama il metodo reports.query
dell'API di YouTube Analytics. Nella tua richiesta, utilizza il parametro dimensions
per specificare le dimensioni che YouTube utilizzerà per calcolare i valori delle metriche nei report.
Dimensioni principali
Anche se l'API YouTube Analytics è soggetta alle norme sul ritiro definite nella I Termini di servizio, le dimensioni non principali (e le metriche non principali) non sono soggetta alle norme. Nelle definizioni di questa pagina, qualsiasi dimensione che sia una dimensione principale viene esplicitamente identificati come tali.
Il seguente elenco identifica le dimensioni principali dell'API.
Per ulteriori informazioni, consulta l'elenco delle API di YouTube soggette alle Norme sul ritiro.
Filtri
Tutti i report sulle query supportano i filtri. I filtri identificano i valori delle dimensioni che devono essere presenti nel set di dati recuperato. Di conseguenza, limitano una risposta dell'API in modo che includa solo i dati corrispondenti a un determinato valore o insieme di valori. Ad esempio, invece di recuperare le metriche sull'attività dell'utente per tutti i paesi, puoi utilizzare un filtro per recuperare solo i dati relativi a un determinato paese.
In una richiesta di recupero di un report sulle query, il parametro facoltativo di richiesta filters
specifica i valori delle dimensioni in base a cui filtrare i dati. Ad esempio, per recuperare le metriche dell'attività utente per l'Europa, devi impostare il valore del parametro filters
su continent==150
.
Importante:le richieste API per recuperare i report dei proprietari dei contenuti devono filtrare i dati utilizzando una delle dimensioni dell'entità report o una combinazione supportata delle dimensioni claimedStatus
e uploaderType
.
Dimensioni
Le seguenti sezioni definiscono le dimensioni utilizzate nei report sulle query dell'API di YouTube Analytics. Se non diversamente indicato, queste dimensioni vengono utilizzate nei report canale e proprietario dei contenuti. Vengono inoltre identificate le dimensioni che possono essere utilizzate solo come filtri.
Risorse
Queste dimensioni corrispondono alle risorse che i canali e i proprietari dei contenuti gestiscono su YouTube:
Nota: l'API consente di specificare più valori per le dimensioni video
, playlist
e channel
quando vengono utilizzate come filtri. A tale scopo, imposta il valore del parametro filters
in un elenco separato da virgole di ID video, playlist o canale per i quali la risposta dell'API deve essere filtrata. Il valore del parametro può specificare fino a 500 ID.
- video (dimensione principale)
- L'ID di un video di YouTube. Nell'API YouTube Data, questo è il valore di un
video
proprietàid
della risorsa. This is a core dimension and is subject to the Deprecation Policy. - playlist
- L'ID di una playlist di YouTube. Nell'API YouTube Data, questo è il valore della proprietà
id
di una risorsaplaylist
. - canale (dimensione principale) (utilizzato solo nei report dei proprietari dei contenuti)
- L'ID di un canale YouTube. Nell'API YouTube Data, questo è il valore della proprietà
id
di una risorsachannel
. This is a core dimension and is subject to the Deprecation Policy.
La dimensionechannel
viene utilizzata spesso nei report sui proprietari dei contenuti perché in genere aggregano i dati per più canali. - gruppo (solo filtro)
- L'ID di un gruppo di YouTube Analytics. Puoi recuperare questo valore utilizzando il metodo
groups.list
dell'API di YouTube Analytics. Quando utilizzi il filtrogroup
, la risposta dell'API contiene i dati relativi a tutti i video, le playlist o i canali di quel gruppo.
Esempi
Le seguenti richieste di esempio utilizzano dimensioni o filtri delle entità report:
Esempi di canali
-
Statistiche di base
- .
- Top 10: i video più guardati di un canale
- Prime 10: percentuali di clic nelle annotazioni per i video più visti di un canale
- Statistiche per una playlist specifica
- Top 10: playlist più guardate di un canale
-
Area geografica
- .
- Top 10 - I video più visti in un paese specifico
- Top 10 - I video più visti in Europa
-
Statistiche di base
Esempi di proprietari dei contenuti
-
Statistiche di base
- .
- Top 10 - I video più visti per un proprietario dei contenuti
- Top 10 - I video più guardati per un proprietario dei contenuti
- Top 10 - I video più visti dal canale di un proprietario dei contenuti
- Prime 10: percentuali di clic nelle annotazioni per i video più visti di un canale
- Top 10: playlist più guardate per un proprietario dei contenuti
-
Area geografica
- .
- Top 10: i video più guardati in Europa per un proprietario di contenuti
- Top 10 – Playlist più iniziate negli Stati Uniti
-
Statistiche di base
Aree geografiche
Queste dimensioni identificano una regione geografica associata alle metriche relative ad attività utente, rendimento degli annunci o entrate stimate.
- country (dimensione principale)
- Il paese associato alle metriche nella riga del report. Il valore della dimensione è un codice paese ISO-3166-1 a due lettere, ad esempio
US
,CN
(Cina) oFR
(Francia). Il codice paeseZZ
viene utilizzato per generare report sulle metriche per cui YouTube non è riuscito a identificare il paese associato. This is a core dimension and is subject to the Deprecation Policy. - province
- Lo stato o il territorio degli Stati Uniti associato alle metriche nella riga del report. Il valore della dimensione è un codice ISO 3166-2 che identifica uno stato degli Stati Uniti o il District of Columbia, ad esempio
US-MI
(Michigan) oUS-TX
(Texas). Il codice provinciaUS-ZZ
viene utilizzato per generare report sulle metriche per le quali YouTube non ha potuto identificare lo stato degli Stati Uniti associato. Quando una richiesta API includeprovince
nel valore del parametrodimensions
, deve anche limitare i dati agli Stati Uniti includendocountry==US
nel valore del parametrofilters
.Nota: questa dimensione non supporta i valori ISO 3166-2 che identificano le zone periferiche degli Stati Uniti, poiché anche questi territori hanno i propri codici paese ISO 3166-1. Inoltre, non supporta le suddivisioni di paesi diversi dagli Stati Uniti.
- dma
- L'identificatore a tre cifre utilizzato da Nielsen per identificare la Designated Market Area (DMA) associate agli eventi di visualizzazione descritti nella riga di dati.
- city
- La città stimata associata alle metriche nella riga del report. I dati di questa dimensione sono disponibili per le date a partire dal 1° gennaio 2022.
- continente (solo filtro)
-
Un codice regione statistico delle Nazioni Unite (ONU). L'API supporta i seguenti valori:
Valori 002
Africa 019
Americhe (Nord America, America Latina, Sud America e Caraibi) 142
Asia 150
Europa 009
Oceania filters
parametro incontinent==REGION_CODE
, specificando un valoreREGION_CODE
dalla tabella. - subContinent (solo filtro)
-
Un codice regione statistica delle Nazioni Unite che identifica una sottoregione geografica. La divisione statistica delle Nazioni Unite elenca le regioni secondarie e i paesi che associa a ciascuna regione.
Questa dimensione può essere utilizzata solo per filtrare i dati. Per utilizzare questa dimensione, imposta il valore del parametro
filters
susubContinent==REGION_CODE
, specificando un valoreREGION_CODE
nell'elenco delle Nazioni Unite.
Esempi
Le seguenti richieste di esempio utilizzano dimensioni geografiche o filtri:
Esempi di canali
- Statistiche di base: numero di visualizzazioni specifico per paese (e altro ancora) per un canale
-
Area geografica
- .
- Metriche del tempo di visualizzazione specifiche per paese relative ai video di un canale
- Metriche di annotazione specifiche per paese per i video di un canale
- Metriche specifiche per provincia per stati degli Stati Uniti e Washington D.C.
- Metriche del tempo di visualizzazione specifiche per paese per le playlist di un canale
- Top 10 – Playlist più iniziate negli Stati Uniti
- Luogo di visualizzazione: numero di visualizzazioni giornaliero e tempo di visualizzazione da diversi luoghi di visualizzazione.
- Sorgente di traffico. Numero di visualizzazioni e tempo di visualizzazione da diverse sorgenti di traffico in un paese.
- Dati demografici: dati demografici degli spettatori in California (fascia d'età e genere).
-
Video principali
- .
- Top 10 - I video più visti in un paese specifico
- Top 10 - I video più visti in Europa
Esempi di proprietari dei contenuti
- Statistiche di base: numero di visualizzazioni specifico per paese (e altro ancora) per tutti i video autocaricati
-
Area geografica
- .
- Metriche del tempo di visualizzazione specifiche per paese per i contenuti autocaricati
- Metriche di annotazione specifiche per paese per i contenuti autocaricati
- Metriche specifiche per provincia per stati degli Stati Uniti e Washington D.C.
- Metriche del tempo di visualizzazione specifiche per paese per le playlist di un proprietario dei contenuti
- Top 10 – Playlist più iniziate negli Stati Uniti
- Luogo di visualizzazione: numero di visualizzazioni giornaliero e tempo di visualizzazione da diversi luoghi di visualizzazione.
- Dati demografici: dati demografici degli spettatori in California (fascia d'età e genere).
- Video principali: Top 10 – I video più guardati in Europa per un proprietario di contenuti.
- Entrate/Rendimento degli annunci: metriche specifiche per paese sulle entrate e sul rendimento degli annunci.
Periodi di tempo
Queste dimensioni indicano che un report deve aggregare i dati in base a un periodo di tempo, ad esempio un giorno, una settimana o un mese. I parametri di richiesta startDate
e endDate
specificano il periodo di tempo per il quale il report include dati. Tieni presente che il report restituisce in realtà i dati fino all'ultimo giorno per il quale sono disponibili tutte le metriche specificate nella richiesta nel momento in cui viene effettuata la query. Nei report, le date sono elencate nel formato YYYY-MM-DD
.
Importante: tutte le date si riferiscono al periodo di tempo che inizia alle 00:00 (UTC-7 o UTC-8) e termina alle 23:59 (fuso orario del Pacifico - USA) del giorno, del mese e dell'anno specificati. Di conseguenza, le date in cui gli orologi vengono regolati in avanti in base all'ora legale rappresentano un periodo di 23 ore, mentre le date in cui gli orologi vengono regolati all'indietro rappresentano un periodo di 25 ore.
La dimensione mese si riferisce al periodo di tempo che inizia alle 00:00 (UTC-7 o UTC-8) del primo giorno del mese e dell'anno specificati.
- giorno (dimensione principale)
- Quando utilizzi questa dimensione, i dati del report vengono aggregati su base giornaliera e ogni riga contiene dati relativi a un giorno. Puoi utilizzare altre dimensioni per suddividere ulteriormente i dati. Ad esempio, un report sulle sorgenti di traffico può aggregare statistiche giornaliere sulle visualizzazioni basate sul modo in cui gli utenti raggiungono i tuoi video. This is a core dimension and is subject to the Deprecation Policy.
- mese (dimensione principale)
- I dati del report vengono aggregati per mese di calendario. Come per i report giornalieri, puoi utilizzare altri filtri per segmentare ulteriormente i dati. Nel report, le date sono elencate nel formato
YYYY-MM
.
Nota: se la query API utilizza la dimensionemonth
, i parametristart-date
eend-date
devono essere entrambi impostati sul primo giorno del mese. This is a core dimension and is subject to the Deprecation Policy.
Esempi
Le seguenti richieste di esempio utilizzano dimensioni o filtri temporali:
Esempi di canali
-
In base al tempo
- .
- Metriche giornaliere del tempo di visualizzazione per i video di un canale
- Le metriche relative alle annotazioni giornaliere per i video di un canale
- Visualizzazioni giornaliere della playlist per un canale
- Luogo di visualizzazione: numero di visualizzazioni giornaliero e tempo di visualizzazione da diversi luoghi di visualizzazione.
- Sorgente di traffico. Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico.
-
Dispositivo/sistema operativo
- .
- Metriche giornaliere sul tipo di dispositivo per il sistema operativo Android
- Metriche giornaliere del sistema operativo per i dispositivi mobili
- Metriche giornaliere del sistema operativo e del tipo di dispositivo
-
In base al tempo
Esempi di proprietari dei contenuti
-
In base al tempo
- .
- Metriche giornaliere del tempo di visualizzazione per i contenuti autocaricati
- Metriche di annotazione per i contenuti rivendicati
- Visualizzazioni di playlist giornaliere per un proprietario dei contenuti
- Luogo di visualizzazione: numero di visualizzazioni giornaliero e tempo di visualizzazione da diversi luoghi di visualizzazione.
- Sorgente di traffico. Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico.
-
Dispositivo/sistema operativo
- .
- Metriche giornaliere del tipo di dispositivo per i video rivendicati
- Metriche giornaliere del sistema operativo relative ai video rivendicati visualizzati su dispositivi mobili
- Metriche giornaliere del sistema operativo e del tipo di dispositivo
- Entrate/Rendimento degli annunci: metriche relative a entrate giornaliere e rendimento degli annunci.
-
In base al tempo
Luoghi di visualizzazione
Queste dimensioni forniscono informazioni sulla pagina o sull'applicazione in cui si è verificata l'attività utente.
- insightPlaybackLocationType
-
I dati del report vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni video. I valori possibili per questa dimensione sono:
-
BROWSE
– I dati descrivono le visualizzazioni avvenute sulla home page o nella schermata Home di YouTube, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube. -
CHANNEL
- I dati descrivono le visualizzazioni avvenute sulla pagina di un canale. -
EMBEDDED
– I dati descrivono le visualizzazioni avvenute su un altro sito web o applicazione in cui il video è stato incorporato utilizzando un incorporamento<iframe>
o<object>
. -
EXTERNAL_APP
- I dati descrivono le visualizzazioni avvenute in un'applicazione di terze parti in cui il video è stato riprodotto utilizzando un metodo diverso da un incorporamento<iframe>
o<object>
. Ad esempio, le riproduzioni in applicazioni che utilizzano l'API YouTube Android Player vengono classificate utilizzando questo valore. -
MOBILE
– I dati descrivono le visualizzazioni avvenute sul sito web mobile di YouTube o su client API di YouTube approvati, inclusi i dispositivi mobili.A partire dal 10 settembre 2013, le riproduzioni non sono più classificate come riproduzioni
MOBILE
nei report di YouTube Analytics. Il valore potrebbe rimanere nei report perché i dati precedenti rientrano ancora in questa categoria. Tuttavia, dopo questa data, le riproduzioni da dispositivi mobili saranno classificate comeWATCH
,EMBEDDED
oEXTERNAL_APP
, a seconda del tipo di applicazione in cui si verificano. -
SEARCH
– I dati descrivono le visualizzazioni avvenute direttamente nella pagina dei risultati di ricerca di YouTube. -
WATCH
– I dati descrivono le visualizzazioni avvenute sulla pagina di visualizzazione del video su YouTube o in un'applicazione YouTube ufficiale, come l'app YouTube per Android. -
YT_OTHER
– I dati descrivono le visualizzazioni che non sono altrimenti classificate.
-
- insightPlaybackLocationDetail
- I dati vengono aggregati in base alla pagina in cui si trova il player. Tieni presente che questo report è supportato solo per le visualizzazioni che si sono verificate nei player incorporati e identifica i player incorporati che hanno generato il maggior numero di visualizzazioni per un determinato video. Pertanto, fornisce una visione più granulare rispetto al report sui luoghi di visualizzazione identificando gli URL o le applicazioni associati ai principali player incorporati.
Esempi
Le seguenti richieste di esempio utilizzano le dimensioni del luogo di riproduzione:
Esempi di canali
-
Luogo di visualizzazione
- .
- Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione.
- Numero di visualizzazioni e tempo di visualizzazione giornalieri da diverse posizioni di riproduzione.
- Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
- Numero di visualizzazioni e tempo di visualizzazione della playlist da diverse posizioni di riproduzione.
- Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse posizioni di riproduzione.
-
Luogo di visualizzazione
Esempi di proprietari dei contenuti
-
Luogo di visualizzazione
- .
- Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione.
- Numero di visualizzazioni e tempo di visualizzazione giornalieri da diverse posizioni di riproduzione.
- Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
- Numero di visualizzazioni e tempo di visualizzazione della playlist da diverse posizioni di riproduzione.
- Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse posizioni di riproduzione.
-
Luogo di visualizzazione
Dettagli riproduzione
- creatorContentType
- Questa dimensione identifica il tipo di contenuti associati alle metriche relative all'attività utente nella riga di dati. I dati per questa dimensione sono disponibili a partire dal 1° gennaio 2019.
La seguente tabella elenca i valori delle dimensioni:
Valori LIVE_STREAM
I contenuti visualizzati erano un live streaming di YouTube. SHORTS
I contenuti visualizzati erano uno Short di YouTube. STORY
I contenuti visualizzati erano una Storia di YouTube. VIDEO_ON_DEMAND
I contenuti visualizzati erano video di YouTube che non rientrano in uno degli altri valori di dimensione. UNSPECIFIED
Il tipo di contenuti visualizzati è sconosciuto. - liveOrOnDemand
- Questa dimensione indica se le metriche relative all'attività utente nella riga di dati sono associate alle visualizzazioni di una trasmissione dal vivo. I dati per questa dimensione sono disponibili a partire dal 1° aprile 2014.
La seguente tabella elenca i valori delle dimensioni:
Valori LIVE
I dati della riga descrivono l'attività utente che si è verificata durante una trasmissione dal vivo. ON_DEMAND
I dati della riga descrivono l'attività utente non registrata durante una trasmissione dal vivo. - subscribedStatus
- Questa dimensione indica se le metriche sull'attività utente nella riga di dati sono associate a spettatori iscritti al canale del video o della playlist.
I valori possibili sono
SUBSCRIBED
eUNSUBSCRIBED
.
Tieni presente che il valore della dimensione è accurato al momento dell'attività utente. Ad esempio, supponiamo che un utente non si sia iscritto a un canale e guardi uno dei video presenti su quel canale, poi si iscriva al canale e guardi un altro video, il tutto nello stesso giorno. Il report del canale indica che una vista ha un valoresubscribedStatus
pari aSUBSCRIBED
e una vista ha un valoresubscribedStatus
pari aUNSUBSCRIBED
. - youtubeProduct
- Questa dimensione identifica il servizio YouTube su cui si è verificata l'attività utente. I dati per questa dimensione sono disponibili dal 18 luglio 2015.
La seguente tabella elenca i valori delle dimensioni:
Valori CORE
L'attività utente non registrata in una delle applicazioni specializzate di YouTube (YouTube Gaming, YouTube Kids o YouTube Music). Eccezione: le attività degli utenti che si sono verificate su YouTube Music prima del 1° marzo 2021 sono incluse in CORE
.GAMING
L'attività utente si è verificata su YouTube Gaming. KIDS
L'attività utente si è verificata su YouTube Kids. MUSIC
L'attività utente si è verificata su YouTube Music a partire dal 1° marzo 2021. I dati precedenti al 1° marzo 2021 sono inclusi in CORE
. I dati in tempo reale non vengono registrati.UNKNOWN
L'attività utente si è verificata prima del 18 luglio 2015.
Sorgenti di traffico
- insightTrafficSourceType
- I dati del report vengono aggregati in base al tipo di referrer, che descrive il modo in cui gli utenti hanno raggiunto il video. I valori possibili per questa dimensione sono:
ADVERTISING
- Lo spettatore è stato indirizzato al video da un annuncio pubblicitario. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
identifica il tipo di pubblicità.ANNOTATION
- Gli spettatori hanno raggiunto il video facendo clic su un'annotazione in un altro video.CAMPAIGN_CARD
- Visualizzazioni provenienti da video rivendicati caricati dagli utenti che il proprietario dei contenuti ha utilizzato per promuovere i contenuti visualizzati. Questa sorgente di traffico è supportata solo per i report sui proprietari dei contenuti.END_SCREEN
- Le visualizzazioni sono state generate dalla schermata finale di un altro video.EXT_URL
– Le visualizzazioni del video sono state indirizzate da un link su un altro sito web. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
identifica la pagina web. Questa sorgente di traffico include i referral provenienti dai risultati della Ricerca Google.HASHTAGS
– Visualizzazioni provenienti dalle pagine hashtag VOD o dalle pagine pivot degli hashtag degli Short.LIVE_REDIRECT
- Le visualizzazioni del video sono state indirizzate tramite Live Redirect.NO_LINK_EMBEDDED
- Il video è stato incorporato in un altro sito web quando è stato visualizzato.NO_LINK_OTHER
- YouTube non ha identificato un referrer per il traffico. Questa categoria include il traffico diretto verso un video e il traffico sulle app mobile.NOTIFICATION
- Le visualizzazioni del video sono state inviate da un'email o da una notifica di YouTube.PLAYLIST
- Le visualizzazioni del video si sono verificate durante la riproduzione del video all'interno di una playlist. Include il traffico proveniente dalla pagina della playlist.PRODUCT_PAGE
: le visualizzazioni del video sono state indirizzate dalla pagina di un prodotto.PROMOTED
- Le visualizzazioni del video sono state segnalate da una promozione di YouTube non a pagamento, come i "Video del momento" di YouTube .RELATED_VIDEO
- Le visualizzazioni del video sono state indirizzate da un elenco di video correlato in un'altra pagina di visualizzazione del video. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
specifica l'ID del video.SHORTS
– Lo spettatore è stato invitato facendo scorrere il dito in verticale dal video precedente nell'esperienza di visualizzazione degli Short.SOUND_PAGE
– Visualizzazioni provenienti dalle pagine pivot dell'audio di Shorts.SUBSCRIBER
- Le visualizzazioni del video sono state generate dai feed sulla home page di YouTube o dalle funzionalità di iscrizione di YouTube. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
consente di specificare gli elementi del feed della home page o un'altra pagina da cui provengono le visualizzazioni.YT_CHANNEL
- Le visualizzazioni del video si sono verificate sulla pagina di un canale. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
specifica l'ID del canale in questione.YT_OTHER_PAGE
- Le visualizzazioni del video sono state segnalate da un link diverso da un risultato di ricerca o dal link a un video correlato che appare su una pagina di YouTube. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
identifica la pagina.YT_SEARCH
- Le visualizzazioni del video sono state generate dai risultati di ricerca di YouTube. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
specifica il termine di ricerca.VIDEO_REMIXES
– Le visualizzazioni del video sono state generate dal link del video remixato nel player di Shorts. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
consente di specificare il video da cui viene indirizzato lo spettatore.
- insightTrafficSourceDetail
- I dati del report sono aggregati in base ai referrer che hanno generato il maggior numero di visualizzazioni per un determinato video e un determinato tipo di sorgente di traffico. Il seguente elenco identifica le sorgenti di traffico per le quali è disponibile questo report. Per ogni sorgente di traffico, l'elenco identifica le informazioni fornite dalla dimensione
insightTrafficSourceDetail
.ADVERTISING
– Il tipo di pubblicità che ha generato visualizzazioni. I valori possibili sono:- Annuncio di coinvolgimento click-to-play
- Annuncio di coinvolgimento
- Annunci della rete di ricerca di Google
- Annuncio video sulla home page
- In-stream ignorabile prenotato
- TrueView in-search e in-display
- TrueView in-stream
- Pubblicità su YouTube senza categoria
- Video wall
CAMPAIGN_CARD
- Il video rivendicato che ha indirizzato gli spettatori al video identificato nel report.END_SCREEN
- Il video che ha indirizzato gli spettatori al video identificato nel report.EXT_URL
- Il sito web che ha indirizzato gli spettatori al video.HASHTAGS
– L'hashtag che ha generato le visualizzazioni.NOTIFICATION
- L'email o la notifica che ha indirizzato il traffico.RELATED_VIDEO
- Il video correlato che ha indirizzato gli spettatori al video trattato nel report.SOUND_PAGE
– Il video che ha generato visualizzazioni.SUBSCRIBER
- L'elemento del feed della home page o la funzionalità di iscrizione a YouTube che ha indirizzato gli spettatori al video trattato nel report. I valori validi sono:activity
– Visualizzazioni da elementi nei feed Iscrizioni sulla home page derivanti da attività non legate ai caricamenti e non social, tra cui Mi piace, preferiti, post di bollettini e aggiunte a playlist.blogged
– Visualizzazioni provenienti dagli elementi nei feed Iscrizioni sulla home page derivanti da link dei principali blog.mychannel
– Visualizzazioni da elementi in altri feed elencati nella home page, ad esempio "Mi piace", "Cronologia delle visualizzazioni" e "Guarda più tardi".podcasts
- Visualizzazioni provenienti da elementi nella pagina di destinazione Podcast.sdig
– Visualizzazioni provenienti dalle email di aggiornamento delle iscrizioni.uploaded
- Visualizzazioni dagli elementiuploaded
nei feed Iscrizioni sulla home page./
- Altre visualizzazioni provenienti dalla home page di YouTube./my_subscriptions
– Visualizzazioni provenienti dagli utenti Nelle pagine Le mie iscrizioni su YouTube.
YT_CHANNEL
- La pagina del canale in cui gli spettatori hanno guardato il video.YT_OTHER_PAGE
- La pagina di YouTube da cui gli spettatori sono stati indirizzati al video.YT_SEARCH
- Il termine di ricerca che ha indirizzato gli spettatori al video.VIDEO_REMIXES
– Il video che ha generato visualizzazioni.
Esempi
Le seguenti richieste di esempio utilizzano le dimensioni delle sorgenti di traffico:
Esempi di canali
-
Sorgente di traffico
- .
- Numero di visualizzazioni e tempo di visualizzazione da diverse sorgenti di traffico in un paese
- Numero di visualizzazioni e tempo di visualizzazione giornalieri da diverse sorgenti di traffico.
- Top 10: termini di ricerca di YouTube che generano il maggior volume di traffico per un video
- Top 10: termini di ricerca di Google che generano il maggior volume di traffico per un video
- Numero di visualizzazioni della playlist e tempo di visualizzazione da diverse sorgenti di traffico in un paese
- Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse sorgenti di traffico.
-
Sorgente di traffico
Esempi di proprietari dei contenuti
-
Sorgente di traffico
- .
- Numero di visualizzazioni e tempo di visualizzazione da diverse sorgenti di traffico.
- Numero di visualizzazioni e tempo di visualizzazione giornalieri da diverse sorgenti di traffico.
- Top 10: termini di ricerca di YouTube che generano il maggior volume di traffico per un video
- Top 10: termini di ricerca di Google che generano il maggior volume di traffico per un video
- Numero di visualizzazioni della playlist e tempo di visualizzazione da diverse sorgenti di traffico in un paese
- Numero di visualizzazioni e tempo di visualizzazione giornalieri delle playlist da diverse sorgenti di traffico.
-
Sorgente di traffico
Dispositivi
- deviceType
- Questa dimensione identifica il fattore di forma fisico del dispositivo su cui è avvenuta la visualizzazione.
Il seguente elenco identifica i tipi di dispositivi per i quali l'API restituisce i dati. Puoi anche utilizzare la dimensione
deviceType
come filtro per limitare un report del sistema operativo in modo che contenga solo i dati relativi a un tipo specifico di dispositivo.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- Questa dimensione identifica il sistema software del dispositivo su cui è avvenuta la visualizzazione.
Il seguente elenco identifica i sistemi operativi per cui l'API restituisce i dati. Puoi anche utilizzare
operatingSystem
come filtro per limitare un report sul tipo di dispositivo in modo che contenga solo i dati relativi a un sistema operativo specifico.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
Esempi
Le seguenti richieste di esempio utilizzano le dimensioni del dispositivo:
Esempi di canali
-
Dispositivo/sistema operativo
- .
- Metriche giornaliere sul tipo di dispositivo per il sistema operativo Android
- Metriche giornaliere del sistema operativo per i dispositivi mobili
- Metriche giornaliere del sistema operativo e del tipo di dispositivo
- Metriche giornaliere del tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android
- Metriche giornaliere del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili
-
Dispositivo/sistema operativo
Esempi di proprietari dei contenuti
-
Dispositivo/sistema operativo
- .
- Metriche giornaliere del tipo di dispositivo per i video rivendicati
- Metriche giornaliere del sistema operativo relative ai video rivendicati visualizzati su dispositivi mobili
- Metriche giornaliere del sistema operativo e del tipo di dispositivo
- Metriche giornaliere del tipo di dispositivo per le visualizzazioni di playlist sul sistema operativo Android
- Metriche giornaliere del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili
-
Dispositivo/sistema operativo
Dati demografici
Le dimensioni demografiche ti aiutano a comprendere la distribuzione del tuo pubblico in base all'età e al genere. Il Centro assistenza YouTube contiene ulteriori informazioni sui dati demografici nei report YouTube Analytics.
- ageGroup (dimensione principale)
- Questa dimensione identifica l'età degli utenti che hanno eseguito l'accesso associate ai dati del report. L'API utilizza le seguenti fasce d'età:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (dimensione principale)
- Questa dimensione identifica il genere degli utenti che hanno eseguito l'accesso associati ai dati del report.
I valori validi sono
female
,male
euser_specified
. This is a core dimension and is subject to the Deprecation Policy.
Esempi
Le seguenti richieste di esempio utilizzano le dimensioni demografiche:
Esempi di canali
-
Dati demografici
- .
- Dati demografici degli spettatori in California (età e genere)
- Dati demografici degli spettatori delle playlist in California (età e genere)
-
Dati demografici
Esempi di proprietari dei contenuti
-
Dati demografici
- .
- Dati demografici degli spettatori in California (età e genere)
- Dati demografici degli spettatori delle playlist in California (età e genere)
-
Dati demografici
Coinvolgimento e condivisione dei contenuti
- sharingService (dimensione principale)
- Questa dimensione identifica il servizio utilizzato per condividere i video. I video possono essere condivisi su YouTube (o tramite il player di YouTube) mediante la scheda "Condividi" . This is a core dimension and is subject to the Deprecation Policy.
La seguente tabella elenca i valori di dimensione validi:
Servizio di condivisione Valore API Ameba AMEBA
Email Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Messaggistica Android ANDROID_MMS
Messenger mora BBM
Blogger BLOGGER
Copia negli appunti COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Incorpora EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Pagine Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Passa a SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Messaggio di testo HTC HTC_MMS
Posta in arrivo di Google INBOX
Finestra di dialogo dell'attività del sistema iOS IOS_SYSTEM_ACTIVITY_DIALOG
Storia di KAKAO KAKAO_STORY
Kakao KAKAO
Kik KIK
Email LGE LGE_EMAIL
Linea LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Mename MENEAME
mixi MIXI
Messaggistica Motorola MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Condivisione nelle vicinanze NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki ODNOKLASSNIKI
Altro OTHER
Pinterest PINTEREST
Rakuten (楽天 Dato場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Conversazioni Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Sconosciuto UNKNOWN
Messaggi Verizon VERIZON_MMS
Viber VIBER
VKontakte VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japan YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Per ulteriori informazioni, consulta la documentazione del Centro assistenza.
Esempi
Le seguenti richieste di esempio utilizzano dimensioni social:
Esempi di canali
- Social: metriche di condivisione, aggregate per servizio in cui sono stati condivisi i video
Esempi di proprietari dei contenuti
- Social: metriche di condivisione, aggregate per servizio in cui sono stati condivisi i video
Fidelizzazione del pubblico
- elapsedVideoTimeRatio
- Questa dimensione specifica il rapporto tra la parte trascorsa del video e la durata del video. Le dimensioni e le metriche di fidelizzazione vengono utilizzate per misurare la fidelizzazione del pubblico nel tempo e la dimensione
elapsedVideoTimeRatio
è la misurazione del tempo. Ad esempio, un valore0.4
indica che i dati del report corrispondenti mostrano dati di conservazione una volta trascorso il 40% del video.
L'API restituisce 100 punti dati per ogni video con valori di rapporto compresi tra0.01
e1.0
. Gli orari in cui i dati vengono misurati durante le riproduzioni video hanno la stessa spaziatura per ogni video. Ciò significa che, per un video di due minuti, l'intervallo tra i punti dati è di 1,2 secondi. Tuttavia, per un video di due ore, l'intervallo tra i punti dati è di 72 secondi. Il valore della dimensione indica la fine esclusiva dell'intervallo. - audienceType (solo filtro)
- Il valore della dimensione identifica il tipo di traffico associato ai dati del report.
I valori supportati sono
ORGANIC
,AD_INSTREAM
eAD_INDISPLAY
. Consulta il Centro assistenza YouTube per spiegazioni su questi tipi di sorgenti di traffico.
Tieni presente che i dati del filtroaudienceType
sono disponibili dal 25 settembre 2013. L'API non restituisce dati per le query che utilizzano il filtro per cercare di recuperare dati da date precedenti. Le query che non utilizzano il filtro funzionano per qualsiasi data successiva al 1° luglio 2008.
Esempi
Le seguenti richieste di esempio utilizzano le dimensioni di fidelizzazione del pubblico:
Esempi di canali
- Fidelizzazione del pubblico: metriche sulla fidelizzazione del pubblico per un video.
Esempi di proprietari dei contenuti
- Fidelizzazione del pubblico: metriche sulla fidelizzazione del pubblico per un video.
Live streaming
- livestreamPosition
- Questa dimensione specifica un minuto specifico durante uno stream video in diretta. Metriche del report indicare quanti utenti stavano guardando il live streaming in quel momento.
Annullamenti di abbonamenti
- membershipsCancellationSurveyReason
- Il numero di sondaggi completati dagli utenti di YouTube che hanno annullato l'abbonamento al canale per
canale specificato durante il periodo del report. La seguente tabella elenca i valori delle dimensioni validi:
Valore API Spiegazione UNKNOWN
L'utente non ha completato il sondaggio. DISLIKE_PERKS
All'utente non sono piaciuti i vantaggi dell'abbonamento. PERKS_NOT_DELIVERED
L'utente ha dichiarato che i vantaggi dell'abbonamento promessi non sono stati consegnati. CANNOT_ACCESS_PERKS
L'utente non è riuscito ad accedere ai vantaggi. NO_LONGER_INTERESTED
L'utente non è più interessato agli abbonamenti al canale. FEEL_UNAPPRECIATED
L'utente non ha percepito apprezzamento come abbonato al canale. FINANCIAL_REASONS
L'utente ha annullato l'abbonamento per motivi finanziari. JOIN_LIMITED_TIME
L'utente intendeva partecipare solo per un periodo di tempo limitato. OTHER
L'utente aveva un altro motivo per l'annullamento.
Rendimento degli annunci
- adType
- La dimensione
adType
viene utilizzata nei report sul rendimento degli annunci e aggrega le metriche richieste in base ai tipi di annunci pubblicati durante le riproduzioni dei video. Il seguente elenco illustra i possibili valori delle dimensioni. Per ulteriori informazioni sui formati pubblicitari di YouTube, consulta il Centro assistenza YouTube.
-
auctionBumperInstream
: annunci video non ignorabili, pubblicati tramite asta, della durata massima di 6 secondi che devono essere guardati prima di poter visualizzare il video. -
auctionDisplay
– Un annuncio rich media o illustrato che viene visualizzato come overlay nella parte inferiore del video player, come unità pubblicitaria 300 x 250 nella pagina di visualizzazione del video o come combinazione di entrambi. Quando viene eseguito, l'overlay si chiude automaticamente dopo essere stato visualizzato per un determinato periodo di tempo e l'utente può a sua volta chiuderlo. Se un overlay e un banner vengono visualizzati insieme, ciascun annuncio viene conteggiato come un'impressione separata. -
auctionInstream
: annunci video non ignorabili che vengono pubblicati prima, durante o dopo il video principale. -
auctionTrueviewInslate
– Lo spettatore sceglie uno dei vari annunci video tra una serie di opzioni visualizzate prima di un video. See the TrueView documentation for more information. -
auctionTrueviewInstream
: annunci video ignorabili che vengono pubblicati prima o durante il video principale. Per ulteriori informazioni, consulta la documentazione TrueView. -
auctionUnknown
: un annuncio acquistato tramite l'asta di AdWords, ma che non è stato classificato negli altri tipi di annunci. -
reservedBumperInstream
: annunci video non ignorabili, venduti su prenotazione, della durata massima di 6 secondi che devono essere guardati prima di poter visualizzare il video. -
reservedClickToPlay
- Un annuncio video su cui l'utente deve fare clic per avviare la riproduzione. Viene registrata un'impressione dell'annuncio ogni volta che viene visualizzata l'unità pubblicitaria click-to-play, indipendentemente dal fatto che l'utente avvii o meno una riproduzione. Vengono venduti su prenotazione. -
reservedDisplay
– Un annuncio rich media o illustrato che viene visualizzato come overlay nella parte inferiore del video player, come unità pubblicitaria 300 x 250 nella pagina di visualizzazione del video o come combinazione di entrambi. Quando viene eseguito, l'overlay si chiude automaticamente dopo essere stato visualizzato per un determinato periodo di tempo e l'utente può a sua volta chiuderlo. Se un overlay e un banner vengono visualizzati insieme, ciascun annuncio viene conteggiato come un'impressione separata. -
reservedInstream
: annunci video non ignorabili che vengono inseriti prima, durante o dopo il video principale. -
reservedInstreamSelect
-
reservedMasthead
: un annuncio di grandi dimensioni, che può includere video ed elementi grafici, visualizzato nella home page. -
reservedUnknown
: un annuncio venduto su base riservata che non ha potuto essere classificato in uno degli altri tipi di annuncio. -
unknown
- YouTube non ha potuto classificare questo tipo di annuncio.
-
Esempi
I seguenti report di esempio recuperano le metriche sul rendimento degli annunci o sulle entrate:
Esempi di canali
-
Entrate/Annunci
- .
- Metriche relative alle entrate del canale e al rendimento degli annunci
- Metriche sulle entrate giornaliere e sul rendimento degli annunci
- Metriche specifiche per paese sulle entrate e sul rendimento degli annunci
- Top 10: video dalle entrate maggiori
- Metriche sul rendimento degli annunci per tipi di annunci diversi
-
Entrate/Annunci
Esempi di proprietari dei contenuti
-
Entrate/Annunci
- .
- Metriche relative a entrate e rendimento degli annunci per i contenuti rivendicati
- Metriche sulle entrate giornaliere e sul rendimento degli annunci
- Metriche specifiche per paese sulle entrate e sul rendimento degli annunci
- Top 10: video dalle entrate maggiori
- Metriche sul rendimento degli annunci per tipi di annunci diversi
-
Entrate/Annunci
Playlist
- isCurated (solo filtro)
- Questo filtro indica che la richiesta sta recuperando dati sulle visualizzazioni video avvenute nella contesto di una playlist.
Esempi
Tutte le richieste di esempio che recuperano i report sulle playlist utilizzano il filtro isCurated
.
Dimensioni del proprietario dei contenuti
Le seguenti dimensioni sono supportate solo per i report sui proprietari dei contenuti.
- rivendicatoStatus (utilizzato solo nei report dei proprietari dei contenuti)
- Questa dimensione ti consente di indicare che una risposta dell'API deve contenere solo metriche relative ai contenuti rivendicati. L'unico valore valido per questa dimensione è
claimed
. Se il parametrofilters
limita la query aclaimedStatus==claimed
, l'API recupererà solo i dati per i contenuti rivendicati. La tabella nella definizione della dimensioneuploaderType
fornisce ulteriori dettagli su come utilizzare questa dimensione.
- uploaderType (dimensione principale) (utilizzato solo nei report dei proprietari dei contenuti)
- Questa dimensione ti consente di indicare se una risposta dell'API deve contenere metriche relative ai contenuti caricati dal proprietario dei contenuti specificato e/o ai contenuti caricati da terze parti, ad esempio quelli caricati dagli utenti. I valori validi sono
self
ethirdParty
. Questa è una dimensione principale ed è soggetta alle norme sul ritiro.
La tabella seguente mostra le combinazioni supportate per le dimensioniclaimedStatus
euploaderType
, entrambe utilizzate nel parametrofilters
:
Valore claimedStatus
Valore uploaderType
Descrizione [Non impostato] me stesso Consente di recuperare i dati di YouTube Analytics relativi ai contenuti rivendicati e non rivendicati caricati dal proprietario dei contenuti. rivendicati [Non impostato] Consente di recuperare i dati relativi ai contenuti rivendicati caricati dal proprietario dei contenuti o da una terza parte. rivendicati me stesso Recupera i dati relativi ai contenuti rivendicati caricati dal proprietario dei contenuti. rivendicati thirdParty Recupera i dati relativi ai contenuti rivendicati caricati da una terza parte.
Esempi
Molte delle richieste API di esempio per i report sui proprietari dei contenuti utilizzano una combinazione supportata delle dimensioni claimedStatus
e uploaderType
per filtrare i dati.