Dimensions

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 i dati, ad esempio la data in cui si è verificata l'attività utente o il paese in cui si trovava gli utenti.

Ogni report sulle query identifica le dimensioni supportate. Ad esempio, quando recuperi l'attività utente in base all'ora, puoi scegliere il periodo di tempo durante il quale verranno generati i dati nei report: giorno o mese. In qualsiasi report, ogni riga di dati presenta una combinazione univoca di valori di dimensione.

Per recuperare un report sulle query, chiama il metodo reports.query dell'API YouTube Analytics. Nella richiesta, utilizza il parametro dimensions per specificare le dimensioni che YouTube utilizzerà per calcolare i valori delle metriche nei report.

Dimensioni principali

Sebbene l'API YouTube Analytics sia soggetta alle Norme sul ritiro definite nei Termini di servizio, le dimensioni non principali (e le metriche non principali) non sono soggette a queste norme. Nelle definizioni di questa pagina, qualsiasi dimensione principale viene identificata esplicitamente come tale.

Il seguente elenco identifica le dimensioni principali dell'API.

Per saperne di più, 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 da includere solo i dati che corrispondono a un determinato valore o insieme di valori. Ad esempio, anziché recuperare le metriche relative all'attività utente per tutti i paesi, puoi utilizzare un filtro per recuperare solo i dati per un determinato paese.

In una richiesta di recupero di un report sulle query, il parametro facoltativo di richiesta filters specifica i valori delle dimensioni per i quali vuoi filtrare i dati. Ad esempio, per recuperare le metriche relative all'attività utente per l'Europa, devi impostare il valore parametro filters su continent==150.

Importante: le richieste API per recuperare i report sui proprietari dei contenuti devono filtrare i dati utilizzando una delle dimensioni entità report o una combinazione supportata di dimensioni claimedStatus e uploaderType.

Dimensioni

Le seguenti sezioni definiscono le dimensioni utilizzate nei report sulle query dell'API YouTube Analytics. Se non diversamente indicato, queste dimensioni vengono utilizzate in entrambi i report Canale e Proprietario dei contenuti. Sono state identificate anche le dimensioni che possono essere utilizzate solo come filtri.

Risorse

Queste dimensioni corrispondono alle risorse gestite da canali e proprietari dei contenuti su YouTube:

Nota:l'API consente di specificare più valori per le dimensioni video, playlist e channel quando vengono utilizzate come filtri. Per farlo, imposta il valore del parametro filters su un elenco separato da virgole degli ID video, playlist o canali 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 di dati di YouTube, questo è il valore della proprietà id di una risorsa video. This is a core dimension and is subject to the Deprecation Policy.
playlist
L'ID di una playlist di YouTube. Nell'API di dati di YouTube, questo è il valore della proprietà id di una risorsa playlist.
canale (dimensione principale) (utilizzata solo nei report dei proprietari dei contenuti)
L'ID di un canale YouTube. Nell'API di dati di YouTube, questo è il valore della proprietà id di una risorsa channel. This is a core dimension and is subject to the Deprecation Policy.

La dimensione channel viene utilizzata spesso nei report dei proprietari dei contenuti perché questi report in genere aggregano dati per più canali.
group (solo filtro)
L'ID di un gruppo di YouTube Analytics. Puoi recuperare questo valore utilizzando il metodo groups.list dell'API YouTube Analytics. Quando utilizzi il filtro group, la risposta dell'API contiene dati relativi a tutti i video, le playlist o i canali di quel gruppo.

Esempi

Le seguenti richieste di esempio utilizzano dimensioni o filtri dell'entità report:

  • Esempi di canali

    • Statistiche di base
      • Top 10 - I video più guardati di un canale
      • Top 10 - Percentuali di clic sulle annotazioni relative ai video più visti di un canale
      • Statistiche per una playlist specifica
      • Top 10 - Playlist più viste su un canale
    • Area geografica
      • Top 10 - Video più visti in un paese specifico
      • Top 10 – Video più visti in Europa

  • Esempi di proprietari dei contenuti

    • Statistiche di base
      • Top 10 - I video più visti per un proprietario di contenuti
      • Top 10 - I video più guardati per un proprietario di contenuti
      • Top 10 - I video più visti sul canale di un proprietario di contenuti
      • Top 10 - Percentuali di clic sulle annotazioni relative ai video più visti di un canale
      • Top 10 - Playlist più guardate per un proprietario di contenuti
    • Area geografica
      • Top 10 - I video più guardati in Europa per un proprietario di contenuti
      • Top 10 - Playlist più iniziate negli Stati Uniti

Aree geografiche

Queste dimensioni identificano un'area geografica associata a 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 di due lettere, ad esempio US, CN (Cina) o FR (Francia). Il codice paese ZZ viene utilizzato per generare report sulle metriche per le quali YouTube non ha potuto 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) o US-TX (Texas). Il codice provincia US-ZZ viene utilizzato per segnalare le metriche per le quali YouTube non ha potuto identificare lo stato degli Stati Uniti associato. Quando una richiesta API include province nel valore del parametro dimensions, la richiesta deve anche limitare i dati agli Stati Uniti includendo country==US nel valore parametro filters.

Nota: questa dimensione non supporta i valori ISO 3166-2 che identificano le aree 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.

city
La città stimata associata alle metriche nella riga del report. I dati per questa dimensione sono disponibili per le date a partire dal 1° gennaio 2022.
continent (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
Questa dimensione può essere utilizzata solo per filtrare i dati. Per utilizzare questa dimensione, imposta il valore del parametro filters su continent==REGION_CODE, specificando un valore REGION_CODE dall'elenco precedente.
subContinent (solo filtro)
Un codice statistico delle Nazioni Unite che identifica una sottoregione geografica. La Divisione statistica delle Nazioni Unite elenca le sottoregioni e i paesi ad essi associati.

Questa dimensione può essere utilizzata solo per filtrare i dati. Per utilizzare questa dimensione, imposta il valore del parametro filters su subContinent==REGION_CODE, specificando un valore REGION_CODE dall'elenco delle Nazioni Unite.

Esempi

Le seguenti richieste di esempio utilizzano dimensioni geografiche o filtri:

  • Esempi di canali

    • Statistiche di base: numero di visualizzazioni specifiche per paese (e altro ancora) di un canale
    • Area geografica
      • Metriche relative al tempo di visualizzazione specifiche per paese per i video di un canale
      • Metriche relative alle annotazioni specifiche per paese per i video di un canale
      • Metriche specifiche per provincia per gli stati USA e Washington D.C.
      • Metriche relative al 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 giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione.
    • Sorgente di traffico: numero di visualizzazioni e tempo di visualizzazione provenienti da diverse sorgenti di traffico di un paese.
    • Dati demografici: dati demografici degli spettatori in California (età e genere)
    • Video principali
      • Top 10 - Video più visti in un paese specifico
      • Top 10 – Video più visti in Europa

  • Esempi di proprietari dei contenuti

    • Statistiche di base: numero di visualizzazioni specifiche per paese (e altro ancora) per tutti i video caricati autonomamente
    • Area geografica
      • Metriche relative al tempo di visualizzazione specifiche per paese per i contenuti caricati autonomamente
      • Metriche di annotazione specifiche per paese per i contenuti caricati autonomamente
      • Metriche specifiche per provincia per gli stati USA e Washington D.C.
      • Metriche relative al 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 giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione.
    • Dati demografici: dati demografici degli spettatori in California (età e genere)
    • Video principali. I 10 video più guardati in Europa per un proprietario di contenuti
    • Entrate/Rendimento degli annunci: metriche relative alle entrate e al rendimento degli annunci specifiche per paese.

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 in realtà restituisce i dati fino all'ultimo giorno per cui tutte le metriche specificate nella richiesta sono disponibili al momento della 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) nel giorno, nel mese e nell'anno specificati. Di conseguenza, le date in cui gli orologi vengono regolati in avanti per l'ora legale rappresentano un periodo di 23 ore, mentre le date in cui gli orologi vengono regolati 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 i 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 in base al 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 nel report sono 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 in formato YYYY-MM.

Nota: se la query API utilizza la dimensione month, i parametri start-date e end-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 sul tempo di visualizzazione dei video di un canale
      • Metriche giornaliere relative alle annotazioni per i video di un canale
      • Visualizzazioni giornaliere delle playlist di un canale
    • Luogo di visualizzazione: numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione.
    • Sorgente di traffico: numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico.
    • Dispositivo/sistema operativo
      • Metriche giornaliere relative al tipo di dispositivo per il sistema operativo Android
      • Metriche giornaliere del sistema operativo per i dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo

  • Esempi di proprietari dei contenuti

    • In base al tempo
      • Metriche giornaliere sul tempo di visualizzazione per i contenuti caricati autonomamente
      • Metriche relative alle annotazioni per i contenuti rivendicati
      • Visualizzazioni giornaliere di playlist per un proprietario dei contenuti
    • Luogo di visualizzazione: numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione.
    • Sorgente di traffico: numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico.
    • Dispositivo/sistema operativo
      • Metriche giornaliere relative al tipo di dispositivo per i video rivendicati
      • Metriche giornaliere del sistema operativo per i video rivendicati visualizzati sui dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo
    • Entrate/Rendimento degli annunci: metriche relative alle entrate giornaliere e al rendimento degli annunci.

Luoghi di visualizzazione

Queste dimensioni forniscono informazioni sulla pagina o sull'applicazione in cui si è verificata l'attività utente.

insightPlaybackLocationType
I dati nel report sono 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 nella 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 che si sono verificate su una pagina canale.

  • EMBEDDED – I dati descrivono le visualizzazioni avvenute su un altro sito web o su un'altra applicazione in cui il video è stato incorporato utilizzando un incorporamento di tipo <iframe> o <object>.

  • EXTERNAL_APP – I dati descrivono le visualizzazioni avvenute in un'applicazione di terze parti in cui il video è stato riprodotto con un metodo diverso dall'incorporamento <iframe> o <object>. Ad esempio, le riproduzioni nelle applicazioni che utilizzano l'API YouTube Android Player sono categorizzate utilizzando questo valore.

  • MOBILE - I dati descrivono le visualizzazioni avvenute sul sito web mobile di YouTube o sui client approvati dell'API di YouTube, inclusi i dispositivi mobili.

    A partire dal 10 settembre 2013, le riproduzioni non sono più classificate come MOBILE riproduzioni nei report di YouTube Analytics. Il valore potrebbe rimanere nei report poiché i dati precedenti rientrano ancora in questa categoria. Tuttavia, a partire da questa data, le riproduzioni su dispositivi mobili vengono classificate come WATCH, EMBEDDED o EXTERNAL_APP, a seconda del tipo di applicazione in cui vengono eseguite le riproduzioni.

  • SEARCH - I dati descrivono le visualizzazioni che hanno avuto luogo direttamente nella pagina dei risultati di ricerca di YouTube.

  • WATCH - I dati descrivono le visualizzazioni che si sono verificate sulla pagina di visualizzazione di YouTube del video o in un'applicazione YouTube ufficiale, come l'app YouTube per Android.

  • YT_OTHER - I dati descrivono le visualizzazioni che non sono classificate in altro modo.

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 avvenute nei player incorporati e identifica i player incorporati che hanno generato il maggior numero di visualizzazioni per un video specifico. Pertanto, fornisce una visualizzazione più granulare rispetto al report sul luogo di visualizzazione identificando gli URL o le applicazioni associati ai principali player incorporati.

Esempi

Le seguenti richieste di esempio utilizzano le dimensioni relative al luogo di riproduzione:

  • Esempi di canali

    • Luogo di visualizzazione
      • Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione
      • Primi 10 siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
      • Numero di visualizzazioni delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione

  • Esempi di proprietari dei contenuti

    • Luogo di visualizzazione
      • Numero di visualizzazioni e tempo di visualizzazione da diverse posizioni di riproduzione
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse posizioni di riproduzione
      • Primi 10 siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
      • Numero di visualizzazioni delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diverse posizioni di riproduzione

Dettagli riproduzione

creatorContentType
Questa dimensione identifica il tipo di contenuti associati alle metriche sull'attività utente nella riga di dati. I dati per questa dimensione sono disponibili per le date 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 un video di YouTube che non rientrano in uno degli altri valori di dimensione.
UNSPECIFIED Il tipo di contenuti dei contenuti visualizzati è sconosciuto.
liveOrOnDemand
Questa dimensione indica se le metriche sull'attività utente nella riga dei 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 che non si è verificata durante una trasmissione dal vivo.
subscribedStatus
Questa dimensione indica se le metriche relative all'attività utente nella riga dei dati sono associate agli spettatori che si sono iscritti al canale del video o della playlist. I valori possibili sono SUBSCRIBED e UNSUBSCRIBED.

Tieni presente che il valore della dimensione è preciso a partire dal momento in cui si verifica l'attività utente. Ad esempio, supponi che un utente non si sia iscritto a un canale e guardi uno dei video di tale canale, quindi si iscriva al canale e guardi un altro video, il tutto nello stesso giorno. Il report del canale indica che una vista ha un valore subscribedStatus pari a SUBSCRIBED e una vista ha un valore subscribedStatus pari a UNSUBSCRIBED.
youtubeProduct
Questa dimensione identifica il servizio YouTube su cui si è verificata l'attività utente. I dati per questa dimensione sono disponibili a partire dal 18 luglio 2015.

La seguente tabella elenca i valori delle dimensioni:
Valori
CORE Le attività utente che non si sono verificate in una delle applicazioni YouTube speciali (YouTube Gaming, YouTube Kids o YouTube Music). Eccezione: le attività utente 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 nel 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 una pubblicità. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica il tipo di annuncio.
  • ANNOTATION - Gli spettatori hanno raggiunto il video facendo clic su un'annotazione in un altro video.
  • CAMPAIGN_CARD - Visualizzazioni provenienti dai video rivendicati caricati dagli utenti e utilizzati dal proprietario dei contenuti per promuovere i contenuti visualizzati. Questa sorgente di traffico è supportata solo per i report sui proprietari dei contenuti.
  • END_SCREEN - Le visualizzazioni provengono dalla schermata finale di un altro video.
  • EXT_URL - Le visualizzazioni di video sono state indirizzate da un link su un altro sito web. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica la pagina web. Questa sorgente di traffico include i referral provenienti dai risultati di ricerca di Google.
  • HASHTAGS – Visualizzazioni provenienti dalle pagine VOD con hashtag o dalle pagine pivot degli hashtag di Shorts.
  • LIVE_REDIRECT - Le visualizzazioni di video sono state indirizzate da Live Redirect.
  • NO_LINK_EMBEDDED - Durante la visualizzazione, il video è stato incorporato in un altro sito web.
  • NO_LINK_OTHER - YouTube non ha identificato un referrer per il traffico. Questa categoria include il traffico diretto a un video e il traffico su app mobile.
  • NOTIFICATION - Le visualizzazioni di video sono state inviate tramite un'email o una notifica di YouTube.
  • PLAYLIST - Le visualizzazioni del video sono state generate durante la riproduzione del video nell'ambito di una playlist. Include il traffico proveniente dalla pagina della playlist.
  • PRODUCT_PAGE: le visualizzazioni di video sono state indirizzate da una pagina di prodotto.
  • PROMOTED - Le visualizzazioni di video provengono da una promozione YouTube non a pagamento, come la pagina "Video del momento" di YouTube.
  • RELATED_VIDEO - Le visualizzazioni di video sono state generate da un video correlato su un'altra pagina di visualizzazione del video. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica l'ID video del video.
  • SHORTS - Nell'esperienza di visualizzazione di Shorts, lo spettatore è stato mostrato agli spettatori scorrendo in verticale dal video precedente.
  • SOUND_PAGE – Visualizzazioni provenienti dalle pagine pivot dell'audio di Shorts.
  • SUBSCRIBER - Le visualizzazioni di video provengono dai feed sulla home page di YouTube o dalle funzionalità di iscrizione di YouTube. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica gli elementi del feed della home page o un'altra pagina da cui provengono le visualizzazioni.
  • YT_CHANNEL - Le visualizzazioni del video sono avvenute su una pagina canale. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica l'ID del canale in questione.
  • YT_OTHER_PAGE - Le visualizzazioni di video sono state generate da un link diverso da un risultato di ricerca o da un link a un video correlato presente in una pagina di YouTube. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica la pagina.
  • YT_SEARCH - Le visualizzazioni di video sono state indirizzate a partire dai risultati di ricerca di YouTube. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica il termine di ricerca.
  • VIDEO_REMIXES - Le visualizzazioni di video sono state generate tramite il link al video remixato nel player di Shorts. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica il video da cui lo spettatore è stato indirizzato.
insightTrafficSourceDetail
I dati nel report vengono aggregati sulla base dei 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 annuncio che ha generato le 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
    • Videowall
  • 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 le visualizzazioni.
  • SUBSCRIBER - L'elemento del feed sulla home page o la funzionalità Iscrizioni di YouTube che ha indirizzato gli spettatori al video trattato nel report. I valori validi sono:
    • activity – Visualizzazioni dagli elementi nei feed delle iscrizioni sulla home page risultanti da attività sui canali non legate a caricamenti e non social, inclusi Mi piace, preferiti, post di bollettini e aggiunte a playlist.
    • blogged - Visualizzazioni dagli elementi nei feed delle iscrizioni sulla home page derivanti da link dei blog più popolari.
    • 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 dagli elementi nella pagina di destinazione Podcast.
    • sdig – Visualizzazioni provenienti dalle email di aggiornamento delle iscrizioni.
    • uploaded – Visualizzazioni dagli elementi uploaded nei feed Iscrizioni sulla home page.
    • / - Altre visualizzazioni provenienti dalla home page di YouTube.
    • /my_subscriptions – Visualizzazioni provenienti dalle pagine Le mie iscrizioni degli utenti 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 le 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 sorgenti di traffico diverse in un paese
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico
      • Top 10 - I termini di ricerca di YouTube che generano più traffico per un video
      • Top 10 – I termini di ricerca di Google che generano più traffico per un video
      • Il numero di visualizzazioni delle playlist e il tempo di visualizzazione provenienti da diverse sorgenti di traffico in un paese
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diverse sorgenti di traffico

  • Esempi di proprietari dei contenuti

    • Sorgente di traffico
      • Numero di visualizzazioni e tempo di visualizzazione da sorgenti di traffico diverse
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da diverse sorgenti di traffico
      • Top 10 - I termini di ricerca di YouTube che generano più traffico per un video
      • Top 10 – I termini di ricerca di Google che generano più traffico per un video
      • Il numero di visualizzazioni delle playlist e il tempo di visualizzazione provenienti da diverse sorgenti di traffico in un paese
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da diverse sorgenti 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 di dispositivo specifico.
  • 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 i quali 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 relative al tipo di dispositivo per il sistema operativo Android
      • Metriche giornaliere del sistema operativo per i dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo
      • Metriche giornaliere sul tipo di dispositivo per le visualizzazioni delle playlist sul sistema operativo Android
      • Metriche giornaliere del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili

  • Esempi di proprietari dei contenuti

    • Dispositivo/sistema operativo
      • Metriche giornaliere relative al tipo di dispositivo per i video rivendicati
      • Metriche giornaliere del sistema operativo per i video rivendicati visualizzati sui dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo
      • Metriche giornaliere sul tipo di dispositivo per le visualizzazioni delle playlist sul sistema operativo Android
      • Metriche giornaliere del sistema operativo per le visualizzazioni delle playlist sui dispositivi mobili

Dati demografici

Le dimensioni demografiche ti aiutano a capire la distribuzione del tuo pubblico in base all'età e al genere. Il Centro assistenza YouTube contiene informazioni aggiuntive sui dati demografici nei report di YouTube Analytics.

ageGroup (dimensione principale)
Questa dimensione identifica la fascia d'età degli utenti che hanno eseguito l'accesso e associati 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-
This is a core dimension and is subject to the Deprecation Policy.
gender (dimensione principale)
Questa dimensione identifica il genere degli utenti che hanno eseguito l'accesso e associati ai dati del report. I valori validi sono female, male e user_specified. This is a core dimension and is subject to the Deprecation Policy.

Esempi

Le seguenti richieste di esempio utilizzano 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)

  • 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)

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) utilizzando il pulsante "Condividi". This is a core dimension and is subject to the Deprecation Policy.

La seguente tabella elenca i valori delle dimensioni validi:
Servizio di condivisione Valore API
Ameba AMEBA
Email Android ANDROID_EMAIL
Messenger Android ANDROID_MESSENGER
Messaggistica Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Copia negli appunti COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Embed 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 su HTC HTC_MMS
Posta in arrivo di Google INBOX
Finestra di dialogo Attività del sistema iOS IOS_SYSTEM_ACTIVITY_DIALOG
Storia di KAKAO KAKAO_STORY
Kakao KAKAO
Kik KIK
Email LGE LGE_EMAIL
A linee LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame 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 (楽天Indietro場) RAKUTEN
reddit REDDIT
Skype SKYPE
Roccia artificiale 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 (VКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Migrazione dei sitelink di Yahoo! Giappone YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids: YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Per ulteriori informazioni, consulta i documenti del Centro assistenza.

Esempi

Le seguenti richieste di esempio utilizzano le 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. La dimensione elapsedVideoTimeRatio è la misurazione del tempo. Ad esempio, un valore 0.4 indica che i dati del report corrispondente mostrano i dati sulla fidelizzazione una volta trascorso il 40% del video.

L'API restituisce 100 punti dati per ogni video con valori di rapporto compresi tra 0.01 e 1.0. I momenti in cui i dati vengono misurati durante le riproduzioni video sono equidistanti 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 e AD_INDISPLAY. Consulta il Centro assistenza YouTube per una spiegazione di questi tipi di sorgenti di traffico.

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

Esempi

Le seguenti richieste di esempio utilizzano le dimensioni di fidelizzazione del pubblico:

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 video. Il seguente elenco illustra i possibili valori delle dimensioni. Consulta il Centro assistenza YouTube per ulteriori informazioni sui formati pubblicitari su YouTube.
  • auctionBumperInstream – Annunci video non ignorabili, posizionati tramite asta, della durata massima di 6 secondi che devono essere guardati per intero prima di poter visualizzare il video.

  • auctionDisplay - Un annuncio rich media o illustrato che appare come overlay nella parte inferiore del video player, come unità pubblicitaria 300 x 250 sulla pagina di visualizzazione del video o come una combinazione di entrambi. Quando l'overlay è in esecuzione, si chiude automaticamente dopo essere visualizzato per un determinato periodo di tempo e l'utente può anche chiudere l'overlay. Se un overlay e un banner vengono mostrati insieme, ogni annuncio viene conteggiato come un'impressione separata.

  • auctionInstream: annunci video non ignorabili pubblicati prima, durante o dopo il video principale.

  • auctionTrueviewInslate - Lo spettatore sceglie uno dei vari annunci video tra una serie di opzioni che vengono mostrate prima di un video. See the TrueView documentation for more information.

  • auctionTrueviewInstream – Annunci video ignorabili riprodotti prima o durante il video principale. Per ulteriori informazioni, consulta la documentazione di TrueView.

  • auctionUnknown – Un annuncio acquistato tramite l'asta di AdWords, ma che non è stato classificato in uno degli altri tipi di annunci.

  • reservedBumperInstream – Annunci video non ignorabili, venduti su prenotazione, della durata massima di 6 secondi che devono essere guardati per intero 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. Questi vengono venduti su prenotazione.

  • reservedDisplay - Un annuncio rich media o illustrato che appare come overlay nella parte inferiore del video player, come unità pubblicitaria 300 x 250 sulla pagina di visualizzazione del video o come una combinazione di entrambi. Quando l'overlay è in esecuzione, si chiude automaticamente dopo essere visualizzato per un determinato periodo di tempo e l'utente può anche chiudere l'overlay. Se un overlay e un banner vengono mostrati insieme, ogni 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 prenotazione che non è stato possibile classificare in uno degli altri tipi di annunci.

  • unknown - Impossibile classificare questo tipo di annuncio.

Esempi

I seguenti report di esempio consentono di recuperare le metriche sul rendimento degli annunci o sulle entrate:

  • Esempi di canali

    • Entrate/annunci
      • Metriche sulle entrate del canale e sul rendimento degli annunci
      • Metriche sulle entrate giornaliere e sul rendimento degli annunci
      • Metriche sulle entrate e sul rendimento degli annunci specifiche per paese
      • Top 10 – Video con le entrate più elevate
      • Metriche sul rendimento degli annunci per tipi di annunci diversi

  • Esempi di proprietari dei contenuti

    • Entrate/annunci
      • Metriche relative alle entrate e al rendimento degli annunci per i contenuti rivendicati
      • Metriche sulle entrate giornaliere e sul rendimento degli annunci
      • Metriche sulle entrate e sul rendimento degli annunci specifiche per paese
      • Top 10 – Video con le entrate più elevate
      • Metriche sul rendimento degli annunci per tipi di annunci diversi

Playlist

isCurated (solo filtro)
Questo filtro indica che la richiesta sta recuperando i dati sulle visualizzazioni video che si sono verificate nel contesto di una playlist. Questo filtro è obbligatorio per tutti i report sulle playlist e il relativo valore deve essere impostato su 1.

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 dei proprietari dei contenuti.

Importante:le richieste API per recuperare i report sui proprietari dei contenuti devono filtrare i dati utilizzando una delle seguenti dimensioni:
  • video
  • channel
  • Una combinazione supportata delle dimensioni claimedStatus e uploaderType come definita di seguito.
ClaimStatus (utilizzato solo nei report dei proprietari dei contenuti)
Questa dimensione consente di indicare che una risposta dell'API deve contenere solo metriche per i contenuti rivendicati. L'unico valore valido per questa dimensione è claimed. Se il parametro filters limita la query a claimedStatus==claimed, l'API recupererà solo i dati relativi ai contenuti rivendicati. La tabella nella definizione della dimensione uploaderType fornisce ulteriori dettagli su come utilizzare questa dimensione.
uploaderType (dimensione principale) (utilizzato solo nei report dei proprietari dei contenuti)
Questa dimensione consente di indicare se una risposta dell'API deve contenere metriche per i contenuti caricati dal proprietario dei contenuti specificato e/o per i contenuti caricati da terze parti, ad esempio i video caricati dagli utenti. I valori validi sono self e thirdParty. Questa è una dimensione principale ed è soggetta alle norme sul ritiro.

La tabella seguente mostra le combinazioni supportate per le dimensioni claimedStatus e uploaderType, utilizzate entrambe nel parametro filters:

Valore claimedStatus Valore uploaderType Descrizione
[Non impostato] te stesso Recupera i dati di YouTube Analytics per i contenuti rivendicati e non rivendicati caricati dal proprietario dei contenuti.
rivendicati [Non impostato] Recupera i dati per i contenuti rivendicati caricati dal proprietario dei contenuti o da una terza parte.
rivendicati te stesso Recupera i dati per i contenuti rivendicati caricati dal proprietario dei contenuti.
rivendicati thirdParty Recupera i dati per i 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.