Questo documento spiega somiglianze e differenze nei modi in cui l'API YouTube Analytics e l'API di reporting di YouTube forniscono l'accesso ai dati di YouTube Analytics. Lo scopo del documento è aiutarti a scegliere l'API giusta per la tua applicazione.
Entrambe le API consentono agli sviluppatori di recuperare i dati di YouTube Analytics. Inoltre, entrambe le API supportano i proprietari di canali YouTube e i proprietari di contenuti YouTube, ognuno dei quali può accedere a un insieme specifico di report:
-
I report sui canali contengono le metriche sull'attività utente relative a un canale specifico.
-
I report dei proprietari dei contenuti aggregano le metriche relative a tutti i canali collegati a uno specifico 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 sui proprietari dei contenuti contengono metriche sull'attività utente, mentre altri contengono metriche relative alle entrate e al rendimento degli annunci.
L'API di reporting consente inoltre ad alcuni proprietari dei contenuti di accedere ai report sulle entrate pubblicitarie gestite dal sistema. I dati nei report gestiti dal sistema possono essere recuperati solo con l'API di reporting.
Tutte le richieste di YouTube Analytics e API di reporting di YouTube devono essere autorizzate dal canale o dal proprietario dei contenuti proprietario dei dati richiesti.
Contenuti dei 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 trovava l'utente.
In un report, ogni riga di dati ha una combinazione univoca di valori di dimensione. Di conseguenza, la combinazione di valori di dimensione di ogni riga funge da chiave primaria per quella riga.
-
Le metriche sono misurazioni individuali dell'attività utente, del rendimento degli annunci o delle entrate stimate. Le metriche relative all'attività utente includono, ad esempio, il numero di visualizzazioni e i voti (Mi piace e Non mi piace) dei video.
Scegli l'API giusta per la tua applicazione
- API di YouTube Analytics
- L'API di YouTube Analytics supporta query mirate in tempo reale per generare report di YouTube Analytics personalizzati. L'API fornisce parametri di filtro e ordinamento, quindi l'applicazione che chiama non ha bisogno di supportare queste funzioni in modo nativo.
Ogni richiesta API specifica l'intervallo di date per il quale verranno restituiti i dati. L'API consente inoltre di recuperare set di dati settimanali e mensili. Pertanto, l'applicazione che chiama non ha bisogno di archiviare i set di dati recuperati o le statistiche aggregate per più intervalli di date. - API di reporting di YouTube
- L'API di reporting di YouTube recupera i report collettivi contenenti i dati di YouTube Analytics per un canale o un proprietario dei contenuti. È progettato 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. Gli sviluppatori utilizzano l'API per pianificare job di generazione dei report, ciascuno dei quali identifica un report che YouTube dovrebbe generare. YouTube genera quindi un report giornaliero che può essere scaricato in modo asincrono. Ogni report contiene dati relativi a un periodo di 24 ore univoco.
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 accesso programmatico ai dati sulle entrate pubblicitarie. - Attività utente relativa ai sottotitoli
- Dati sulla fidelizzazione del pubblico per le playlist
- Report Entrate stimate per i proprietari dei contenuti (sono disponibili 2 diversi report)
- Report sulle risorse per i proprietari dei contenuti (sono disponibili 11 diversi report)
Report supportati
La tabella riportata di seguito 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 di YouTube Analytics ti consente di recuperare le metriche sull'attività utente su base settimanale o mensile, mentre l'API di reporting di YouTube richiede di aggregare questi dati personalmente. L'API di reporting di YouTube, invece, 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 | Supportata per canali (query o collettivi) e proprietari dei contenuti (query o collettivi). I report sui video forniscono statistiche su tutte le attività utente relative 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 YouTube Analytics, alcuni report sui video dei proprietari dei contenuti includono anche metriche sul rendimento degli annunci e sulle entrate stimate. |
| Report sulle playlist | Supportata per canali (query o collettivi) e proprietari dei contenuti (query o collettivi). I report sulle playlist forniscono statistiche specificamente correlate alle visualizzazioni di video che si verificano nel contesto di una playlist. L'API di reporting di YouTube 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 collettivi). I report sul rendimento degli annunci forniscono metriche basate sulle impressioni per gli annunci pubblicati durante le riproduzioni dei video. Queste metriche prendono in considerazione ogni impressione dell'annuncio e ogni riproduzione video può generare più impressioni. |
| Report Entrate stimate | Supportato per i proprietari dei contenuti (in blocco). I report Entrate stimate forniscono le entrate stimate totali per i video provenienti da origini di pubblicità venduta 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 entrate effettive. |
| Report sugli asset | Supportato per i proprietari dei contenuti (in blocco). 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 rapporto di un proprietario dei contenuti se quest'ultimo ha rivendicato il video in quanto corrispondente a una delle risorse del proprietario dei contenuti. 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 nella sezione Report di YouTube Studio. I report gestiti dal sistema forniscono dati sulle entrate effettive ottenute da risorse e video. Un report aggiuntivo elenca i video rivendicati e le risorse corrispondenti. Tieni presente che non tutti i report di Creator Studio sono attualmente 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, il processo per il recupero di questi report è diverso rispetto agli altri tipi di report in questo elenco. Per ulteriori informazioni, consulta la documentazione relativa ai report gestiti dal sistema. |
Differenze principali
La seguente tabella evidenzia le differenze importanti tra l'API di YouTube Analytics e l'API di reporting.
| Funzionalità | API di YouTube Analytics | API di reporting di YouTube |
|---|---|---|
| Processo per recuperare i dati | Ogni richiesta API specifica le dimensioni e le metriche da restituire, nonché il periodo di tempo per cui i dati verranno restituiti. | Le applicazioni pianificano i job di generazione di report. Per ogni job, YouTube genera report giornalieri che possono essere scaricati in modo asincrono. |
| Intervalli di date | Alcuni report dell'API specificano la data in cui si è verificata l'attività utente. Alcuni di questi supportano le dimensioni per aggregare le metriche relative all'attività utente per mese. | Tutti i report dell'API specificano il giorno in cui si è verificata l'attività utente. Le applicazioni che utilizzano l'API possono implementare funzionalità per aggregare i dati a 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 continente e subContinente, che vengono utilizzate solo come filtri. | L'API supporta i download collettivi di set di dati completi. Non supporta l'applicazione di filtri o la restituzione di dati per le dimensioni solo 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ù visti 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 dell'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 relativa all'utilizzo delle quote spiega la metodologia in modo più dettagliato. | L'utilizzo della quota non rappresenta un problema perché i dati vengono recuperati una volta e poi filtrati, ordinati ed sottoposti a query all'interno dell'applicazione. |
| Report unici |
|
|
| Dimensioni uniche | gruppo (dimensione solo filtro) continente (dimensione solo filtro) subcontinente (dimensione solo filtro) mese èSelezionato==1 (dimensione solo filtro) viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status lingua_dei_sottotitoli |
| Metriche univoche | utenti unici relativeFidelizzazionePerformance visualizzazioniPerPlaylistStart Tempo medioInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_save17_revenueestimated_partner_save17_revenueestimated_partner_save17_revenue{/16 |
Differenze di denominazione tra le API
Attualmente le due API utilizzano convenzioni di denominazione diverse per identificare dimensioni e metriche. Al momento, i nomi dell'API YouTube Analytics utilizzano camelCase, mentre i nomi dell'API di reporting di YouTube utilizzano nomi delimitati da trattini bassi.
Le seguenti tabelle 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 otterresti dopo aver convertito un nome da camelCase in trattini bassi. Ad esempio, la dimensione video nell'API YouTube Analytics è denominata video_id nell'API di reporting di YouTube.