Questo documento spiega le somiglianze e le differenze nel modo in cui l'API YouTube Analytics e l'API di reporting di YouTube forniscono l'accesso ai dati di YouTube Analytics, in modo che tu possa scegliere l'API giusta per la tua applicazione.
Entrambe le API consentono di recuperare i dati di YouTube Analytics. Inoltre, entrambe le API supportano i proprietari di canali YouTube e i proprietari di contenuti di YouTube, ognuno dei quali può accedere a un insieme specifico di report:
-
I report sui canali contengono metriche sull'attività utente per un canale specifico.
-
I report dei proprietari dei contenuti aggregano le metriche per tutti i canali collegati a un determinato proprietario dei contenuti di YouTube. Ad esempio, una casa discografica potrebbe recuperare un report contenente statistiche combinate per i canali YouTube di tutti gli artisti della casa discografica. Alcuni report dei proprietari dei contenuti contengono metriche sull'attività degli utenti, mentre altri contengono metriche correlate alle entrate e al rendimento degli annunci.
L'API Reporting consente inoltre ad alcuni proprietari dei contenuti di accedere ai report sulle entrate pubblicitarie gestiti dal sistema. I dati nei report gestiti dal sistema possono essere recuperati solo con l'API Reporting.
Tutte le richieste alle API YouTube Analytics e YouTube Reporting devono essere autorizzate dal proprietario del canale o dei contenuti che possiede i dati richiesti.
Contenuti del report
I report recuperati dalle API contengono due tipi di dati:
-
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.
In un report, ogni riga di dati ha una combinazione unica di valori di dimensione. Pertanto, la combinazione di valori delle dimensioni di ogni riga funge da chiave primaria per quella riga.
-
Le metriche sono singole misurazioni dell'attività degli utenti, del rendimento degli annunci o delle entrate stimate. Le metriche sull'attività degli utenti includono elementi come il numero di visualizzazioni dei video e le valutazioni (Mi piace e Non mi piace).
Scegliere l'API giusta per la tua applicazione
- API di YouTube Analytics
- L'API YouTube Analytics supporta query mirate in tempo reale per generare report personalizzati di YouTube Analytics. L'API fornisce parametri di filtro e ordinamento, quindi l'applicazione chiamante non deve supportare nativamente queste funzioni.
Ogni richiesta API specifica l'intervallo di date per cui verranno restituiti i dati. L'API consente anche di recuperare set di dati settimanali e mensili. Pertanto, l'applicazione chiamante non deve archiviare i set di dati recuperati o le statistiche aggregate in intervalli di date. - API di reporting di YouTube
- L'API di reporting di YouTube recupera i report collettivi contenenti i dati di YouTube Analytics relativi a un canale o a un proprietario dei contenuti. È progettata per applicazioni in grado di importare set di dati di grandi dimensioni e che forniscono strumenti per filtrare, ordinare ed estrarre i dati.
Ogni report contiene un insieme predefinito di campi. Utilizzi l'API per pianificare i job di generazione dei report, ognuno dei quali identifica un report che YouTube deve generare. YouTube genera quindi un report giornaliero che può essere scaricato in modo asincrono. Ogni report contiene dati relativi a un periodo univoco di 24 ore.
Inoltre, YouTube genera automaticamente una serie di report gestiti dal sistema per i proprietari dei contenuti che hanno accesso ai report corrispondenti in YouTube Creator Studio. Questi report forniscono l'accesso programmatico ai dati sulle entrate pubblicitarie.
Report supportati
La tabella seguente identifica i diversi tipi di report che puoi recuperare utilizzando le API. Le query mirate sono disponibili tramite l'API YouTube Analytics, mentre i report collettivi sono disponibili tramite l'API di reporting di YouTube.
I dati disponibili in un'API potrebbero non essere disponibili nell'altra. Ad esempio, l'API YouTube Analytics ti consente di recuperare le metriche sull'attività degli utenti su base settimanale o mensile, mentre l'API di reporting di YouTube richiede di aggregare autonomamente i dati. D'altra parte, l'API YouTube Reporting supporta i report sulle risorse per i proprietari dei contenuti, ma questi dati non sono disponibili nell'API YouTube Analytics.
| Tipi di rapporti | |
|---|---|
| Report video | Supportato per canali (query o bulk) e proprietari dei contenuti (query o bulk). I report sui video forniscono statistiche su tutta l'attività utente relativa ai video di un canale o di un proprietario dei contenuti. Ad esempio, questi report contengono il numero di visualizzazioni ricevute dai tuoi video. Nell'API di YouTube Analytics, alcuni report sui video dei proprietari dei contenuti includono anche le metriche relative alle entrate stimate e al rendimento degli annunci. |
| Report sulle playlist | Supportato per canali (query o bulk) e proprietari dei contenuti (query o bulk). I report sulle playlist forniscono statistiche specificamente correlate alle visualizzazioni dei video che si verificano nel contesto di una playlist. L'API YouTube Reporting supporta i report sulla fidelizzazione del pubblico per le playlist, ma l'API YouTube Analytics non supporta un report simile. |
| Report sul rendimento degli annunci | Supportato per i proprietari dei contenuti (query o bulk). I report sul rendimento degli annunci forniscono metriche basate sulle impressioni per gli annunci pubblicati durante la riproduzione dei video. Queste metriche tengono conto di ogni impressione dell'annuncio e ogni riproduzione video può generare più impressioni. |
| Report sulle entrate stimate | Supportato per i proprietari dei contenuti (bulk). I report sulle entrate stimate forniscono il totale delle entrate stimate per i video provenienti da origini pubblicitarie vendute da Google e da origini non pubblicitarie. Questi report contengono anche alcune metriche sul rendimento degli annunci. Tieni presente che i report gestiti dal sistema contengono le entrate effettive. |
| Report sugli asset | Supportato per i proprietari dei contenuti (bulk). I report sulle risorse forniscono metriche sull'attività utente relative ai video collegati alle risorse di un proprietario dei contenuti. Un video viene incluso nel report di un proprietario dei contenuti se quest'ultimo lo ha rivendicato come corrispondenza di una delle sue risorse. Il video potrebbe essere stato caricato dal proprietario dei contenuti o da un altro utente di YouTube. |
| Report gestiti dal sistema | Supportato per i proprietari dei contenuti che hanno accesso ai report corrispondenti nel menu Report di Creator Studio di YouTube. I report gestiti dal sistema forniscono dati sulle entrate effettive generate da risorse e video. Un report aggiuntivo elenca i video rivendicati e le risorse a cui corrispondono. Non tutti i report di Creator Studio sono disponibili nell'API. Nota:YouTube genera automaticamente report gestiti dal sistema per i proprietari dei contenuti che hanno accesso ai report corrispondenti in Creator Studio. Di conseguenza, la procedura per recuperare questi report è diversa da quella per gli altri tipi di report in questo elenco. Per saperne di più, consulta la documentazione relativa ai report gestiti dal sistema. |
Differenze principali
La seguente tabella evidenzia le differenze importanti tra le API YouTube Analytics e Reporting.
| Funzionalità | API di YouTube Analytics | API di reporting di YouTube |
|---|---|---|
| Procedura per recuperare i dati | Ogni richiesta API specifica le dimensioni e le metriche da restituire, nonché il periodo di tempo per il quale verranno restituiti i dati. | Le applicazioni pianificano i job di generazione report. Per ogni job, YouTube genera report giornalieri che possono essere scaricati in modo asincrono. |
| Intervalli di date | Alcuni report API specificano la data in cui si è verificata l'attività dell'utente. Alcuni di questi report supportano le dimensioni per aggregare le metriche dell'attività utente per mese. | Tutti i report API specificano il giorno in cui si è verificata l'attività dell'utente. Le applicazioni che utilizzano l'API possono implementare funzionalità per aggregare i dati per intervalli periodici. |
| Filtrare i dati | Puoi filtrare i report in modo da includere solo le righe per le quali una dimensione ha un valore specifico. L'API supporta anche alcune dimensioni, come continent e subContinent, che vengono utilizzate solo come filtri. | L'API supporta i download collettivi di set di dati completi. Non supporta il filtraggio o la restituzione di dati per le dimensioni solo con filtro. L'applicazione client archivia i dati scaricati e implementa le proprie funzionalità per filtrarli. |
| Ordinamento | I report possono essere ordinati in base ai valori delle metriche restituiti. Alcuni report supportano solo un numero limitato di risultati. Ad esempio, il report che elenca i video più visualizzati di un canale restituisce un massimo di 200 righe. | Questa API supporta i download collettivi di set di dati completi. Le applicazioni client possono implementare le proprie funzionalità per ordinare i dati scaricati. |
| Enumerazioni | I report API contengono valori di testo, come "ANDROID" o "CHANNEL", per identificare i valori delle dimensioni enumerati. | I report API contengono numeri interi che possono essere mappati a valori di testo. |
| Quota | Il server API valuta ogni query per determinare il relativo costo della quota. La sezione Utilizzo della quota spiega la metodologia in modo più dettagliato. | L'utilizzo della quota non è un problema perché i dati vengono recuperati una volta e poi filtrati, ordinati ed eseguiti query all'interno dell'applicazione. |
| Report unici |
|
|
| Dimensioni uniche | group (dimensione solo filtro) continent (dimensione solo filtro) subContinent (dimensione solo filtro) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Metriche uniche | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
Differenze di denominazione tra le API
Le due API utilizzano convenzioni di denominazione diverse per identificare dimensioni e metriche. I nomi delle API YouTube Analytics utilizzano la notazione camelCase, ad esempio adType. I nomi dell'API YouTube Reporting sono in minuscolo e utilizzano trattini bassi, ad esempio ad_type.
Le tabelle seguenti identificano i diversi nomi utilizzati dalle due API per identificare le stesse metriche e dimensioni. In alcuni casi, la differenza tra i due nomi è maggiore di quella che si otterrebbe dopo la conversione di un nome da camelCase a underscore. Ad esempio, la dimensione video nell'API YouTube Analytics si chiama video_id nell'API di reporting di YouTube.