Dimensions

Questo documento definisce le dimensioni supportate dall'API di 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 trovavano gli utenti.

Ogni report sulle query identifica le dimensioni supportate. Ad esempio, quando recuperi l'attività utente in base al tempo, scegli il periodo di tempo per cui verranno generati i report: 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 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 relative al ritiro definite nei Termini di servizio, le dimensioni e le metriche non principali non sono soggette a queste norme. Nelle definizioni di questa pagina, qualsiasi dimensione che è una dimensione di base è identificata esplicitamente come tale.

L'elenco seguente 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 a includere solo i dati corrispondenti 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 relativi a un determinato paese.

In una richiesta di recupero di un report sulle query, il parametro facoltativo della richiesta filters specifica i valori delle dimensioni per i quali vuoi filtrare i dati. Ad esempio, per recuperare le metriche sull'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 di contenuti devono filtrare i dati utilizzando una delle dimensioni delle 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 YouTube Analytics. Salvo diversamente specificato, queste dimensioni vengono utilizzate sia nei report per i canali sia in quelli per i proprietari dei contenuti. Vengono identificate anche le dimensioni che possono essere utilizzate solo come filtri.

Risorse

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

Nota:l'API ti 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 di ID video, playlist o canale per i quali deve essere filtrata la risposta dell'API. Il valore del parametro può specificare fino a 500 ID.

video (dimensione principale)
L'ID di un video di YouTube. Nell'API YouTube Data, si tratta del valore della proprietà id di una video 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, si tratta del valore della proprietà id di una risorsa playlist.
channel (dimensione principale) (utilizzata solo nei report per i proprietari di contenuti)
L'ID di un canale YouTube. Nell'API YouTube Data, si tratta del 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 di frequente nei report per i proprietari dei contenuti perché questi report in genere aggregano i dati di 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 i dati di tutti i video, le playlist o i canali del 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
      • Top 10: percentuali di clic sulle annotazioni per i video più guardati di un canale
      • Statistiche per una playlist specifica
      • Top 10: le playlist più guardate di un canale
    • Geografiche
      • Top 10: i video più visti in un paese specifico
      • Top 10: i video più visti in Europa

  • Esempi di proprietari di contenuti

    • Statistiche di base
      • Top 10: video più visti di un proprietario dei contenuti
      • Top 10: video più guardati di un proprietario dei contenuti
      • Top 10: video più visti del canale di un proprietario dei contenuti
      • Top 10: percentuali di clic sulle annotazioni per i video più guardati di un canale
      • Top 10: le playlist più guardate di un proprietario dei contenuti
    • Geografiche
      • Top 10: video più guardati in Europa per un proprietario di contenuti
      • Top 10: le playlist più ascoltate negli Stati Uniti

Aree geografiche

Queste dimensioni identificano una regione geografica associata all'attività utente, al rendimento degli annunci o alle metriche stimate relative alle entrate.

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 registrare le metriche per le quali YouTube non è stato in grado di 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 Distretto di Columbia, ad esempio US-MI (Michigan) o US-TX (Texas). Il codice provincia US-ZZ viene utilizzato per generare report sulle metriche per le quali YouTube non è stato in grado di identificare lo stato USA associato. Quando una richiesta API include province nel valore del parametro dimensions, deve anche limitare i dati agli Stati Uniti includendo country==US nel valore del parametro filters.

Nota:questa dimensione non supporta i valori ISO 3166-2 che identificano le aree periferiche degli Stati Uniti, poiché questi territori hanno anche i propri codici paese ISO 3166-1. Inoltre, non supporta le suddivisioni di paesi diversi dagli Stati Uniti.

dma
L'identificatore di 3 cifre utilizzato da Nielsen per identificare la Designated Market Area (DMA) associata agli eventi di visualizzazione descritti nella riga di dati.
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 di regione statistica 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 parammetro filters su continent==REGION_CODE, specificando un valore REGION_CODE dalla tabella.
subContinent (solo filtro)
Un codice di regione statistica delle Nazioni Unite che identifica una sottoregione geografica. La Divisione di statistica delle Nazioni Unite elenca le sottoregioni e i paesi associati a ciascuna regione.

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 o filtri geografici:

  • Esempi di canali

    • Statistiche di base: conteggio delle visualizzazioni per paese (e altro ancora) per un canale
    • Geografiche
      • Metriche sul 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 le province per gli stati degli Stati Uniti e Washington D.C.
      • Metriche sul tempo di visualizzazione specifiche per paese per le playlist di un canale
      • Top 10: le playlist più ascoltate negli Stati Uniti
    • Luogo di visualizzazione: numero di visualizzazioni e tempo di visualizzazione giornalieri da diversi luoghi di visualizzazione
    • Sorgente di traffico: visualizzazioni e tempo di visualizzazione provenienti da diverse sorgenti di traffico in un paese
    • Gruppo demografico: dati demografici degli spettatori in California (fascia d'età e genere)
    • Video più popolari
      • Top 10: i video più visti in un paese specifico
      • Top 10: i video più visti in Europa

  • Esempi di proprietari di contenuti

    • Statistiche di base: numero di visualizzazioni per paese e altro ancora per tutti i video caricati autonomamente
    • Geografiche
      • Metriche sul tempo di visualizzazione specifiche per paese per i contenuti caricati dall'utente
      • Metriche di annotazione specifiche per paese per i contenuti caricati dall'utente
      • Metriche specifiche per le province per gli stati degli Stati Uniti e Washington D.C.
      • Metriche sul tempo di visualizzazione specifiche per paese per le playlist di un proprietario di contenuti
      • Top 10: le playlist più ascoltate negli Stati Uniti
    • Luogo di visualizzazione: numero di visualizzazioni e tempo di visualizzazione giornalieri da diversi luoghi di visualizzazione
    • Gruppo demografico: dati demografici degli spettatori in California (fascia d'età e genere)
    • Video principali: Top 10 – Video più guardati in Europa per un proprietario di contenuti
    • Entrate/Rendimento degli annunci: metriche relative a entrate e 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 cui il report include i dati. Tieni presente che il report restituisce effettivamente i dati fino all'ultimo giorno per cui sono disponibili tutte le metriche specificate nella richiesta al momento dell'esecuzione 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 (fuso orario del Pacifico USA) (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 per l'ora legale rappresentano un periodo di 23 ore, mentre le date in cui vengono regolati all'indietro rappresentano un periodo di 25 ore.

La dimensione month si riferisce al periodo di tempo che inizia alle ore 00:00 (fuso orario del Pacifico USA) (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 di un giorno. Puoi utilizzare altre dimensioni per suddividere ulteriormente i dati. Ad esempio, un report sulle sorgenti di traffico può aggregare le statistiche sulle visualizzazioni giornaliere in base al modo in cui gli utenti raggiungono i tuoi video. This is a core dimension and is subject to the Deprecation Policy.
month (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 nel formato YYYY-MM.

Nota: se la query dell'API utilizza la dimensione month, i parametri start-date e end-date devono essere impostati entrambi 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 dei video di un canale
      • Visualizzazioni giornaliere delle playlist per un canale
    • Luogo di visualizzazione: numero di visualizzazioni e tempo di visualizzazione giornalieri da diversi luoghi di visualizzazione
    • Sorgente di traffico: conteggio delle visualizzazioni giornaliere e tempo di visualizzazione provenienti 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 di contenuti

    • In base al tempo
      • Metriche giornaliere sul tempo di visualizzazione per i contenuti caricati dall'utente
      • Metriche relative alle annotazioni per i contenuti rivendicati
      • Visualizzazioni giornaliere delle playlist per un proprietario dei contenuti
    • Luogo di visualizzazione: numero di visualizzazioni e tempo di visualizzazione giornalieri da diversi luoghi di visualizzazione
    • Sorgente di traffico: conteggio delle visualizzazioni giornaliere e tempo di visualizzazione provenienti da diverse sorgenti di traffico
    • Dispositivo/sistema operativo
      • Metriche giornaliere relative al tipo di dispositivo per i video rivendicati
      • Metriche giornaliere relative al sistema operativo per i video rivendicati guardati su dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo
    • Entrate/Rendimento degli annunci: metriche sulle entrate giornaliere e sul 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 vengono aggregati in base al tipo di pagina o applicazione in cui si sono verificate le riproduzioni dei video. I valori possibili per questa dimensione sono:

  • BROWSE: i dati descrivono le visualizzazioni effettuate sulla home page o sulla schermata Home di YouTube, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube.

  • CHANNEL: i dati descrivono le visualizzazioni generate su una pagina del canale.

  • EMBEDDED: i dati descrivono le visualizzazioni generate su un altro sito web o in un'altra applicazione in cui il video è stato incorporato utilizzando un incorporamento <iframe> o <object>.

  • EXTERNAL_APP: i dati descrivono le visualizzazioni generate in un'applicazione di terze parti in cui il video è stato riprodotto utilizzando un metodo diverso dall'embed <iframe> o <object>. Ad esempio, le riproduzioni nelle applicazioni che utilizzano l'API YouTube Player per Android verranno classificate utilizzando questo valore.

  • MOBILE: i dati descrivono le visualizzazioni generate 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 poiché i dati precedenti rientrano ancora in questa categoria. Tuttavia, dopo questa data, le riproduzioni su dispositivi mobili vengono classificate come riproduzioni WATCH, EMBEDDED o EXTERNAL_APP, a seconda del tipo di applicazione in cui si verificano.

  • SEARCH: i dati descrivono le visualizzazioni generate direttamente nella pagina dei risultati di ricerca di YouTube.

  • WATCH: i dati descrivono le visualizzazioni generate nella 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 non 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 generate nei player incorporati e identifica i player incorporati che hanno generato il maggior numero di visualizzazioni per un video specifico. Fornisce quindi una visione più dettagliata rispetto al report sulle località di riproduzione perché identifica gli URL o le applicazioni associate ai principali player incorporati.

Esempi

Le seguenti richieste di esempio utilizzano le dimensioni relative alla località di riproduzione:

  • Esempi di canali

    • Posizione di riproduzione
      • Visualizzazioni e tempo di visualizzazione da località di riproduzione diverse
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da località di riproduzione diverse
      • Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
      • Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist da località di riproduzione diverse
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da località di riproduzione diverse

  • Esempi di proprietari di contenuti

    • Posizione di riproduzione
      • Visualizzazioni e tempo di visualizzazione da località di riproduzione diverse
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione da località di riproduzione diverse
      • Top 10: siti di terze parti che generano il maggior numero di visualizzazioni per un video incorporato
      • Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist da località di riproduzione diverse
      • Numero di visualizzazioni giornaliere delle playlist e tempo di visualizzazione da località di riproduzione diverse

Dettagli sulla riproduzione

creatorContentType
Questa dimensione identifica il tipo di contenuti associato alle metriche relative all'attività utente nella riga di dati. I dati per questa dimensione sono disponibili per le date a partire dal 1° gennaio 2019.

La tabella seguente elenca i valori della dimensione:
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 guardati erano un video di YouTube che non rientra in uno degli altri valori della 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 in diretta. I dati per questa dimensione sono disponibili per le date a partire dal 1° aprile 2014.

La tabella seguente elenca i valori della dimensione:
Valori
LIVE I dati della riga descrivono l'attività utente che si è verificata durante una trasmissione in diretta.
ON_DEMAND I dati della riga descrivono l'attività utente che non si è verificata durante una trasmissione in diretta.
subscribedStatus
Questa dimensione indica se le metriche sull'attività utente nella riga di 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 è accurato a partire dal momento in cui si verifica l'attività utente. Ad esempio, supponiamo che un utente non sia iscritto a un canale e guardi uno dei video del canale, poi si iscriva al canale e guardi un altro video, tutto nello stesso giorno. Il report del canale indica che una visualizzazione ha un valore subscribedStatus pari a SUBSCRIBED e un'altra visualizzazione 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 dal 18 luglio 2015.

La seguente tabella elenca i valori della dimensione:
Valori
CORE L'attività utente che non si è verificata in una delle applicazioni YouTube specializzate (YouTube Gaming, YouTube Kids o YouTube Music). Eccezione: l'attività utente avvenuta su YouTube Music prima del 1° marzo 2021 è inclusa in CORE.
GAMING L'attività utente è avvenuta su YouTube Gaming.
KIDS L'attività utente è avvenuta su YouTube Kids.
MUSIC L'attività dell'utente è avvenuta 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 è arrivato al video tramite un annuncio. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica il tipo di pubblicità.
  • ANNOTATION: gli spettatori hanno raggiunto il video facendo clic su un'annotazione in un altro video.
  • CAMPAIGN_CARD: visualizzazioni generate da video caricati dagli utenti e rivendicati dal proprietario dei contenuti, che li ha utilizzati per promuovere i contenuti visualizzati. Questa sorgente di traffico è supportata solo per i report dei proprietari di contenuti.
  • END_SCREEN: le visualizzazioni provengono dalla schermata finale di un altro video.
  • EXT_URL: le visualizzazioni del video provengono da un link su un altro sito web. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica la pagina web. Questa sorgente di traffico include i referral provenienti dai risultati della Ricerca Google.
  • HASHTAGS: visualizzazioni provenienti dalle pagine degli hashtag dei VOD o dalle pagine pivot degli hashtag di Shorts.
  • LIVE_REDIRECT: le visualizzazioni del video provengono da Live Redirect.
  • NO_LINK_EMBEDDED: il video è stato incorporato su un altro sito web quando è stato visualizzato.
  • NO_LINK_OTHER: YouTube non ha identificato un referrer per il traffico. Questa categoria comprende il traffico diretto a un video e il traffico sulle app mobile.
  • NOTIFICATION: le visualizzazioni del video sono state generate da un referral via 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. Sono inclusi i dati relativi al traffico proveniente dalla pagina della playlist.
  • PRODUCT_PAGE: le visualizzazioni del video provengono da una pagina di prodotto.
  • PROMOTED: le visualizzazioni del video provengono da una promozione di YouTube non a pagamento, ad esempio la pagina "Video in primo piano" di YouTube.
  • RELATED_VIDEO: le visualizzazioni del video sono state generate da una scheda di un video correlato su un'altra pagina di visualizzazione di un video. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica l'ID video.
  • SHORTS: lo spettatore è stato indirizzato scorrendo in verticale dal video precedente nell'esperienza di visualizzazione di Shorts.
  • SOUND_PAGE: visualizzazioni provenienti dalle pagine pivot degli audio di Shorts.
  • SUBSCRIBER: le visualizzazioni del video sono state generate da referral provenienti dai feed della home page di YouTube o dalle funzionalità di iscrizione di YouTube. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica gli elementi del feed della home page o un'altra pagina da cui sono state generate le visualizzazioni.
  • YT_CHANNEL: le visualizzazioni del video si sono verificate nella pagina di un canale. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica l'ID canale.
  • YT_OTHER_PAGE: le visualizzazioni del video provengono da un link diverso da un risultato di ricerca o da un link a un video correlato visualizzato su una pagina di YouTube. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail identifica la pagina.
  • YT_SEARCH: le visualizzazioni del video sono state generate dai risultati di ricerca di YouTube. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica il termine di ricerca.
  • VIDEO_REMIXES: le visualizzazioni del video sono state generate dal link al video remixato nel player di Shorts. Se applichi un filtro in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specifica il video da cui lo spettatore è arrivato.
insightTrafficSourceDetail
I dati del report vengono aggregati in base ai referrer che hanno generato il maggior numero di visualizzazioni per un video e un tipo di sorgente di traffico specificati. L'elenco seguente 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 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 riservato
    • 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 nella segnalazione.
  • END_SCREEN: il video che ha indirizzato gli spettatori al video identificato nella segnalazione.
  • 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 coperto dal report.
  • SOUND_PAGE: il video che ha generato le visualizzazioni.
  • SUBSCRIBER: l'elemento del feed della home page o la funzionalità Iscrizioni di YouTube che ha indirizzato gli spettatori al video trattato nel report. I valori validi sono:
    • activity: visualizzazioni generate dagli elementi dei feed Iscrizioni sulla home page derivanti da attività del canale diverse dai caricamenti e dai social, tra cui Mi piace, preferiti, post del bollettino e aggiunte alle playlist.
    • blogged: visualizzazioni generate dagli elementi dei feed Iscrizioni sulla home page che provengono da link dei principali blog.
    • mychannel: visualizzazioni generate dagli elementi di 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 dei podcast.
    • sdig: visualizzazioni provenienti dalle email di aggiornamento dell'abbonamento.
    • uploaded: visualizzazioni generate dagli uploaded elementi nei feed Iscrizioni sulla home page.
    • / - Altre visualizzazioni provenienti dalla home page di YouTube.
    • /my_subscriptions: visualizzazioni provenienti dalle pagine I miei abbonamenti 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
      • Visualizzazioni e tempo di visualizzazione provenienti da diverse sorgenti di traffico in un paese
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione provenienti da diverse sorgenti di traffico
      • Top 10: i termini di ricerca di YouTube che generano più traffico per un video
      • Top 10: termini della Ricerca Google che generano più traffico per un video
      • Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist provenienti da diverse sorgenti di traffico in un paese
      • Conteggi giornalieri delle visualizzazioni delle playlist e tempo di visualizzazione provenienti da diverse sorgenti di traffico

  • Esempi di proprietari di contenuti

    • Sorgente di traffico
      • Visualizzazioni e tempo di visualizzazione provenienti da diverse sorgenti di traffico
      • Numero di visualizzazioni giornaliere e tempo di visualizzazione provenienti da diverse sorgenti di traffico
      • Top 10: i termini di ricerca di YouTube che generano più traffico per un video
      • Top 10: termini della Ricerca Google che generano più traffico per un video
      • Conteggio delle visualizzazioni e tempo di visualizzazione delle playlist provenienti da diverse sorgenti di traffico in un paese
      • Conteggi giornalieri delle visualizzazioni delle playlist e tempo di visualizzazione provenienti da diverse sorgenti di traffico

Dispositivi

deviceType
Questa dimensione identifica il fattore di forma fisico del dispositivo su cui si è verificata la visualizzazione. L'elenco seguente identifica i tipi di dispositivi per i quali l'API restituisce dati. Puoi anche utilizzare la dimensione deviceType come filtro per limitare un report sul 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 si è verificata la visualizzazione. L'elenco seguente identifica i sistemi operativi per i quali l'API restituisce 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
      • Statistiche giornaliere dei tipi di dispositivi per le visualizzazioni di playlist sul sistema operativo Android
      • Metriche giornaliere dei sistemi operativi per le visualizzazioni di playlist sui dispositivi mobili

  • Esempi di proprietari di contenuti

    • Dispositivo/sistema operativo
      • Metriche giornaliere relative al tipo di dispositivo per i video rivendicati
      • Metriche giornaliere relative al sistema operativo per i video rivendicati guardati su dispositivi mobili
      • Metriche giornaliere relative al sistema operativo e al tipo di dispositivo
      • Statistiche giornaliere dei tipi di dispositivi per le visualizzazioni di playlist sul sistema operativo Android
      • Metriche giornaliere dei sistemi operativi per le visualizzazioni di playlist sui dispositivi mobili

Dati demografici

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

ageGroup (dimensione principale)
Questa dimensione identifica la fascia d'età degli utenti che hanno eseguito l'accesso 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 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 le dimensioni demografiche:

  • Esempi di canali

    • Dati demografici
      • Dati demografici degli spettatori in California (fascia d'età e genere)
      • Dati demografici degli spettatori delle playlist in California (fascia d'età e genere)

  • Esempi di proprietari di contenuti

    • Dati demografici
      • Dati demografici degli spettatori in California (fascia d'età e genere)
      • Dati demografici degli spettatori delle playlist in California (fascia d'età e genere)

Coinvolgimento e condivisione di 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 validi delle dimensioni:
Servizio di condivisione Valore dell'API
Ameba AMEBA
Android Email ANDROID_EMAIL
Android Messaggi ANDROID_MESSENGER
Messaggistica Android ANDROID_MMS
BlackBerry Messenger 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
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Messaggio HTC HTC_MMS
Posta in arrivo di Google INBOX
Finestra di dialogo Attività di sistema di iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Email LGE LGE_EMAIL
Linea LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Condivisione nelle vicinanze NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Altro OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Messaggio TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Sconosciuto UNKNOWN
Verizon Messages 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 di assistenza.

Esempi

Le seguenti richieste di esempio utilizzano le dimensioni social:

  • Esempi di canali

    • Social: metriche relative alla condivisione, aggregate per servizio in cui i video sono stati condivisi

  • Esempi di proprietari di contenuti

    • Social: metriche relative alla condivisione, aggregate in base al servizio su cui sono stati condivisi i video

Fidelizzazione del pubblico

elapsedVideoTimeRatio
Questa dimensione specifica il rapporto tra la parte del video trascorsa 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 valore 0.4 indica che i dati del report corrispondenti mostrano i dati sulla fidelizzazione dopo il 40% del video.

L'API restituisce 100 punti dati per ogni video con valori di rapporto che vanno da 0.01 a 1.0. I momenti in cui i dati vengono misurati durante la riproduzione dei 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. Per una spiegazione di questi tipi di sorgenti di traffico, consulta il Centro assistenza YouTube.

Tieni presente che i dati per il filtro audienceType sono disponibili a partire dal 25 settembre 2013. L'API non restituisce dati per le query che utilizzano il filtro per provare a recuperare i dati di 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:

Live streaming

livestreamPosition
Questa dimensione specifica un determinato minuto durante uno stream video dal vivo. Le metriche del report indicano il numero di utenti che 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 specificato durante il periodo di generazione del report. La seguente tabella elenca i valori validi delle dimensioni:
Valore dell'API Spiegazione
UNKNOWN L'utente non ha completato il sondaggio.
DISLIKE_PERKS L'utente non ha apprezzato i vantaggi dell'abbonamento.
PERKS_NOT_DELIVERED L'utente ha dichiarato che i vantaggi dell'abbonamento promessi non sono stati forniti.
CANNOT_ACCESS_PERKS L'utente non è riuscito ad accedere ai vantaggi.
NO_LONGER_INTERESTED L'utente non è più interessato all'abbonamento al canale.
FEEL_UNAPPRECIATED L'utente si è sentito poco apprezzato come membro del canale.
FINANCIAL_REASONS L'utente ha annullato l'abbonamento per motivi finanziari.
JOIN_LIMITED_TIME L'utente intendeva abbonarsi 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 la riproduzione dei video. L'elenco seguente illustra i possibili valori delle dimensioni. Per saperne di più sui formati pubblicitari di YouTube, visita 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 illustrati o rich media 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 anche l'utente può chiuderlo. Se vengono mostrati insieme un overlay e un banner, ogni annuncio viene conteggiato come un'impressione distinta.

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

  • auctionTrueviewInslate: lo spettatore sceglie uno di diversi annunci video da una selezione di opzioni visualizzate prima di un video. See the TrueView documentation for more information.

  • auctionTrueviewInstream: annunci video ignorabili pubblicati prima o durante il video principale. Per ulteriori informazioni, consulta la documentazione di TrueView.

  • auctionUnknown: un annuncio acquistato tramite l'asta AdWords, ma non classificato in uno degli altri tipi di annunci.

  • reservedBumperInstream: annunci video non ignorabili, venduti su base riservata, 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 ogni volta che viene visualizzata l'unità pubblicitaria con riproduzione a clic, indipendentemente dal fatto che l'utente avvii una riproduzione. Questi prodotti vengono venduti su prenotazione.

  • reservedDisplay: un annuncio illustrati o rich media 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 anche l'utente può chiuderlo. Se vengono mostrati insieme un overlay e un banner, ogni annuncio viene conteggiato come un'impressione distinta.

  • reservedInstream: annunci video non ignorabili inseriti prima, durante o dopo il video principale.

  • reservedInstreamSelect

  • reservedMasthead: un annuncio di grandi dimensioni, che può includere elementi video e grafici, visualizzato nella home page.

  • reservedUnknown: un annuncio venduto su prenotazione che non può essere classificato in uno degli altri tipi di annunci.

  • unknown: YouTube non è stato in grado di 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 sul rendimento degli annunci e sulle entrate del canale
      • Metriche giornaliere relative alle entrate e al rendimento degli annunci
      • Metriche sul rendimento degli annunci e sulle entrate specifiche per paese
      • Top 10: video con le entrate più alte
      • Metriche sul rendimento degli annunci per diversi tipi di annunci

  • Esempi di proprietari di contenuti

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

Dimensioni del proprietario dei contenuti

Le seguenti dimensioni sono supportate solo per i report dei proprietari di contenuti.

Importante: le richieste API per recuperare i report dei proprietari di contenuti devono filtrare i dati utilizzando una delle seguenti dimensioni:
  • video
  • channel
  • Una combinazione supportata delle dimensioni claimedStatus e uploaderType come definite di seguito.
claimedStatus (utilizzato solo nei report per i proprietari di contenuti)
Questa dimensione ti consente di indicare che una risposta dell'API deve contenere solo le 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 utilizzarla.
uploaderType (dimensione principale) (utilizzata solo nei report per i proprietari di contenuti)
Questa dimensione ti 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. Si tratta di una dimensione di base ed è soggetta alle norme relative al ritiro.

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

Valore claimedStatus Valore uploaderType Descrizione
[Non impostato] self Recupera i dati di YouTube Analytics per i contenuti rivendicati e non rivendicati caricati dal proprietario dei contenuti.
rivendicati [Non impostato] Recupera i dati relativi ai contenuti rivendicati caricati dal proprietario dei contenuti o da terze parti.
rivendicati self 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 dei proprietari di contenuti utilizzano una combinazione supportata delle dimensioni claimedStatus e uploaderType per filtrare i dati.