In questa pagina sono elencate le modifiche apportate all'API e gli aggiornamenti alla documentazione relativi sia all'API di reporting sia all'API di YouTube Analytics. Entrambe le API consentono agli sviluppatori di accedere ai dati di YouTube Analytics, anche se in modi diversi. Iscriviti a questo log delle modifiche. :
6 maggio 2024
L'API YouTube Analytics (Targeted Query) supporta tre nuovi report per i canali:
-
La scheda Attività utente per DMA un report geografico che fornisce statistiche sull'attività dell'utente in base alla Designated Market Area (DMA). Per questo report, devi impostare il valore parametro
filters
sucountry==US
. -
La scheda Spettatori simultanei mostra il numero di spettatori simultanei in parti diverse di un singolo live streaming video.
-
Annullamenti degli abbonati Il report fornisce statistiche che mostrano perché gli utenti hanno annullato il proprio abbonamenti al canale.
Questo report utilizza la nuova
membershipsCancellationSurveyReason
che specifica il motivo per cui un utente ha annullato un abbonamento al canale. Utilizza anche il nuovomembershipsCancellationSurveyResponses
che indica il numero di abbonamenti al canale annullati per quel motivo.
Inoltre, i segmenti di pubblico Il report sulla fidelizzazione è stato migliorato per supportare tre nuove metriche:
7 aprile 2024
L'API YouTube Analytics (Targeted Query) presenta diversi aggiornamenti relativi al proprietario dei contenuti report sulle playlist. Gli aggiornamenti sono gli stessi di quelli relativi ai report sulle playlist del canale, annunciati il 19 gennaio 2024.
La seguente voce della cronologia delle revisioni fornisce
le stesse informazioni della voce del 19 gennaio 2024. Tuttavia, tieni presente che
il proprietario dei contenuti
I report sulle playlist supporteranno
isCurated
dimensione fino a
Dal 31 dicembre 2024, mentre la dimensione sarà supportata per i report sulle playlist del canale fino al giorno
30 giugno 2024.
-
Nota: questo è un annuncio relativo al ritiro.
isCurated
è stata ritirata per i report sulle playlist dei proprietari dei contenuti. Non sarà più supportata a partire dal 31 dicembre 2024. La definizione di questa dimensione è stata aggiornata di conseguenza.Per preservare la compatibilità con le versioni precedenti quando rimuovi
isCurated
devi anche aggiornare il codice per recuperare la metricaplaylistViews
invece della metricaviews
solo per i report sulle playlist. Dalviews
è ancora supportata per i report sulle playlist, anche se con un significato diverso, l'API restituiscono comunque dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare la tua applicazione per recuperare e visualizzareviews
eplaylistViews
.Oltre alla dimensione
isCurated
, la seguente funzionalità dell'API è non più supportati nei nuovi report:- I filtri di località, ad esempio
continent
esubcontinent
, non vengono supportata per i nuovi rapporti sulle playlist del canale. - Le metriche
redViews
eestimatedRedMinutesWatched
non sono più supportata per i nuovi rapporti sulle playlist del canale. Queste metriche non erano disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio. - Le dimensioni
subscribedStatus
eyoutubeProduct
non sono più supportati come filtri per i report sulle playlist del canale. Questi filtri non erano disponibili in YouTube Studio, pertanto questa modifica allinea le funzionalità dell'API a quelle disponibili in l'applicazione Studio.
- I filtri di località, ad esempio
-
I report sulle playlist della documentazione relativa ai report dei proprietari dei contenuti è stata aggiornata per spiegare i tipi di metriche supportati per i report sulle playlist:
- Metriche video aggregate
forniscono metriche relative ad attività utente e impressioni aggregate per tutti i video nei
playlist del proprietario dei contenuti di proprietà di quest'ultimo. Le metriche video aggregate vengono
supportato solo per le richieste API che non utilizzano la dimensione
isCurated
. - Metriche nei contenuti in-playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono anche le visualizzazioni dei video non di proprietà presenti nella playlist, solo quando queste visualizzazioni si sono verificate nel contesto della playlist.
- Le metriche delle playlist supportate identifica le metriche aggregate video e in-playlist che sono supportati per i report sulle playlist.
- Metriche video aggregate
forniscono metriche relative ad attività utente e impressioni aggregate per tutti i video nei
playlist del proprietario dei contenuti di proprietà di quest'ultimo. Le metriche video aggregate vengono
supportato solo per le richieste API che non utilizzano la dimensione
-
Le seguenti nuove metriche in-playlist sono supportate per i report sulle playlist per proprietari dei contenuti. Tieni presente che queste metriche sono supportate solo se la richiesta API di recupero i report non utilizzano la dimensione
isCurated
. Consulta le documentazione di metrics per le definizioni di ogni metrica: -
Il comportamento di
views
ora dipende dal fatto che la richiesta API che ha recuperato il report sulla playlist abbia usato DimensioneisCurated
:- Quando una richiesta include la dimensione
isCurated
, La metricaviews
è in-playlist che indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist del proprietario dei contenuti. - Quando una richiesta non include la dimensione
isCurated
, La metricaviews
è una metrica video aggregata che specifica il numero totale di volte in cui i video nelle playlist del proprietario dei contenuti sono stati visualizzati, indipendentemente dal fatto che di visualizzazioni avvenute nel contesto della playlist. Il totale aggregato include solo le visualizzazioni di Video di proprietà del proprietario dei contenuti e associati al canale proprietario della playlist.
In questi report, che non utilizzano la dimensioneisCurated
, viene utilizzata la variabile La metricaplaylistViews
indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist. Questa metrica conta le visualizzazioni di tutti i video contenuti nella playlist, indipendentemente dal canale che ne è proprietario.
- Quando una richiesta include la dimensione
-
Per ogni report sulle playlist, report sui proprietari dei contenuti la documentazione ora include tabelle che mostrano le metriche supportate per quel report in base se la richiesta API include la dimensione
isCurated
. Consulta la sezione che definisce report sulle playlist basati sul tempo per vedere un esempio.
19 gennaio 2024
L'API YouTube Analytics (Targeted Query) presenta diversi aggiornamenti relativi alle playlist del canale report. Gli aggiornamenti includono una dimensione deprecata e diverse metriche nuove e aggiornate:
-
Nota: questo è un annuncio relativo al ritiro.
isCurated
è stata ritirata per i report sui canali. Non sarà più supportato su o dopo il 30 giugno 2024. La definizione di questa dimensione è stata aggiornata di conseguenza.Per preservare la compatibilità con le versioni precedenti quando rimuovi
isCurated
devi anche aggiornare il codice per recuperare la metricaplaylistViews
invece della metricaviews
solo per i report sulle playlist. Dalviews
è ancora supportata per i report sulle playlist, anche se con un significato diverso, l'API restituiscono comunque dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare la tua applicazione per recuperare e visualizzareviews
eplaylistViews
.Oltre alla dimensione
isCurated
, la seguente funzionalità dell'API è non più supportati nei nuovi report:- I filtri di località, ad esempio
continent
esubcontinent
, non vengono supportata per i nuovi rapporti sulle playlist del canale. - Le metriche
redViews
eestimatedRedMinutesWatched
non sono più supportata per i nuovi rapporti sulle playlist del canale. Queste metriche non erano disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio. - Le dimensioni
subscribedStatus
eyoutubeProduct
non sono più supportati come filtri per i report sulle playlist del canale. Questi filtri non erano disponibili in YouTube Studio, pertanto questa modifica allinea le funzionalità dell'API a quelle disponibili in l'applicazione Studio.
- I filtri di località, ad esempio
-
I report sulle playlist della documentazione relativa ai report sui canali è stata aggiornata per spiegare in modo più approfondito i tipi di metriche supportati per i report sulle playlist:
- Metriche video aggregate
forniscono metriche relative ad attività utente e impressioni aggregate per tutti i video nei
playlist del canale di proprietà di quel canale. Le metriche video aggregate vengono
supportato solo per le richieste API che non utilizzano la dimensione
isCurated
. - Metriche nei contenuti in-playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono anche le visualizzazioni dei video non di proprietà presenti nella playlist, solo quando queste visualizzazioni si sono verificate nel contesto della playlist.
- Le metriche delle playlist supportate identifica le metriche aggregate video e in-playlist che sono supportati per i report sulle playlist.
- Metriche video aggregate
forniscono metriche relative ad attività utente e impressioni aggregate per tutti i video nei
playlist del canale di proprietà di quel canale. Le metriche video aggregate vengono
supportato solo per le richieste API che non utilizzano la dimensione
-
Le seguenti nuove metriche in-playlist sono supportate per i report sulle playlist per i canali. Queste metriche non sono ancora supportate per i report sui proprietari dei contenuti. Tieni presente che queste metriche supportata solo se la richiesta API per recuperare i report non utilizza il parametro Dimensione
isCurated
. Consulta le documentazione di metrics per le definizioni di ogni metrica: -
Il comportamento di
views
ora dipende dal fatto che la richiesta API che ha recuperato il report sulla playlist abbia usato DimensioneisCurated
:- Quando una richiesta include la dimensione
isCurated
, La metricaviews
è in-playlist che indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist del canale. - Quando una richiesta non include la dimensione
isCurated
, La metricaviews
è una metrica video aggregata che specifica il numero totale di volte in cui il video nelle playlist del canale è stato visualizzato, indipendentemente dal fatto che di visualizzazioni avvenute nel contesto della playlist. Il totale aggregato include solo le visualizzazioni di video di proprietà del canale proprietario della playlist.
In questi report, che non utilizzano la dimensioneisCurated
, viene utilizzata la variabile La metricaplaylistViews
indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist. Questa metrica conta le visualizzazioni di tutti i video contenuti nella playlist, indipendentemente dal canale che ne è proprietario.
- Quando una richiesta include la dimensione
-
Per ogni report sulle playlist, i report sui canali la documentazione ora include tabelle che mostrano le metriche supportate per quel report in base se la richiesta API include la dimensione
isCurated
. Consulta la sezione che definisce report sulle playlist basati sul tempo per vedere un esempio.
4 dicembre 2023
L'API YouTube Analytics (Targeted Query) è stata aggiornata in modo da unire due
insightTrafficSourceType
i valori delle dimensioni. In precedenza, la dimensione differenziava i video riprodotti nell'ambito di una playlist
(PLAYLIST
) e visualizzazioni provenienti da una pagina che elenca tutti i video contenuti in una playlist
(YT_PLAYLIST_PAGE
). In futuro, entrambi i tipi di visualizzazioni saranno associati ai
Valore della dimensione PLAYLIST
.
15 dicembre 2022
L'API YouTube Analytics (Targeted Query) supporta due nuove dimensioni e un nuovo report:
-
Un nuovo report fornisce l'attività utente in base alla città. Questo report è disponibile per channels e proprietari dei contenuti. Questo report contiene il nuovo
city
, che identifica la stima di YouTube della città in cui si è verificata l'attività utente. -
Il nuovo
creatorContentType
identifica il tipo di contenuti di YouTube associati all'attività dell'utente metriche nella riga dei dati. I valori supportati sonoLIVE_STREAM
,SHORTS
,STORY
eVIDEO_ON_DEMAND
.La dimensione
creatorContentType
è supportata come facoltativa per tutti report sui video dei proprietari dei contenuti e del canale. -
La guida alle richieste di esempio dell'API di YouTube Analytics ora include esempi per entrambe le nuove dimensioni.
-
I riferimenti alle dimensioni
7DayTotals
e30DayTotals
sono stati rimosso dalla documentazione. Il ritiro di queste dimensioni è stato annunciato a ottobre 2019.
26 agosto 2022
L'API YouTube Analytics (Targeted Query) e l'API YouTube Reporting (Report collettivi) Supporta un nuovo valore dei dettagli delle sorgenti di traffico:
- Nell'API (Targeted Query) dell'API YouTube Analytics, se il parametro
insightTrafficSourceType
della dimensione èSUBSCRIBER
, il valoreinsightTrafficSourceDetail
può essere impostato supodcasts
, che indica che il traffico è stato indirizzato dalla Pagina di destinazione dei podcast. - Nell'API YouTube Reporting (Report collettivi), se
traffic_source_type
della dimensione è3
, il valore Valoretraffic_source_detail
può essere impostato supodcasts
, che indica che il traffico è stato indirizzato dalla Pagina di destinazione dei podcast.
11 febbraio 2022
L'insieme di valori validi per la dimensione gender
subirà delle modifiche a partire da agosto
11 febbraio 2022. Potrebbe trattarsi di una modifica incompatibile con le versioni precedenti dell'implementazione dell'API. In linea con il
Indietro
Sezione Modifiche incompatibili dei Termini di servizio dei servizi API di YouTube, la modifica è
che verrà annunciato sei mesi prima dell'entrata in vigore. Aggiorna l'implementazione dell'API
prima dell'11 agosto 2022, per garantire una transizione ottimale al nuovo insieme di valori.
Le modifiche specifiche apportate sono:
- Nell'API YouTube Analytics (Targeted Query), il parametro
gender
dimensione attualmente supporta due valori:female
emale
. A partire dall'11 agosto 2022 incluso supporterà tre valori:female
,male
euser_specified
. - Nell'API di reporting (collettivi) di YouTube, il parametro
gender
dimensione attualmente supporta tre valori:FEMALE
,MALE
eGENDER_OTHER
. A partire dall'11 agosto 2022, l'insieme di valori supportati cambierà inFEMALE
,MALE
eUSER_SPECIFIED
.
9 febbraio 2022
Due metriche sono state aggiornate per escludere Traffico di clip in loop in data 13 dicembre 2021. Questa modifica interessa sia l'API (Targeted Query) di YouTube Analytics che l'API di YouTube Reporting (Report collettivi).
- Nell'API YouTube Analytics (Targeted Query), il parametro
averageViewDuration
eaverageViewPercentage
metriche escludono entrambe i clip in loop del traffico aggiornato al 13 dicembre 2021. - Nell'API di reporting (collettivi) di YouTube, il parametro
average_view_duration_seconds
eaverage_view_duration_percentage
metriche escludono entrambe i clip in loop del traffico aggiornato al 13 dicembre 2021.
2 febbraio 2022
Questa API di reporting di YouTube (report collettivi) supporta un nuovo valore della dimensione delle sorgenti di traffico che indica che le viste hanno avuto origine Live Redirect:
- Nell'API di reporting (collettivi) di YouTube, il parametro
traffic_source_type
supporta il valore28
.
Per questo tipo di sorgente di traffico, il parametro
traffic_source_detail
specifica l'ID canale da cui è stato indirizzato lo spettatore.
23 settembre 2020
Questa API di YouTube Analytics (Query target) e l'API di reporting di YouTube (Report collettivi) sono entrambe Supportano un nuovo valore della dimensione delle sorgenti di traffico che indica che lo spettatore è stato indirizzato da Scorrere in verticale nell'esperienza di visualizzazione di YouTube Shorts:
- Nell'API (Targeted Query) dell'API YouTube Analytics, il parametro
insightTrafficSourceType
supporta il valoreSHORTS
. - Nell'API di reporting (collettivi) di YouTube, il parametro
traffic_source_type
supporta il valore24
.
La dimensione Dettagli sulle sorgenti di traffico:
insightTrafficSourceDetail
nell'API YouTube Analytics oppure
traffic_source_detail
nell'API YouTube Reporting, non viene compilato per questo nuovo tipo di sorgente di traffico.
20 luglio 2020
Questo aggiornamento riguarda due modifiche che interessano l'API YouTube Analytics (Targeted Query):
- La dimensione massima di un report di YouTube Analytics gruppo è aumentato da 200 a 500 entità.
- Il metodo
reports.query
filters
identifica un elenco di filtri da applicare durante il recupero di YouTube Analytics e i dati di Google Cloud. Il parametro supporta la possibilità di specificare più valori per il parametrovideo
,playlist
, echannel
, oltre ai filtri il numero massimo di ID che possono essere specificati per questi filtri è aumentato da 200 a 500 ID.
13 febbraio 2020
Questo aggiornamento contiene le seguenti modifiche relative a YouTube Analytics (query mirate) e l'API di YouTube Reporting (Report collettivi). Puoi scoprire di più su queste modifiche nel Centro assistenza YouTube.
In entrambe le API, l'insieme di possibili valori di dettagli delle sorgenti di traffico per le notifiche cambierà.
Nelle query mirate
le notifiche sono segnalate come insightTrafficSourceType=NOTIFICATION
. Nella
report collettivi,
le notifiche sono segnalate come traffic_source_type=17
.
I nuovi valori suddividono le notifiche relative ai video caricati e ai live streaming, in precedenza
segnalati come uploaded
, in due categorie:
uploaded_push
- Visualizzazioni provenienti dalle notifiche push inviate a iscritti quando un video è stato caricatouploaded_other
- Visualizzazioni provenienti da notifiche non push, ad esempio notifiche email o nella Posta in arrivo, inviate agli iscritti mentre è stato caricato un video.
Questi valori vengono restituiti per l'intervallo di tempo a partire dal 13 gennaio 2020 (13 gennaio 2020).
Inoltre, ti ricordiamo che questi valori non rappresentano le notifiche stesse, ma il traffico.
sorgenti che hanno generato determinate visualizzazioni su YouTube. Ad esempio, se una riga del report indica views=3
,
traffic_source_type=17
(NOTIFICATION
) e
traffic_source_detail=uploaded_push
, la riga indica che tre visualizzazioni
è il risultato dei clic degli spettatori sulle notifiche push inviate al momento del caricamento del video.
15 ottobre 2019
Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Analytics (Targeted Query):
-
Nota: questo è un annuncio relativo al ritiro.
YouTube rimuoverà il supporto per le dimensioni
7DayTotals
e30DayTotals
. Puoi comunque recuperare i dati utilizzando queste dimensioni fino al 15 aprile 2020. A partire da questa data, i tentativi di recupero dei report utilizzando la dimensione7DayTotals
o30DayTotals
restituiranno un errore.Tieni presente che gli utenti possono riprodurre alcuni dati per queste dimensioni eseguendo query con la dimensione
day
e aggregando o ricavando dati in periodi di sette o 30 giorni. Ad esempio:- Il numero di visualizzazioni relativo a un periodo di sette giorni può essere calcolato aggregando il numero di visualizzazioni per ogni giorno del periodo in questione.
- La percentuale di spettatori per un periodo di sette giorni può essere calcolata moltiplicando il numero di visualizzazioni avvenute ogni giorno per la percentuale di spettatori per quel giorno, in modo da ottenere il numero di spettatori che hanno effettuato l'accesso durante la visione del video quel giorno. Quindi, il numero di spettatori che hanno eseguito l'accesso può essere sommato per l'intero periodo e diviso per il numero totale di visualizzazioni nel periodo in questione per ottenere la percentuale di spettatori per l'intero periodo.
- Non è possibile calcolare il numero di spettatori unici in un periodo di sette giorni, dal momento che è possibile calcolare lo stesso spettatore come spettatore unico in giorni diversi. Tuttavia, potresti utilizzare la dimensione
month
anziché la dimensione30DayTotals
per estrapolare i dati sul numero di spettatori unici in un periodo di 30 giorni. Tieni presente che la dimensionemonth
fa riferimento ai mesi di calendario, mentre la dimensione30DayTotals
calcola periodi di 30 giorni in base alle date di inizio e di fine specificate.
27 giugno 2019
Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Analytics (Targeted Query):
-
Poiché la versione 1 dell'API è ora completamente deprecata, la documentazione è stata aggiornata in modo da rimuovere i riferimenti a quella versione, inclusi l'avviso sul ritiro e la guida alla migrazione che spiega come eseguire l'aggiornamento alla versione 2.
1 novembre 2018
Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Analytics (Targeted Query):
-
La versione 1 dell'API è ora deprecata. Se non lo hai già fatto, aggiorna i tuoi client API in modo che utilizzino la versione 2 dell'API il prima possibile per ridurre al minimo le interruzioni del servizio. Per ulteriori dettagli, consulta la guida alla migrazione.
Tieni presente che il programma di questo ritiro è stato originariamente annunciato il 26 aprile 2018.
17 settembre 2018
Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Analytics (Targeted Query):
-
La nuova sezione sull'anonimizzazione dei dati nel documento di panoramica sul modello dei dati spiega che alcuni dati di YouTube Analytics sono limitati quando le metriche non raggiungono una determinata soglia. Ciò può accadere in diversi casi. In pratica, un report potrebbe non contenere tutti i dati (o nessuno) se:
-
un video o un canale ha traffico limitato in un determinato periodo di tempo
o
-
hai selezionato un filtro o una dimensione, come sorgente di traffico o paese, per i quali i valori non soddisfano una determinata soglia.
La nuova sezione include anche una discussione sui tipi di dati che potrebbero essere limitati nei report di YouTube Analytics.
-
-
I documenti relativi ai report sui canali e ai report sui proprietari dei contenuti sono stati aggiornati per riflettere il fatto che le metriche
redViews
eestimatedRedMinutesWatched
non sono più supportate per i report su luogo di visualizzazione, sorgente di traffico e tipo di dispositivo/sistema operativo.
18 giugno 2018
Questo aggiornamento contiene le seguenti modifiche all'API (Targeted Query) di YouTube Analytics:
- I requisiti di ambito per i seguenti metodi sono cambiati:
- Le richieste al metodo
reports.query
devono avere accesso all'ambitohttps://www.googleapis.com/auth/youtube.readonly
. - Le richieste al metodo
groupItems.list
devono avere accesso a:- l'
https://www.googleapis.com/auth/youtube
ambito
o - l'
https://www.googleapis.com/auth/youtube.readonly
ambito
e
l'ambitohttps://www.googleapis.com/auth/yt-analytics.readonly
La prima opzione utilizza un ambito, che è di lettura-scrittura, mentre la seconda opzione utilizza due ambiti di sola lettura.
- l'
- Le richieste al metodo
23 maggio 2018
Questo aggiornamento contiene le seguenti modifiche all'API (Targeted Query) di YouTube Analytics:
- La Panoramica dell'API contiene una nuova sezione, metriche aggregate ed elementi eliminati, in cui viene spiegato in che modo le risposte dell'API gestiscono i dati associati alle risorse eliminate, come video, playlist o canali.
- La sezione Best practice della panoramica dell'API è stata aggiornata per ricordarti che puoi utilizzare l'API di dati di YouTube per recuperare ulteriori metadati per le risorse identificate nelle risposte dell'API di YouTube Analytics. Come indicato nelle Norme per gli sviluppatori dei servizi API di YouTube (sezioni da III.E.4.b a III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviate dall'API dopo 30 giorni.
22 maggio 2018
Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Reporting (Report collettivi):
- Le seguenti modifiche dovrebbero entrare in vigore nel mese di luglio 2018 e le nuove norme verranno applicate a livello globale a tutti i report e le offerte di lavoro corrispondenti.
-
Dopo la modifica, la maggior parte dei report dell'API, compresi i report di backfill, sarà disponibile per 60 giorni a partire dalla relativa generazione. Tuttavia, i report contenenti dati storici saranno disponibili per 30 giorni a partire dalla data di generazione.
Prima di questo annuncio, tutti i report dell'API erano disponibili per 180 giorni dal momento in cui sono stati generati. Per essere chiari, quando questa modifica alle norme entrerà in vigore, non saranno più accessibili tramite l'API anche i report dei dati storici che risalgono a più di 30 giorni fa. Inoltre, tutti gli altri report che risalgono a più di 60 giorni fa non saranno più accessibili. Di conseguenza, la documentazione ora indica che i report creati prima della modifica alle norme saranno disponibili per un massimo 180 giorni.
-
Dopo la modifica, quando pianifichi un job di generazione di report, YouTube genera report da quel giorno in poi coprendo il periodo di 30 giorni precedente all'orario in cui è stato pianificato il lavoro. Prima della modifica, quando pianifichi un job di generazione dei report, YouTube genera dei report che coprono il periodo di 180 giorni precedente all'orario in cui il lavoro è stato pianificato.
-
-
La sezione Best practice è stata aggiornata per ricordarti che puoi utilizzare l'API di dati di YouTube per recuperare ulteriori metadati per le risorse identificate nei report. Come indicato nelle Norme per gli sviluppatori dei servizi API di YouTube (sezioni da III.E.4.b a III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviate dall'API dopo 30 giorni.
-
La sezione Caratteristiche dei report è stata aggiornata per notare che, anche se i dati dei report non sono filtrati, i report contenenti dati relativi a un periodo di tempo a partire dal 1° giugno 2018 non conterranno riferimenti a risorse di YouTube eliminate almeno 30 giorni prima della data di generazione del report.
-
La sezione Dati storici della panoramica dell'API è stata aggiornata per notare che, quando pianifichi un nuovo job di generazione dei report, i report storici vengono pubblicati in genere entro un paio di giorni. In precedenza, la documentazione affermava che potrebbero essere necessari fino a 30 giorni prima che questi report siano disponibili.
-
La sezione relativa ai dati di backfill della panoramica dell'API è stata aggiornata per definire più chiaramente i dati di backfill come un set di dati che sostituisce un set pubblicato in precedenza.
26 aprile 2018
La versione 2 dell'API YouTube Analytics (Targeted Query) (v2) è ora disponibile pubblicamente. Il seguente elenco identifica le modifiche al prodotto e alla documentazione relative alla nuova versione dell'API:
-
L'API v2 è quasi identica all'API v1. Tuttavia, potrebbe essere necessario aggiornare il codice per riflettere le modifiche elencate di seguito. Tutte queste modifiche sono spiegate in dettaglio nella nuova guida alla migrazione.
- La versione dell'API è cambiata da
v1
av2
. - L'URL di base per le richieste API è cambiato da
https://www.googleapis.com/youtube/analytics/v1
ahttps://youtubeanalytics.googleapis.com/v2
. - Diversi parametri del metodo
reports.query
hanno nomi aggiornati. In particolare, i nomi dei parametri che contengono trattini, ad esempioend-date
nell'API v1, utilizzano la lettera "cammello" (endDate
) anziché i trattini nell'API v2. Questa modifica rende i nomi dei parametri coerenti in tutta l'API, poiché i metodi dell'API per creare e gestire i gruppi già utilizzavano lettere maiuscole e minuscole per i nomi dei parametri. - L'API v2 non supporta le richieste batch inviate all'endpoint batch HTTP globale di Google (
www.googleapis.com/batch
). Se invii richieste batch nell'API v2, devi utilizzare invece l'endpointhttps://youtubeanalytics.googleapis.com/v2
.
Inoltre, alcune funzionalità della versione 1 non sono supportate nell'API v2:
- Il metodo
reports.query
non supporta più i parametri di richiestaalt
,quotaUser
euserIp
. - L'API v2 non fornisce un endpoint batch che supporti batch costituiti da richieste a API diverse. Un batch può però essere composto da richieste a diversi metodi della stessa API. Questo ritiro non riguarda in modo specifico l'API YouTube Analytics, in quanto Google sta ritirando l'endpoint batch globale in tutte le sue API.
- L'API v2 non supporta il protocollo JSON-RPC, supportato nell'API v1. Ribadiamo che questo ritiro non riguarda in modo specifico l'API YouTube Analytics.
- La versione dell'API è cambiata da
-
Nota: questo è un annuncio relativo al ritiro.
La versione 1 dell'API (v1) è ora deprecata e sarà supportata fino al 31 ottobre 2018. Tutte le richieste all'API v1 smetteranno di funzionare dopo questa data. Pertanto, assicurati di eseguire l'upgrade all'API v2 entro il 31 ottobre 2018 per evitare qualsiasi interruzione nella tua capacità di accedere ai dati di YouTube Analytics tramite l'API.
21 febbraio 2018
Questo aggiornamento contiene le seguenti modifiche all'API (Targeted Query) di YouTube Analytics:
- Report sulle categorie demografiche degli spettatori, che aggregano le statistiche di visualizzazione in base ai dati età e genere non supportano più la dimensione
youtubeProduct
, che identifica il servizio YouTube su cui si è verificata l'attività utente.
18 gennaio 2018
Questo aggiornamento contiene le seguenti modifiche:
-
API di reporting di YouTube (report collettivi)
- La dimensione
operating_system
, che identifica il sistema software del dispositivo su cui si sono verificate le visualizzazioni, ora supporta il seguente valore:25
: KaiOS
- La dimensione
-
API di YouTube Analytics (query mirate)
- La dimensione
operatingSystem
supporta il valore della dimensioneKAIOS
.
- La dimensione
20 dicembre 2017
Questo aggiornamento contiene due modifiche relative all'API di reporting di YouTube:
-
Il server API ora supporta la compressione gzip per le richieste che scaricano i report. Tieni presente che la compressione gzip non è supportata per altri tipi di richieste API. L'abilitazione della compressione gzip riduce la larghezza di banda necessaria per ogni risposta dell'API. Inoltre, anche se l'applicazione avrà bisogno di più tempo di CPU per decomprimere le risposte dell'API, il vantaggio di un consumo inferiore di risorse di rete solitamente supera questo costo.
Per ricevere una risposta con codifica gzip, imposta l'intestazione della richiesta HTTP
Accept-Encoding
sugzip
, come mostrato nell'esempio seguente:Accept-Encoding: gzip
Questa funzionalità è spiegata nella panoramica dell'API e nella definizione della proprietà
downloadUrl
della risorsareport
. -
La documentazione delle dimensioni
age group
egender
è stata corretta per mostrare i valori effettivi che l'API restituisce per queste dimensioni. Tieni presente che questa è una correzione della documentazione e non riflette un cambiamento nella funzionalità o nel comportamento dell'API. In particolare, sono stati modificati i seguenti valori:- I valori della dimensione
age_group
utilizzano lettere maiuscole, contengono trattini bassi tra la parolaAGE
e i numeri della fascia d'età e utilizzano trattini bassi al posto dei trattini. Di conseguenza, valori comeage13-17
eage18-24
sono stati corretti rispettivamente inAGE_13_17
eAGE_18_24
. - I valori della dimensione
gender
utilizzano lettere maiuscole. Pertanto, i valorifemale
,male
egender_other
sono stati corretti inFEMALE
,MALE
eGENDER_OTHER
.
- I valori della dimensione
10 agosto 2017
Il 10 agosto 2016 questa documentazione ha annunciato il ritiro della metrica earnings
dell'API di YouTube Analytics. Allo stesso tempo, l'API ha aggiunto il supporto di una nuova metrica, denominata estimatedRevenue
, che fornisce gli stessi dati.
Poiché la metrica earnings
era una metrica principale, è stata supportata per un anno dalla data dell'annuncio. Tuttavia, al termine di questo periodo di un anno, la metrica earnings
non è più supportata. Di conseguenza, le richieste API che specificano la metrica earnings
ora restituiscono un codice di risposta HTTP 400
. Se non hai già aggiornato l'app in modo da utilizzare la metrica estimatedRevenue
anziché la metrica earnings
, esegui l'aggiornamento il prima possibile.
La documentazione dell'API è stata aggiornata in modo da rimuovere i riferimenti rimanenti alla metrica earnings
.
6 luglio 2017
Questo aggiornamento contiene le seguenti modifiche:
-
API di YouTube Analytics (query mirate)
-
La documentazione dell'API è stata aggiornata per riflettere il fatto che le risposte dell'API contengono dati fino all'ultimo giorno dell'intervallo di date richiesto per il quale sono disponibili tutte le metriche oggetto della query.
Ad esempio, se una richiesta specifica la data di fine del 5 luglio 2017 e i valori di tutte le metriche richieste sono disponibili solo fino al 3 luglio 2017, questa sarà l'ultima data per cui i dati sono inclusi nella risposta. Questo vale anche se i dati relativi ad alcune delle metriche richieste sono disponibili per il 4 luglio 2017.
-
La dimensione
adType
ora supporta il valorereservedBumperInstream
, che fa riferimento a un annuncio video non ignorabile di massimo 6 secondi che viene riprodotto prima di poter visualizzare il video. Il formato dell'annuncio è identico a quello dell'annuncioauctionBumperInstream
, ma questo tipo si riferisce agli annunci venduti su prenotazione anziché su base di asta.
-
-
API di reporting di YouTube (report collettivi)
-
La dimensione
ad_type
ora supporta il valore20
, che si riferisce agli annunci bumper venduti su base prenotata. Gli annunci bumper sono annunci video non ignorabili della durata massima di 6 secondi che vengono riprodotti prima di poter visualizzare un video. Tieni presente che il valore19
per questa dimensione si riferisce anche agli annunci bumper venduti in occasione di un'asta e non su base prenotata. -
I job di segnalazione per i seguenti report dell'API di reporting di YouTube sono stati eliminati:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Questi tipi di report sono stati annunciati come ritirati il 15 settembre 2016 e, dopo il 15 dicembre 2016, non sono più stati generati report per questi tipi di report. I report generati in precedenza sono rimasti disponibili per 180 giorni dal momento in cui sono stati generati. Pertanto, alcuni report erano accessibili dal 15 giugno 2017. Tuttavia, poiché i report non sono più disponibili, neanche i job associati ai report sono necessari.
-
24 maggio 2017
Tutti i job di reporting per i seguenti report dell'API di reporting di YouTube sono stati eliminati:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Questi tipi di report sono stati annunciati come ritirati il 22 giugno 2016 e, a partire dal 22 settembre 2016, non sono più stati generati report per questi tipi di report. I report generati in precedenza sono rimasti disponibili per 180 giorni dal momento in cui sono stati generati. Pertanto, alcuni report erano accessibili fino al 22 marzo 2017. Tuttavia, poiché i report non sono più disponibili, neanche i job associati ai report sono necessari.
22 maggio 2017
Questo aggiornamento contiene le seguenti modifiche:
-
API di reporting di YouTube (report collettivi)
- La dimensione
sharing_service
, che identifica il servizio utilizzato per condividere i video, ora supporta i seguenti valori:85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
Inoltre, il nome utilizzato per identificare il valore
52
è stato aggiornato nella documentazione in Kakao (Kakao Talk) per distinguerlo più chiaramente dal valore73
(Storia Kakao). Questa modifica non riflette alcun cambiamento nel comportamento delle API o nella classificazione dei video condivisi con questi servizi.
- La dimensione
-
API di YouTube Analytics (query mirate)
- La dimensione
sharingService
ora supporta i seguenti valori:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- La dimensione
28 marzo 2017
I proprietari dei canali che possono accedere ai dati sulle entrate tramite YouTube Analytics in Creator Studio ora possono accedere a tali dati anche tramite l'API YouTube Analytics:
-
L'API supporta le seguenti metriche relative alle entrate:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Queste metriche sono supportate per i seguenti report:
-
I proprietari dei canali possono ora recuperare un report sul rendimento degli annunci, che supporta la dimensione
adType
e la dimensione facoltativaday
. -
La guida alle richieste di esempio dell'API di YouTube Analytics ora include una sezione per i report Entrate del canale.
17 marzo 2017
Questo aggiornamento contiene le seguenti modifiche:
-
L'API YouTube Analytics supporta le metriche
redViews
eestimatedRedMinutesWatched
, entrambe relative alle visualizzazioni di YouTube Red. Infatti, l'API supporta già queste metriche da un po' di tempo ed è già supportata dall'API di reporting di YouTube, come annunciato il 15 settembre 2016.- La metrica
redViews
identifica il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Red. - La metrica
estimatedRedMinutesWatched
identifica il numero di minuti durante i quali gli abbonati a YouTube Red hanno guardato un video.
La documentazione relativa ai report sui canali e ai report sui proprietari dei contenuti è stata aggiornata per mostrare quali report supportano le due nuove metriche. Sono supportate in tutti i report che supportavano già le metriche
views
eestimatedMinutesWatched
. - La metrica
3 marzo 2017
Questo aggiornamento contiene le seguenti modifiche:
-
API di reporting di YouTube (report collettivi)
-
La definizione della dimensione
date
è stata corretta per tenere presente che il valore della dimensione si riferisce al periodo che inizia alle 00:00 fuso orario del Pacifico e termina alle 23:59. Fuso orario del Pacifico nel giorno, nel mese e nell'anno specificati. A seconda del periodo dell'anno, il fuso orario del Pacifico può essere UTC-7 o UTC-8.Sebbene in genere le date rappresentino un periodo di 24 ore, le date in cui gli orologi vengono regolati in avanti rappresentano un periodo di 23 ore, mentre le date in cui gli orologi vengono regolati indietro rappresentano un periodo di 25 ore. In precedenza, la documentazione indicava che ogni data rappresentava un periodo unico di 24 ore e che il fuso orario del Pacifico era sempre UTC-8.
Tieni presente che questa correzione non rappresenta un cambiamento nel comportamento effettivo dell'API.
- La dimensione
operating_system
, che identifica il sistema software del dispositivo su cui si sono verificate le visualizzazioni, ora supporta i seguenti valori:22
: Tizen23
: Firefox24
: RealMedia
-
Tutti i job di reporting per il tipo di report
content_owner_basic_a1
sono stati eliminati. Questo tipo di report è stato ritirato completamente il 19 agosto 2016, ma i reportcontent_owner_basic_a1
generati in precedenza erano ancora disponibili per 180 giorni dal momento della generazione. Pertanto, alcuni report erano accessibili fino al 19 febbraio 2017. Tuttavia, poiché i report non sono più disponibili, neanche i job associati ai report sono necessari.
-
-
API di YouTube Analytics (query mirate)
-
La descrizione delle dimensioni relative a
time periods
è stata corretta per tenere presente che il valore della dimensione si riferisce al periodo che inizia alle 00:00 fuso orario del Pacifico e termina alle 23:59. Fuso orario del Pacifico nel giorno, nel mese e nell'anno specificati. A seconda del periodo dell'anno, il fuso orario del Pacifico può essere UTC-7 o UTC-8.Sebbene in genere le date rappresentino un periodo di 24 ore, le date in cui gli orologi vengono regolati in avanti rappresentano un periodo di 23 ore, mentre le date in cui gli orologi vengono regolati indietro rappresentano un periodo di 25 ore. (In precedenza, la documentazione affermava che l'ora del Pacifico era UTC-8 e non menzionava la possibilità che un giorno potesse non rappresentare un periodo di 24 ore).
Tieni presente che questa correzione non rappresenta un cambiamento nel comportamento effettivo dell'API.
-
La documentazione relativa ai report sui canali è stata aggiornata affinché i report sui canali al momento non contengano metriche sulle entrate o sul rendimento degli annunci. Di conseguenza, l'ambito
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
al momento non concede l'accesso ai dati monetari nei report dei canali. - La dimensione
operatingSystem
supporta tre nuovi valori di dimensione:FIREFOX
REALMEDIA
TIZEN
-
8 febbraio 2017
L'API YouTube Analytics ora supporta il parametro facoltativo include-historical-channel-data
. Tieni presente che questo parametro è pertinente solo quando si recuperano i report sui proprietari dei contenuti.
Questo parametro consente a un proprietario dei contenuti di indicare che una risposta dell'API deve includere i canali il tempo di visualizzazione e i dati relativi alle visualizzazioni del periodo precedente a quello in cui i canali sono stati collegati al proprietario dei contenuti. Il valore predefinito del parametro è false
. Ciò significa che, per impostazione predefinita, la risposta dell'API include solo i dati relativi al tempo di visualizzazione e alle visualizzazioni dal momento in cui i canali sono stati collegati al proprietario dei contenuti.
Queste regole si applicano anche se la richiesta API recupera i dati di più canali:
- Se il valore del parametro è
false
, i dati restituiti sul tempo di visualizzazione e sulle visualizzazioni per un determinato canale si basano sulla data in cui il canale è stato collegato al proprietario dei contenuti.
È importante ricordare che canali diversi potrebbero essere stati collegati a un proprietario dei contenuti in date diverse. Se la richiesta API sta recuperando dati per più canali e il valore del parametro èfalse
, la risposta dell'API conterrà il tempo di visualizzazione e i dati sulle visualizzazioni in base alla data di collegamento per ciascun canale. - Se il valore del parametro è
true
, la risposta restituisce il tempo di visualizzazione e i dati di visualizzazione per tutti i canali in base alle date di inizio e di fine specificate nella richiesta API.
15 dicembre 2016
I seguenti report dell'API di reporting di YouTube non sono più supportati e sono stati rimossi dalla documentazione. È disponibile una versione più recente di ogni report. L'annuncio sul ritiro di questi rapporti è stato emesso il 15 settembre 2016.
-
Report sui canali
channel_basic_a1
: sostituito dal reportchannel_basic_a2
.channel_province_a1
: sostituito dal reportchannel_province_a2
.channel_playback_location_a1
: sostituito dal reportchannel_playback_location_a2
.channel_traffic_source_a1
: sostituito dal reportchannel_traffic_source_a2
.channel_device_os_a1
: sostituito dal reportchannel_device_os_a2
.channel_subtitles_a1
: sostituito dal reportchannel_subtitles_a2
.channel_combined_a1
: sostituito dal reportchannel_combined_a2
.
-
Report dei proprietari dei contenuti
content_owner_basic_a2
: sostituito dal reportcontent_owner_basic_a3
.content_owner_province_a1
: sostituito dal reportcontent_owner_province_a2
.content_owner_playback_location_a1
: sostituito dal reportcontent_owner_playback_location_a2
.content_owner_traffic_source_a1
: sostituito dal reportcontent_owner_traffic_source_a2
.content_owner_device_os_a1
: sostituito dal reportcontent_owner_device_os_a2
.content_owner_subtitles_a1
: sostituito dal reportcontent_owner_subtitles_a2
.content_owner_combined_a1
: sostituito dal reportcontent_owner_combined_a2
.content_owner_asset_basic_a1
: sostituito dal reportcontent_owner_asset_basic_a2
.content_owner_asset_province_a1
: sostituito dal reportcontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
: sostituito dal reportcontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
: sostituito dal reportcontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
: sostituito dal reportcontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
: sostituito dal reportcontent_owner_asset_combined_a2
.
È stato aggiornato anche l'elenco dei tipi di report attuali nella documentazione di riferimento dell'API.
11 novembre 2016
Questo aggiornamento contiene le seguenti modifiche:
-
Report sulle schermate finali
- Il report sulle schermate finali per i video del canale contiene le statistiche per tutti i video di un canale.
- Il report sulle schermate finali per i video dei proprietari dei contenuti contiene le statistiche relative ai video su qualsiasi canale di un proprietario dei contenuti.
- Il report sulle schermate finali per le risorse dei proprietari dei contenuti contiene le statistiche relative alle risorse associate ai video dopo i quali vengono visualizzate le schermate finali.
-
Dimensioni della schermata finale
end_screen_element_type
: il tipo di elemento della schermata finale associato alle statistiche.end_screen_element_id
: l'ID utilizzato da YouTube per identificare in modo univoco l'elemento della schermata finale.
Metriche delle schermate finali
Nota:i dati per le metriche delle schermate finali sono disponibili a partire dal 1° maggio 2016.
end_screen_element_impressions
: il numero totale di impressioni degli elementi delle schermate finali. Viene registrata un'impressione per ogni elemento della schermata finale visualizzato.end_screen_element_clicks
: il numero di volte in cui è stato fatto clic sugli elementi della schermata finale.end_screen_element_click_rate
: la percentuale di clic per gli elementi della schermata finale.
-
I seguenti report non sono più supportati e sono stati rimossi dalla documentazione. È disponibile una versione più recente di ogni report. L'annuncio sul ritiro di questi rapporti è stato emesso il 22 giugno 2016.
content_owner_ad_performance_a1
: sostituito dal reportcontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
: sostituito dal reportcontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
: sostituito dal reportcontent_owner_asset_estimated_revenue_a1
.
-
Le metriche nell'elenco seguente sono completamente deprecate e non sono più supportate. Come annunciato il 10 agosto 2016, sono già supportate nuove metriche che fanno riferimento agli stessi dati. La tabella seguente mostra il nome della metrica obsoleta e quello nuovo:
Metrica deprecata Nuova metrica adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Entrate pubblicitarie mensili globali per video
- Entrate pubblicitarie giornaliere per video, per paese
- Entrate pubblicitarie mensili globali per risorsa
- Entrate pubblicitarie giornaliere per paese e per risorsa
- Rivendicazioni (questo report non contiene dati sulle entrate)
-
L'API supporta due nuove metriche relative alle visualizzazioni di YouTube Red:
red_views
: il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Red.red_watch_time_minutes
: il numero di minuti durante i quali gli abbonati a YouTube Red hanno guardato un video.
-
L'API supporta nuove versioni di 20 report. Tutte le nuove versioni supportano le nuove metriche
red_views
ered_watch_time_minutes
.Per ogni report, il numero nel nuovo ID tipo di report è un numero superiore di un valore rispetto al vecchio ID tipo di report. Le versioni precedenti di questi report sono ora obsolete, come descritto più avanti in questa cronologia delle revisioni. Ad esempio, il report
channel_basic_a1
è stato ritirato ed è stato sostituito dal reportchannel_basic_a2
.I seguenti elenchi identificano i nuovi ID tipo di report:
Report sui video del canale
Report sui video del proprietario dei contenuti
Report sugli asset del proprietario dei contenuti
-
Nota: questo è un annuncio relativo al ritiro.
Tieni presente che, se hai già job per creare una delle versioni precedenti dei report elencate sopra, devi creare nuovi job per i report rinominati. In concomitanza con il rilascio delle nuove versioni dei report, sono state ritirate le seguenti versioni dei report:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Se hai offerte di lavoro per uno di questi rapporti, non aspettarti che YouTube generi nuovi rapporti per quei lavori dopo il 15 dicembre 2016. I report generati saranno ancora disponibili per 180 giorni dal momento in cui sono stati generati.
-
Il report
content_owner_basic_a1
è stato completamente deprecato e rimosso dalla documentazione. YouTube non genererà più nuovi report di questo tipo, anche se quelli già generati saranno ancora disponibili per 180 giorni dal momento in cui sono stati generati.La sostituzione del report
content_owner_basic_a1
è il reportcontent_owner_basic_a2
, come spiegato nella voce relativa alla cronologia delle revisioni del 19 maggio 2016. -
I nuovi Termini di servizio dei servizi API di YouTube ("i Termini aggiornati"), discussi in dettaglio sul Blog di YouTube Engineering and Developers, forniscono un'ampia gamma di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto per spiegare le norme che gli sviluppatori devono seguire.
L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate anche nella cronologia delle revisioni. Puoi iscriverti a un feed RSS che elenca le modifiche nella cronologia delle revisioni da un link nel documento.
-
API di YouTube Analytics (query mirate)
-
Nota: questo è un annuncio relativo al ritiro.
Le metriche nella seguente tabella sono state ritirate. Allo stesso tempo, vengono introdotte nuove metriche che fanno riferimento agli stessi dati. In effetti, ciò significa che le vecchie metriche verranno rinominate, anche se l'API di YouTube Analytics supporterà i nomi di entrambe le metriche fino alle date di ritiro elencate nella tabella.
Nome precedente della metrica Nuovo nome metrica Data di assistenza earnings
estimatedRevenue
10 agosto 2017 adEarnings
estimatedAdRevenue
4 novembre 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 novembre 2016 impressionBasedCpm
cpm
4 novembre 2016 impressions
adImpressions
4 novembre 2016 Tieni presente che la metrica
earnings
era una metrica principale, perciò sarà supportata per un anno a partire dalla data di questo annuncio. Le altre metriche, che non erano metriche principali, saranno supportate per tre mesi, fino al 4 novembre 2016.Ad esempio, fino al 4 novembre 2016, una richiesta API può specificare la metrica
impressionBasedCpm
, la metricacpm
o entrambe. Tuttavia, dopo questa data sarà supportata solo la metricacpm
. - La dimensione
insightTrafficSourceType
supporta due nuovi valori di dimensione:CAMPAIGN_CARD
: questa sorgente di traffico è supportata solo per i report sui proprietari dei contenuti. Indica che le visualizzazioni hanno avuto origine da video rivendicati caricati dagli utenti, che il proprietario dei contenuti ha utilizzato per promuovere i contenuti visualizzati.END_SCREEN
: i dati si riferiscono alle visualizzazioni provenienti dalla schermata finale di un altro video.
Per entrambe le nuove sorgenti di traffico, puoi anche recuperare un report
traffic source detail
. In entrambi i casi, la dimensioneinsightTrafficSourceDetail
identifica il video da cui è stato indirizzato lo spettatore. -
La dimensione
adType
ora supporta il valoreauctionBumperInstream
, che fa riferimento a un annuncio video non ignorabile di massimo 6 secondi che viene riprodotto prima di poter visualizzare il video.
-
-
API di reporting di YouTube (report collettivi)
- La dimensione
traffic_source_type
ora supporta i seguenti valori:19
: questa sorgente di traffico è supportata solo per i report sui proprietari dei contenuti. Indica che le visualizzazioni hanno avuto origine da video rivendicati caricati dagli utenti, che il proprietario dei contenuti ha utilizzato per promuovere i contenuti visualizzati.20
: i dati si riferiscono alle visualizzazioni provenienti dalla schermata finale di un altro video.
Per entrambe le nuove sorgenti di traffico, la dimensione
traffic_source_detail
identifica il video da cui è stato indirizzato lo spettatore. -
L'elenco delle metriche principali dell'API è stato corretto in modo da indicare
estimated_partner_revenue
come metrica principale e rimuovereearnings
dall'elenco. La metricaearnings
non è mai stata supportata nell'API di reporting di YouTube. -
La dimensione
ad_type
ora supporta il valore19
che si riferisce agli annunci bumper, ovvero annunci video non ignorabili della durata massima di 6 secondi che vengono riprodotti prima di poter visualizzare il video.
- La dimensione
-
API di YouTube Analytics (query mirate)
- Gli elenchi di metriche supportate per i seguenti report sui canali sono stati aggiornati in modo da includere le metriche delle schede. Il supporto per le metriche delle schede in questi report è stato effettivamente aggiunto il 28 giugno 2016 e la voce relativa alla cronologia delle revisioni per quella data spiega il cambiamento in modo più dettagliato. I report sono:
- Attività utente di base per gli stati degli Stati Uniti
- Attività utente negli stati degli Stati Uniti per periodi di tempo specifici
- Attività utente per provincia
- Attività utente per stato di iscrizione
- Attività utente in base allo stato di iscrizione per le province
- Video principali per stato
- Video principali per gli spettatori iscritti o non iscritti
-
Gli elenchi di filtri sono stati corretti sia per i report Fidelizzazione del pubblico del canale sia per i report Fidelizzazione del pubblico dei proprietari dei contenuti per indicare che è necessario il filtro
video
e che il filtrogroup
non è supportato.In precedenza, la documentazione di entrambi i report indicava erroneamente che il report poteva essere recuperato utilizzando uno di questi due filtri o nessuno dei due filtri.
- Gli elenchi di metriche supportate per i seguenti report sui canali sono stati aggiornati in modo da includere le metriche delle schede. Il supporto per le metriche delle schede in questi report è stato effettivamente aggiunto il 28 giugno 2016 e la voce relativa alla cronologia delle revisioni per quella data spiega il cambiamento in modo più dettagliato. I report sono:
-
API di reporting di YouTube (report collettivi)
- Nella panoramica dell'API, la sezione che spiega come recuperare l'URL di download di un report è stata corretta per indicare che YouTube genera report scaricabili per i giorni in cui non erano disponibili dati. Questi report contengono una riga di intestazione, ma non contengono dati aggiuntivi. Queste informazioni erano già state aggiornate nella sezione Caratteristiche dei report dello stesso documento il 12 aprile 2016.
- L'elenco delle dimensioni nel report
content_owner_asset_cards_a1
è stato corretto per indicare che il report utilizza la dimensionecard_id
. In precedenza, la documentazione indicava erroneamente il nome della dimensione comecard_title
.
- Statistiche di base(canali, proprietari dei contenuti)
- In base al tempo(canali, proprietari dei contenuti)
- Area geografica degli utenti (canali, proprietari dei contenuti)
- Attività degli utenti per stato di iscrizione (canali, proprietari dei contenuti)
- Video principali (canali, proprietari dei contenuti)
-
La sezione Caratteristiche dei report della panoramica dell'API è stata aggiornata per chiarire che i report sono disponibili tramite l'API per 180 giorni dal momento in cui vengono generati.
In precedenza, la documentazione indicava che i report erano disponibili per un periodo massimo di 180 giorni precedente la data di invio della richiesta API. Sebbene sia tecnicamente vero, il testo originale era, nella migliore delle ipotesi, piuttosto confuso.
-
L'API supporta le nuove versioni di tre report. Due di questi report contengono anche metriche nuove e rinominate:
-
Il report
content_owner_ad_rates_a1
è la nuova versione del reportcontent_owner_ad_performance_a1
. Il report appena rinominato è identico alla versione precedente. -
Due report con nuove versioni sono stati rinominati:
- La nuova versione del report
content_owner_estimated_earnings_a1
si chiamacontent_owner_estimated_revenue_a1
. - La nuova versione del report
content_owner_asset_estimated_earnings_a1
si chiamacontent_owner_asset_estimated_revenue_a1
.
Entrambi i report appena rinominati differiscono dai predecessori per i seguenti aspetti:
- Viene aggiunta la nuova metrica
estimated_partner_red_revenue
, che offre una stima degli utili totali derivanti dagli abbonamenti a YouTube Premium. - Viene aggiunta la nuova metrica
estimated_partner_transaction_revenue
, che stima le entrate derivanti dalle transazioni, come contenuti a pagamento e finanziamenti dei fan, meno eventuali rimborsi addebitati dai partner. - La metrica
estimated_partner_ad_sense_revenue
viene rinominataestimated_partner_ad_auction_revenue
. - La metrica
estimated_partner_double_click_revenue
viene rinominataestimated_partner_ad_reserved_revenue
.
- La nuova versione del report
Tieni presente che se disponi già di job per creare una delle versioni precedenti di questi report, devi creare nuovi job per i report rinominati. In occasione del rilascio delle nuove versioni dei report, i report
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
econtent_owner_asset_estimated_earnings_a1
sono stati ritirati.Se hai offerte di lavoro per uno di questi rapporti, non aspettarti che YouTube generi nuovi rapporti per quei lavori dopo il 22 settembre 2016. I report generati saranno ancora disponibili per 180 giorni dal momento in cui sono stati generati.
-
-
La definizione della proprietà
id
della risorsareportType
è stata aggiornata per riflettere l'insieme attuale di report disponibili. -
I nomi di due metriche sono stati corretti nella documentazione in modo che corrispondano ai nomi visualizzati nei report. Si tratta solo di una correzione relativa alla documentazione e non riflette una modifica dei contenuti effettivi del report:
- Il nome della metrica
estimated_partner_adsense_revenue
è stato aggiornato aestimated_partner_ad_sense_revenue
. Tieni presente, tuttavia, che questa metrica viene visualizzata solo nei due report che verranno ritirati con questo aggiornamento. Come descritto in precedenza, questa metrica è stata rinominataestimated_partner_ad_auction_revenue
nelle versioni più recenti di questi report. - Il nome della metrica
estimated_partner_doubleclick_revenue
è stato aggiornato aestimated_partner_double_click_revenue
. Anche in questo caso, tieni presente che questa metrica viene visualizzata solo nei due report che verranno ritirati con questo aggiornamento. Come descritto in precedenza, questa metrica è stata rinominataestimated_partner_ad_reserved_revenue
nelle versioni più recenti di questi report.
- Il nome della metrica
-
La documentazione relativa alle dimensioni per l'API di reporting è stata aggiornata in modo da non elencare più le proprietà
elapsed_video_time_percentage
eaudience_retention_type
. Queste dimensioni non sono attualmente supportate dai report disponibili tramite l'API. -
L'API supporta una nuova versione del report sull'attività dell'utente per i proprietari dei contenuti. L'ID del tipo di report del nuovo report è
content_owner_basic_a2
. A differenza della versione precedente del report,content_owner_basic_a1
, la nuova versione supporta le metrichelikes
edislikes
.Se hai già un job per creare il report
content_owner_basic_a1
, devi comunque creare un nuovo job per il reportcontent_owner_basic_a2
. YouTube non esegue automaticamente la migrazione dei proprietari dei contenuti alla nuova versione del report né crea automaticamente un job per generare la nuova versione del report. In alcune implementazioni, l'aspetto di un nuovo lavoro imprevisto potrebbe rappresentare un cambiamento che provoca un errore.In concomitanza con il rilascio del nuovo report, il report
content_owner_basic_a1
è stato ritirato. Se hai un lavoro per quel rapporto, non aspettarti che YouTube generi nuovi rapporti per quel lavoro dopo il 19 agosto 2016. I report generati saranno ancora disponibili per 180 giorni dal momento in cui sono stati generati. -
Le risorse
reportType
,job
ereport
supportano tutte una nuova proprietà che identifica se la risorsa associata rappresenta un tipo di report deprecato:-
La proprietà
deprecateTime
della risorsareportType
specifica la data e l'ora in cui il tipo di report verrà deprecato. Questa proprietà ha un valore solo per i report che sono stati annunciati come deprecati e il valore rappresenta la data in cui YouTube smetterà di generare report di quel tipo.Quando un tipo di report viene annunciato come ritirato, YouTube genera report di quel tipo per altri tre mesi. Ad esempio, questo aggiornamento del 19 maggio 2016 annuncia il ritiro del rapporto
content_owner_basic_a1
. Pertanto, il valoredeprecateTime
per quel tipo di report specifica un'ora a partire dal 19 agosto 2016, trascorsa la quale YouTube non genererà più report di quel tipo. -
La proprietà
expireTime
della risorsajob
specifica la data e l'ora in cui il job è scaduto o scadrà. Questa proprietà ha un valore se il tipo di report associato al job è stato ritirato o se i report generati per il job non sono stati scaricati per un periodo di tempo prolungato. La data indica il momento dopo il quale YouTube non genera più nuovi report per il lavoro. -
La proprietà
jobExpireTime
della risorsareport
specifica la data e l'ora in cui il job associato al report è scaduto o scadrà. Questa proprietà contiene lo stesso valore della proprietàexpireTime
nella risorsajob
, come descritto nell'elemento precedente di questo elenco.
-
-
Il metodo
jobs.create
ora restituisce un codice di risposta HTTP400
(Bad Request
) se provi a creare un job per un report obsoleto. Inoltre, nella documentazione del metodo sono ora elencati diversi altri motivi per cui una richiesta API non riesce. -
YouTube ora genera dati che coprono il periodo di 180 giorni precedente alla pianificazione iniziale di un job di reporting. In precedenza, l'API di reporting non forniva dati storici. Questa modifica interessa tutti i job, inclusi quelli creati prima di questo annuncio.
I report storici vengono pubblicati non appena sono disponibili, anche se occorre circa un mese per la pubblicazione di tutti i dati storici relativi a un lavoro. Quindi, un mese dopo aver pianificato un job di generazione di report, avrai accesso a circa sette mesi di dati. Tutti i dati cronologici per le offerte di lavoro create prima di questo annuncio devono essere pubblicati entro un mese dall'annuncio.
Tieni presente che i dati storici sono disponibili solo a partire dal 1° luglio 2015. Di conseguenza, i job creati prima del 28 dicembre 2015 avranno meno di 180 giorni di dati storici.
Queste modifiche sono spiegate nella nuova sezione Dati storici della panoramica dell'API di reporting.
-
La sezione relativa alle caratteristiche del report della panoramica dell'API di reporting di YouTube è stata aggiornata con le seguenti modifiche:
-
La documentazione ora indica che i report sono disponibili per un periodo di 180 giorni dopo la loro generazione e, pertanto, possono essere scaricati dai client API. In precedenza, la documentazione indicava che i report erano disponibili per un periodo massimo di sei mesi precedente la data di invio della richiesta API.
-
La documentazione è stata aggiornata in modo da riflettere il fatto che ora l'API genera report scaricabili per i giorni in cui non erano disponibili dati. Questi report conterranno righe di intestazione, ma non conterranno dati aggiuntivi.
-
-
A breve l'API YouTube Reporting supporterà una serie di report generati automaticamente e gestiti dal sistema contenenti dati sulle entrate pubblicitarie o generate dagli abbonamenti a YouTube Premium. I report saranno disponibili per i proprietari dei contenuti che possono già accedere ai report Entrate scaricabili manualmente da Creator Studio di YouTube. Di conseguenza, la nuova funzionalità dell'API fornirà accesso programmatico a questi dati.
Le seguenti modifiche all'API vengono annunciate ora in preparazione al lancio dei report gestiti dal sistema:
-
La nuova proprietà
systemManaged
della risorsajob
indica se la risorsa descrive un job che genera report gestiti dal sistema. YouTube genera automaticamente report gestiti dal sistema per i proprietari dei contenuti YouTube, che non possono modificare o eliminare le offerte di lavoro che creano questi report. -
Il nuovo parametro
includeSystemManaged
del metodojobs.list
indica se la risposta dell'API deve includere job per report gestiti dal sistema. Il valore predefinito del parametro èfalse
. -
Il nuovo parametro
startTimeAtOrAfter
del metodojobs.reports.list
indica che la risposta dell'API deve contenere report solo se i primi dati nel report corrispondono o sono successivi alla data specificata. Analogamente, il parametrostartTimeBefore
indica che la risposta dell'API deve contenere report solo se i primi dati nel report sono antecedenti alla data specificata.A differenza del parametro
createdAfter
del metodo, che riguarda il momento in cui è stato creato il report, i nuovi parametri riguardano i dati del report. -
La nuova proprietà
systemManaged
della risorsareportType
indica se la risorsa descrive un report gestito dal sistema. -
Il nuovo parametro
includeSystemManaged
del metodoreportTypes.list
indica se la risposta dell'API deve includere report gestiti dal sistema. Il valore predefinito del parametro èfalse
.
-
- Nell'API YouTube Reporting, la dimensione
sharing_service
supporta questi nuovi valori:82
: finestra di dialogo dell'attività di sistema iOS83
: Posta in arrivo di Google84
: Messenger Android
- Nell'API YouTube Analytics, la dimensione
sharingService
supporta questi nuovi valori:ANDROID_MESSENGER
: Messenger AndroidINBOX
: Posta in arrivo di GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: finestra di dialogo dell'attività di sistema iOS
- La dimensione
playback_location_type
supporta due nuovi valori di dimensione:7
: i dati si riferiscono alle visualizzazioni avvenute sulla home page o nella schermata Home di YouTube, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube.8
: i dati si riferiscono alle visualizzazioni avvenute direttamente nella pagina dei risultati di ricerca di YouTube.
- La dimensione
traffic_source_type
ora supporta18
come valore di dimensione. Questo valore indica che le visualizzazioni video provengono da una pagina che elenca tutti i video contenuti in una playlist. Questa sorgente è diversa dal tipo di origine14
, che indica che le visualizzazioni si sono verificate durante la riproduzione del video all'interno di una playlist. - La dimensione
insightPlaybackLocationType
supporta due nuovi valori di dimensione:BROWSE
: i dati si riferiscono alle visualizzazioni avvenute sulla home page o nella schermata Home di YouTube, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube.SEARCH
: i dati si riferiscono alle visualizzazioni avvenute direttamente nella pagina dei risultati di ricerca di YouTube.
- La dimensione
insightTrafficSourceType
ora supportaYT_PLAYLIST_PAGE
come valore di dimensione. Questo valore indica che le visualizzazioni video provengono da una pagina che elenca tutti i video contenuti in una playlist. Questa sorgente è diversa dal tipo di sorgentePLAYLIST
, a indicare che le visualizzazioni si sono verificate durante la riproduzione del video all'interno di una playlist. - Nell'API YouTube Reporting, la dimensione
operating_system
utilizza il valore21
per identificare le visualizzazioni effettuate tramite Chromecast. - Nell'API YouTube Analytics, la dimensione
operatingSystem
utilizza il valoreCHROMECAST
per identificare le visualizzazioni effettuate tramite Chromecast. -
L'API YouTube Analytics ora supporta tre nuove dimensioni dei dettagli di riproduzione, che possono essere utilizzate in diversi report sui canali e sui proprietari dei contenuti:
liveOrOnDemand
: questa dimensione indica se i dati del report descrivono l'attività utente che si è verificata durante una trasmissione dal vivo.subscribedStatus
: questa dimensione indica se le metriche sull'attività utente indicate nei dati sono associate a spettatori iscritti al canale del video o della playlist.youtubeProduct
: questa dimensione identifica la proprietà YouTube su cui si è verificata l'attività utente. I valori possibili includono il sito web principale di YouTube (o l'app YouTube), YouTube Gaming e YouTube Kids.
La documentazione è stata aggiornata per identificare nuovi report di dettagli sulle riproduzioni disponibili per i canali e i proprietari dei contenuti. Inoltre, molti altri report sono stati aggiornati per notare che una o più di queste dimensioni possono facoltativamente essere utilizzate come dimensioni e/o filtri in questi report.
-
Il formato delle tabelle che illustrano i report è cambiato per consentirti di identificare più facilmente combinazioni valide di dimensioni, metriche e filtri che possono essere utilizzate per recuperare ciascun report. Nella tabella che segue viene spiegato il "Tipo di dispositivo" report per i canali, mostra il nuovo formato:
Sommario Dimensioni: Obbligatorio deviceType Usa 0 o più day, liveOrOnDemand, subscribedStatus, youtubeProduct Metriche: Utilizza 1 o più visualizzazioni, estimatedMinutesWatched Filtri: Usa 0 o 1 paese, provincia, continente, subContinent Usa 0 o 1 video, gruppo Usa 0 o più operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct La terminologia che descrive i campi obbligatori e facoltativi è spiegata nella documentazione per i report sul canale e sul proprietario dei contenuti.
-
L'API YouTube Analytics ora elimina automaticamente le entità per le quali l'utente API non è in grado di recuperare dati dai filtri che supportano più valori (
video
,playlist
echannel
). In precedenza, il server API avrebbe restituito un errore se l'utente API non poteva accedere ai dati per almeno uno degli elementi specificati.Ad esempio, supponiamo che un utente invii una richiesta API in cui il filtro
video
elenca 20 ID video. L'utente possiede 18 video. Tuttavia, un ID video identifica un video di proprietà di un altro canale, mentre un altro ID identifica un video che è stato eliminato e, pertanto, non esiste più. In questo caso, invece di restituire un errore, il server API ora elimina i due video a cui l'utente non può accedere e la risposta dell'API contiene i dati relativi ai 18 video di proprietà dell'utente dell'API. -
Se richiedi i dati per un
group
di YouTube Analytics vuoto, l'API ora restituisce un set di dati vuoto anziché un errore. -
Il metodo
groupItems.insert
dell'API di YouTube Analytics ora restituisce un errore non autorizzato (codice di risposta HTTP403
) se provi ad aggiungere un'entità a un gruppo ma non hai accesso all'entità in questione. In precedenza, l'API avrebbe consentito di aggiungere l'entità al gruppo, ma successivamente restituiva un errore non autorizzato quando hai tentato di recuperare i dati dei report per quel gruppo. -
Il metodo
groups.list
dell'API di YouTube Analytics ora supporta l'impaginazione. Se la risposta dell'API non contiene tutti i gruppi disponibili, il parametronextPageToken
della risposta specifica un token che può essere utilizzato per recuperare la pagina dei risultati successiva. Imposta il parametropageToken
del metodo su quel valore per recuperare ulteriori risultati. -
L'API YouTube Analytics ora supporta la metrica
redPartnerRevenue
, che registra le entrate stimate totali generate dagli abbonamenti a YouTube Premium per le dimensioni del report selezionate. Il valore della metrica riflette gli utili derivanti sia dai contenuti musicali che da contenuti non musicali ed è soggetto a un aggiustamento di fine mese.L'elenco dei report sui proprietari dei contenuti dell'API di YouTube Analytics è stato aggiornato per identificare i report video che supportano la metrica
redPartnerRevenue
:- Statistiche di base
- In base al tempo
- Area geografica dell'utente
- Video principali: per questo report,
redPartnerRevenue
è supportato anche come metrica di ordinamento, il che significa che puoi recuperare un elenco dei video ordinati in base agli utili di YouTube Red.
-
La definizione del report Video principali per l'API di YouTube Analytics riflette ora che questo report supporta anche le seguenti metriche relative alle entrate:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
eimpressionBasedCpm
. -
La documentazione relativa alla dimensione
date
dell'API di reporting di YouTube è stata corretta in modo che le date facciano riferimento al periodo di 24 ore che inizia alle 00:00 (UTC-8) del Pacifico. In precedenza, la documentazione indicava che la data iniziava alle 00:00 (GMT).Inoltre, la documentazione dell'API di YouTube Analytics è stata aggiornata per tenere presente che tutte le dimensioni relative alle date (
day
,7DayTotals
,30DayTotals
emonth
) si riferiscono a date che iniziano alle 00:00 (fuso orario del Pacifico - UTC-8). -
Il metodo
jobs.reports.list()
dell'API di reporting di YouTube ora supporta il parametro di querycreatedAfter
. Se specificato, questo parametro indica che la risposta dell'API deve elencare solo i report creati dopo la data e l'ora specificate, inclusi i nuovi report con dati sottoposti a backfill. Tieni presente che il valore del parametro riguarda l'ora in cui viene creato il report e non le date associate ai dati restituiti.Il valore del parametro è un timestamp nel formato RFC3339 UTC "Zulu" con precisione in microsecondi. Esempio:
"2015-10-02T15:01:23.045678Z"
.Anche le best practice dell'API di reporting di YouTube sono state aggiornate per spiegare come utilizzare il parametro
createdAfter
per evitare di elaborare ripetutamente lo stesso report. -
Le definizioni della proprietà
createTime
della risorsajob
e le proprietàstartTime
,endTime
ecreateTime
della risorsareport
sono state tutte corrette per notare che i valori delle proprietà sono precisi in microsecondi, non in nanosecondi. Inoltre, tutte le definizioni ora riflettono con precisione che il valore della proprietà è un timestamp. -
La documentazione relativa alla dimensione
sharingService
dell'API di YouTube Analytics è stata aggiornata in modo da includere un elenco di possibili valori di dimensione. L'elenco include una serie di nuovi servizi supportati.Anche la definizione della dimensione
sharing_service
dell'API di reporting di YouTube è stata aggiornata in modo da elencare i nuovi valori supportati. I valori enum superiori a59
sono i nuovi nell'elenco. -
La nuova API di reporting di YouTube recupera i report di dati collettivi che contengono 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 tali dati.
Ogni report dell'API di reporting di YouTube contiene un insieme predefinito di dimensioni e metriche. Anche i report dell'API di YouTube Analytics utilizzano metriche e dimensioni. In un report, ogni riga di dati ha una combinazione univoca di valori delle dimensioni. Puoi aggregare i dati delle varie righe in base ai valori delle dimensioni per calcolare le metriche per singoli video, paesi, video dal vivo, utenti abbonati e così via.
Puoi utilizzare l'API per pianificare i job di generazione dei report, ognuno dei quali identifica un report che YouTube dovrebbe generare. Una volta impostato un job, YouTube genera un report giornaliero che può essere scaricato in modo asincrono. Ogni report contiene dati relativi a un periodo univoco di 24 ore.
-
Sebbene si tratti di API diverse, l'API di YouTube Analytics e l'API di reporting di YouTube consentono entrambe agli sviluppatori di recuperare i dati di YouTube Analytics. Poiché entrambe le API forniscono l'accesso a set di dati simili, la documentazione delle due API viene pubblicata come un unico set di documentazione.
- La scheda Guide nel set di documentazione contiene informazioni comuni a entrambe le API, comprese le istruzioni per l'autorizzazione delle richieste API.
- La scheda Report collettivi contiene la documentazione di riferimento e altri contenuti specifici per l'API di reporting di YouTube.
- La scheda Query mirate contiene la documentazione di riferimento e altri contenuti specifici per l'API YouTube Analytics.
- La scheda Esempi elenca gli esempi di codice disponibili per una delle due API.
- La scheda Strumenti elenca le risorse aggiuntive disponibili per aiutare gli sviluppatori a implementare una delle due API.
-
La documentazione dell'API è stata riorganizzata allo scopo di rendere l'API più facile da capire. Di conseguenza, queste modifiche non descrivono nuove funzionalità:
-
La documentazione ora contiene una pagina che elenca tutti i report sul canale disponibili e un'altra che elenca tutti i report sui proprietari dei contenuti disponibili. In precedenza, la documentazione aveva pagine distinte per i report sui video dei canali, i report sulle playlist del canale e così via.
-
La nuova panoramica del modello dei dati cerca di fornire un'introduzione più chiara al funzionamento dell'API. Nello specifico, questo documento cerca di spiegare meglio in che modo YouTube utilizza metriche, dimensioni e filtri per calcolare i valori dei report.
-
Il metodo
reports.query
dell'API, che utilizzi per recuperare i report, è ora documentato separatamente. In precedenza, le informazioni su quella pagina erano presenti in altre pagine. La nuova pagina è progettata per aiutarti a identificare più facilmente le informazioni da inviare per recuperare un report.
-
-
La nuova metrica
adEarnings
include gli utili stimati totali (entrate nette) da tutte le origini di pubblicità venduta da Google. Non si tratta di una metrica principale. L'API supporta la metricaadEarnings
per tutti i report che supportavano già la metricaearnings
.Inoltre, la definizione della metrica
earnings
è stata corretta per riflettere il fatto che il suo valore include gli utili stimati totali provenienti da tutte le fonti di pubblicità venduta da Google e da fonti non pubblicitarie. In precedenza, la definizione indicava erroneamente che la metrica includeva solo le entrate provenienti da sorgenti pubblicitarie. -
La metrica
primaryAdGrossRevenue
è stata deprecata. Utilizza invece la metricagrossRevenue
per recuperare i dati sulle entrate. -
Oltre alla metrica
primaryAdGrossRevenue
ritirata, i report sul rendimento degli annunci non supportano più le metrichemonetizedPlaybacks
eplaybackBasedCpm
. Tuttavia, diversi report video supportano ancora queste metriche. -
L'API ora supporta due nuove metriche per i report sui video:
videosAddedToPlaylists
evideosRemovedFromPlaylists
. Gli elenchi dei report sui video relativi ai canali e ai proprietari dei contenuti sono stati entrambi aggiornati in modo da identificare i report che supportano le nuove metriche.videosAddedToPlaylists
- Il numero di volte in cui i video nell'ambito della query sono stati aggiunti a qualsiasi playlist di YouTube. I video potrebbero essere stati aggiunti alla playlist del proprietario del video o a quelli di altri canali playlist.videosRemovedFromPlaylists
- Il numero di volte in cui i video che rientrano nell'ambito della query sono stati rimossi da qualsiasi playlist di YouTube. I video potrebbero essere stati rimossi dalla playlist del proprietario del video o da altri canali playlist.
Entrambe le metriche includono playlist predefinite come "Guarda più tardi" playlist. Tuttavia, non conteggiano le playlist a cui viene aggiunto automaticamente un video, come la playlist dei caricamenti di un canale o la cronologia delle visualizzazioni di un utente. Tieni inoltre presente che queste metriche riflettono il numero assoluto di aggiunte ed eliminazioni. Quindi, se un utente aggiunge un video a una playlist, poi lo rimuove e poi lo aggiunge di nuovo, le metriche indicano che il video è stato aggiunto a due playlist e rimosso da una playlist.
I dati per queste metriche sono disponibili dal 1° ottobre 2014.
-
Le metriche
favoritesAdded
efavoritesRemoved
sono entrambe ritirate a partire da questo annuncio. Sia queste metriche principali che sono soggette alle norme sul ritiro stabilite nei Termini di servizio. -
Il nuovo parametro
currency
ti consente di recuperare le metriche relative agli utili in una valuta diversa dal dollaro statunitense (USD
). Se il parametro è impostato, l'API converte i valori delle metricheearnings
,grossRevenue
,playbackBasedCpm
eimpressionBasedCpm
nella valuta specificata. I valori restituiti sono stime calcolate utilizzando tassi di cambio che variano ogni giorno.Il valore del parametro è un codice valuta ISO 4217 di tre lettere. Il valore predefinito è
USD
. La definizione del parametro contiene un elenco di codici valuta supportati. -
L'API ora supporta la possibilità di creare e gestire gruppi di YouTube Analytics, nonché di recuperare i dati dei report per questi gruppi.
-
Creazione e gestione di gruppi
Questo aggiornamento introduce le risorse
group
egroupItem
per la creazione e la gestione dei gruppi.- La risorsa
group
rappresenta un gruppo di Analytics, una raccolta personalizzata di massimo 200 canali, video, playlist o risorse. L'API supporta i metodilist
,insert
,update
edelete
per questa risorsa. - La risorsa
groupItem
rappresenta un elemento in un gruppo Analytics. L'API supporta i metodilist
,insert
edelete
per questa risorsa.
Quindi, ad esempio, potresti creare un gruppo utilizzando il metodo
groups.insert
e aggiungere elementi a quel gruppo utilizzando il metodogroupItems.insert
. - La risorsa
-
Recupero dei dati dei report per un gruppo
La documentazione relativa alle dimensioni è stata aggiornata per includere la dimensione
group
, che può essere utilizzata come filtro per molti report sui canali e report sui proprietari dei contenuti. Quando utilizzi il filtrogroup
, l'API restituisce i dati per tutti gli elementi presenti nel gruppo. Tieni presente che attualmente l'API non supporta la possibilità di creare report per gruppi di asset.
Consulta il Centro assistenza YouTube per ulteriori informazioni sui gruppi di YouTube Analytics.
-
-
L'API non supporta più la dimensione
show
. -
L'API ora supporta la possibilità di specificare più valori per le dimensioni
video
,playlist
,channel
eshow
quando queste dimensioni vengono utilizzate come filtri. Per specificare più valori, imposta il valore parametrofilters
su un elenco separato da virgole di ID video, playlist, canale o programma per i quali la risposta dell'API deve essere filtrata. Il valore del parametro può specificare fino a 200 ID.Se specifichi più valori per lo stesso filtro, puoi anche aggiungere il filtro all'elenco delle dimensioni specificate per la richiesta. anche se il filtro non è elencato come dimensione supportata per un determinato report. Se aggiungi il filtro all'elenco delle dimensioni, l'API utilizza anche i valori del filtro per raggruppare i risultati.
Per informazioni dettagliate su questa funzionalità, consulta la definizione del parametro
filters
. -
Quando recuperi un report sul canale, ora puoi recuperare i dati relativi al canale dell'utente autenticato impostando il valore del parametro
ids
suchannel==MINE
. Puoi anche impostare il parametroids
suchannel==CHANNEL_ID
per recuperare i dati per il canale specificato. -
L'API ora supporta i report sulle playlist, che contengono statistiche relative alle visualizzazioni dei video che si verificano nel contesto di una playlist. I report sulle playlist sono disponibili per i canali e i proprietari dei contenuti.
Tutti i report sulle playlist supportano le metriche
views
eestimatedMinutesWatched
e alcuni supportano anche la metricaaverageViewDuration
.Inoltre, tutti i report sulle playlist supportano le nuove metriche riportate di seguito. Tieni presente che ciascuna di queste metriche riflette solo le visualizzazioni di playlist avvenute sul web.
playlistStarts
. Il numero di volte in cui gli spettatori hanno avviato la riproduzione di una playlist.viewsPerPlaylistStart
: il numero medio di visualizzazioni di video verificatesi ogni volta che viene avviata una playlist.averageTimeInPlaylist
: la quantità di tempo media stimata, in minuti, durante il quale uno spettatore ha visualizzato i video di una playlist dopo l'avvio della playlist.
Qualsiasi richiesta di recupero di un report sulla playlist deve utilizzare il filtro
isCurated
, che deve essere impostato su1
(isCurated==1
). -
L'API ora supporta un report sulla fidelizzazione del pubblico. Questo report misura la capacità di un video di conservare il pubblico. La nuova dimensione
elapsedVideoTimeRatio
del report misura la quantità di video trascorsa per i valori delle metriche corrispondenti:-
La metrica
audienceWatchRatio
identifica il rapporto assoluto di spettatori che guardano il video in un determinato punto del video. Il rapporto viene calcolato confrontando il numero di volte in cui una parte di un video è stata guardata con il numero totale di visualizzazioni del video.Tieni presente che una parte di un video potrebbe essere guardata più di una volta (o non può essere guardata affatto) in una determinata visualizzazione video. Ad esempio, se gli utenti riavvolgono e guardano la stessa parte di un video più volte, il rapporto assoluto per quella parte del video potrebbe essere maggiore di
1
. -
La metrica
relativeRetentionPerformance
mostra l'efficacia con cui un video fidelizza gli spettatori durante le riproduzioni rispetto a tutti i video di YouTube di durata simile. Un valore pari a 0 indica che la fidelizzazione degli spettatori è peggiore di qualsiasi altro video di durata simile, mentre un valore pari a 1 indica che il video fidelizza gli spettatori meglio di qualsiasi altro video di durata simile. Un valore mediano di 0,5 indica che metà dei video di durata simile fidelizza gli spettatori meglio, mentre la metà ne fidelizza maggiormente gli spettatori.
Puoi anche utilizzare il filtro
audienceType
in modo che il report restituisca solo i dati associati alle visualizzazioni organiche, delle visualizzazioni degli annunci TrueView in-stream o delle visualizzazioni degli annunci TrueView in-display. Le visualizzazioni organiche sono il risultato diretto di un'azione dell'utente, come una ricerca di un video o un clic su un video consigliato. -
-
L'API supporta diverse nuove metriche relative alle annotazioni. Le metriche elencate di seguito possono essere recuperate con qualsiasi report che in precedenza supportava le metriche
annotationClickThroughRate
eannotationCloseRate
.annotationImpressions
: il numero totale di impressioni delle annotazioni.annotationClickableImpressions
: il numero di annotazioni visualizzate e su cui è possibile fare clic.annotationClosableImpressions
: il numero di annotazioni visualizzate e che potrebbero essere chiuse.annotationClicks
: il numero totale di annotazioni su cui è stato fatto clic.annotationCloses
: il numero totale di annotazioni chiuse.
Tutte le nuove metriche sono metriche principali e sono soggette alle norme sul ritiro. Tuttavia, tieni presente che i dati per le nuove metriche sono disponibili a partire dal 16 luglio 2013. I dati delle metriche
annotationClickThroughRate
eannotationCloseRate
sono disponibili dal 10 giugno 2012. -
GOOGLE_SEARCH
non è più riportato come valore separato per la dimensioneinsightTrafficSourceType
. I referral provenienti dai risultati di ricerca di Google vengono ora attribuiti al tipo di sorgente di trafficoEXT_URL
. Di conseguenza, non è più possibile recuperare un reportinsightTrafficSourceDetail
che imposta il filtroinsightTrafficSourceType
suGOOGLE_SEARCH
. -
Il documento relativo ai report dei proprietari dei contenuti è stato aggiornato per indicare che ora è possibile recuperare le metriche
subscribersGained
esubscribersLost
per i contenuti rivendicati o caricati da un proprietario dei contenuti.La modifica è visibile nel primo report sulle statistiche di base per i proprietari dei contenuti, che ora supporta i filtri
claimedStatus
euploaderType
. -
Il documento sulle richieste di esempio è stato riprogettato in modo da raggruppare gli esempi in categorie, utilizzando un formato di schede simile a quello rilasciato di recente per i report sui canali e sui proprietari dei contenuti. Con il nuovo design, gli esempi vengono raggruppati nelle seguenti categorie:
- Statistiche di base
- Basato sul tempo
- Geografico
- Luogo di visualizzazione
- Sorgente di traffico
- Dispositivo/sistema operativo
- Gruppo demografico
- Social
- Utili/annunci (solo per i report dei proprietari dei contenuti)
-
Il documento sulle richieste di esempio ora include nuovi esempi per recuperare i dati specifici per provincia nei report del canale o nei report dei proprietari dei contenuti.
-
Metriche specifiche per provincia per stati degli Stati Uniti e Washington D.C.: Questo report recupera un'analisi provincia per provincia del numero di visualizzazioni e di altre statistiche relative ai video di un canale. I dati riguardano gli stati degli Stati Uniti e lo stato di Washington D.C. Nell'esempio viene utilizzata la dimensione
province
e il parametrofilters
per limitare la risposta in modo da includere solo i risultati per gli Stati Uniti. -
Dati demografici degli spettatori in California (età e genere): questo report recupera le statistiche sull'età e sul genere degli spettatori in California che hanno guardato i video di un canale o, per i report dei proprietari dei contenuti, i contenuti rivendicati di un proprietario dei contenuti. In questo esempio viene utilizzato il parametro
filters
per garantire che la risposta includa solo i dati relativi a una determinata provincia.
-
-
La definizione della dimensione
province
è stata aggiornata per notare che quandoprovince
è incluso nel valore parametrodimensions
, la richiesta deve anche limitare i dati agli Stati Uniti includendocountry==US
nel valore parametrofilters
. -
I documenti che elencano i report supportati sul canale e sul proprietario dei contenuti sono stati riprogettati. Anziché fornire una tabella che elenca tutti i possibili report, ogni documento raggruppa i report in categorie:
- Statistiche di base
- Basato sul tempo
- Geografico
- Luogo di visualizzazione
- Sorgente di traffico
- Dispositivo/sistema operativo
- Gruppo demografico
- Social
- Video principali
Ogni documento visualizza queste categorie sotto forma di elenco di schede; puoi fare clic su una scheda qualsiasi per visualizzare i report supportati in quella categoria.
-
L'API ora supporta tre nuove dimensioni geografiche:
province
,continent
esubContinent
.-
La dimensione
province
ti consente di recuperare le statistiche per gli stati degli Stati Uniti e per il Distretto della Colombia. L'API supporta due utilizzi per questa dimensione:-
L'API supporta due report che analizzano le statistiche stato per stato. Entrambi i report sono disponibili per i canali e i proprietari dei contenuti.
- Il report sulle statistiche di base fornisce diverse statistiche, tra cui il numero di visualizzazioni e la stima dei minuti guardati.
- Il report basato sul tempo fornisce le stesse statistiche, ma aggrega i dati su base giornaliera, settimanale, 30 giorni o mensile.
-
Puoi utilizzare il parametro di query
filters
per limitare un report in modo che contenga solo le statistiche relative a un determinato stato. Vari report supportano questo tipo di filtro, ad esempio report geografici, report sui luoghi di visualizzazione, report sulle sorgenti di traffico, report sui dispositivi, report sul sistema operativo, report sulle categorie demografiche e report sui video principali.
-
-
La dimensione
continent
specifica un codice regione statistica delle Nazioni Unite (UN) che identifica un continente. Questa dimensione può essere utilizzata solo come filtro. -
La dimensione
subContinent
specifica un codice regione statistica delle Nazioni Unite (UN) che identifica una sottoregione di un continente. Questa dimensione può essere utilizzata solo come filtro.Poiché ogni sottoregione è associata a un solo continente, non è necessario utilizzare anche il filtro
continent
quando usi il filtrosubContinent
. In effetti, l'API restituirà un errore se una richiesta utilizza entrambe le dimensioni.
-
-
La documentazione è stata corretta in modo che la dimensione
insightTrafficSourceDetail
non includa il valorePROMOTED
diinsightTrafficSourceType
come valore di filtro valido. -
L'API YouTube Analytics è ora soggetta alle norme sul ritiro descritte nei Termini di servizio. Tuttavia, le dimensioni non principali e le metriche non principali dell'API non sono soggette alle norme sul ritiro. Le pagine relative a dimensioni e metriche sono state aggiornate in modo da elencare le dimensioni principali e le metriche principali. Inoltre, le definizioni su queste pagine sono state aggiornate per identificare in modo esplicito le dimensioni e le metriche principali.
-
L'API ora supporta
EXTERNAL_APP
come valore per la dimensioneinsightPlaybackLocationType
. In concomitanza con questo aggiornamento, a partire dal 10 settembre 2013, le riproduzioni non sono più classificate come riproduzioniMOBILE
, anche se le riproduzioni da dispositivi mobili precedenti a questa data continueranno a essere classificate con quel valore.Con questo aggiornamento, le riproduzioni mobile sono ora classificate come
WATCH
,EMBEDDED
oEXTERNAL_APP
, a seconda del tipo di applicazione in cui si verificano. -
L'API ora supporta
PLAYLIST
come valore per la dimensioneinsightTrafficSourceType
. Il valore indica che le visualizzazioni di video provengono da una playlist. In precedenza, queste visualizzazioni venivano classificate utilizzando la categoriaYT_OTHER_PAGE
della dimensione. -
L'API ora supporta la possibilità di ordinare i report in base a più dimensioni e metriche. Il documento sulle richieste di esempio contiene un nuovo esempio, Ordinamento delle richieste in base a più dimensioni/metriche, che dimostra questa funzionalità. La richiesta recupera i dati della sorgente di traffico e ha un valore parametro
sort
pari aday,-views
. I risultati sono ordinati cronologicamente, ma all'interno del set di risultati per ogni giorno, la prima riga contiene i dati relativi alla sorgente di traffico che ha generato il maggior numero di visualizzazioni, la seconda riga contiene i dati della sorgente con quella che ha generato il successivo numero di visualizzazioni più elevato e così via. -
L'API ora supporta due nuove dimensioni,
deviceType
eoperatingSystem
, che possono essere utilizzate per recuperare dati sui dispositivi su cui gli spettatori guardano i tuoi video. L'API supporta i report che utilizzano una o entrambe le dimensioni.-
Il report
deviceType
ti consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per diversi tipi di dispositivi, inclusi computer, dispositivi mobili e tablet. Puoi anche utilizzare il filtrooperatingSystem
per limitare il report sul tipo di dispositivo in modo che contenga solo le statistiche relative ai dispositivi con un sistema operativo specifico, ad esempio Android o iOS. -
Il report
operatingSystem
ti consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per diversi sistemi operativi, come Android, iOS, Linux e altri ancora. Puoi anche utilizzare il filtrodeviceType
per limitare il report sul sistema operativo in modo che contenga solo statistiche per un tipo specifico di dispositivo, ad esempio dispositivi mobili o tablet.
I nuovi report sul tipo di dispositivo e sul sistema operativo sono disponibili per i canali e per i proprietari dei contenuti.
-
-
Il documento sulle richieste di esempio è stato aggiornato e ora include tre report sui dispositivi per i canali e tre report sui dispositivi per i proprietari dei contenuti.
-
La dimensione
insightPlaybackLocationType
potrebbe restituire il valoreYT_OTHER
, che identifica le visualizzazioni non classificate utilizzando uno degli altri valori della dimensione. -
Il documento relativo ai report sui proprietari dei contenuti è stato aggiornato per indicare che puoi ordinare il report sui video principali in ordine decrescente in base alle entrate per identificare i video dagli utili maggiori. Questo report è il primo elencato nella seconda tabella della sezione Report sull'attività utente e sugli utili.
-
YouTube non identifica più funzionalità e servizi API sperimentali. Al suo posto, forniamo un elenco di API di YouTube soggette alle norme sul ritiro.
-
L'API ora supporta la possibilità di recuperare le metriche relative al tempo di visualizzazione (
estimatedMinutesWatched
,averageViewDuration
eaverageViewPercentage
) in combinazione con altre metriche, tra cui metriche sulle visualizzazioni, sul coinvolgimento, sugli utili e sul rendimento degli annunci.Gli elenchi dei report sui canali e dei report sui proprietari dei contenuti disponibili sono stati aggiornati in modo da riflettere questa modifica. Ora gli elenchi sono più brevi poiché le metriche del tempo di visualizzazione possono essere recuperate nell'ambito di altri report elencati.
È stato aggiornato anche il documento Richieste API di esempio.
-
I report che utilizzano le dimensioni
insightPlaybackLocationDetail
einsightTrafficSourceDetail
sono stati migliorati nei seguenti modi:-
Ora supportano un filtro facoltativo
country
. -
I proprietari dei contenuti possono ora recuperare questi report utilizzando una delle seguenti nuove combinazioni di
filter
. Tieni presente che tutte queste combinazioni supportano anche il filtro facoltativocountry
.-
Dettagli sul luogo di visualizzazione
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Dettagli sulle sorgenti di traffico
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Il nuovo documento Richieste API di esempio fornisce esempi che dimostrano come recuperare molti tipi diversi di report utilizzando YouTube Analytics API. Ogni esempio include una breve descrizione del report recuperato dalla richiesta, quindi mostra le dimensioni, le metriche, i filtri e i parametri di ordinamento relativi alla richiesta.
-
La dimensione
insightTrafficSourceType
ora supportaSUBSCRIBER
come valore valido. Questo valore identifica le visualizzazioni di video provenienti dai feed sulla home page di YouTube o dalle funzioni di iscrizione di YouTube. Se filtri in base a questa sorgente di traffico, il campoinsightTrafficSourceDetail
indicherà il feed della home page o un'altra pagina da cui provengono le visualizzazioni. -
L'API ora supporta due nuove metriche,
annotationClickThroughRate
eannotationCloseRate
, relative alle interazioni degli spettatori con le annotazioni visualizzate durante i video. Gli elenchi dei report sui canali e dei report sui proprietari dei contenuti sono stati entrambi aggiornati in modo da identificare i report che supportano le nuove metriche.annotationClickThroughRate
- Il rapporto tra le annotazioni su cui gli spettatori hanno fatto clic e il numero totale di impressioni delle annotazioni selezionabili.annotationCloseRate
- Il rapporto tra le annotazioni chiuse dagli spettatori e il numero totale di impressioni delle annotazioni.
-
L'API ora supporta metriche su entrate e rendimento degli annunci, nonché nuovi report sul rendimento degli annunci. Le metriche e i report sono accessibili solo ai partner di contenuti di YouTube che partecipano al Programma partner di YouTube.
-
I nuovi report supportati supportano metriche di rendimento degli annunci basate sulle riproduzioni e metriche di rendimento degli annunci basate sulle impressioni. Per ulteriori informazioni sui report sul rendimento degli annunci, consulta la documentazione relativa ai report sui proprietari dei contenuti.
-
Le nuove metriche supportate sono elencate di seguito. L'elenco dei report dei proprietari dei contenuti è stato aggiornato in modo da identificare i report, inclusi i due nuovi report, che supportano queste metriche.
earnings
- Totale utili stimati da tutte le fonti di pubblicità venduta da Google.grossRevenue
– Entrate lorde stimate provenienti dai partner Google o DoubleClick.primaryAdGrossRevenue
– Entrate lorde stimate, sommate e classificate sotto il tipo di annuncio principale per le riproduzioni video coperte dal rapporto, provenienti dai partner di Google o DoubleClick.monetizedPlaybacks
- Il numero di riproduzioni che hanno mostrato almeno un'impressione dell'annuncio.playbackBasedCpm
– Entrate lorde stimate per mille riproduzioni.impressions
- Il numero di impressioni dell'annuncio verificate pubblicate.impressionBasedCpm
– Entrate lorde stimate per mille impressioni dell'annuncio.
Nota:per informazioni dettagliate, consulta le definizioni delle metriche.
-
Qualsiasi richiesta che recuperi le metriche relative agli utili o al rendimento degli annunci deve inviare un token di autorizzazione che consenta l'accesso utilizzando il nuovo ambito
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
.
-
-
La documentazione dell'API è stata riorganizzata in modo che i diversi tipi di report siano spiegati in pagine separate. Pertanto, ora esistono pagine separate che spiegano i diversi tipi di report sui canali e report sui proprietari dei contenuti.
-
La guida di riferimento dell'API ora include una sezione di esempi che include esempi di codice che dimostrano come chiamare l'API utilizzando le librerie client Java, JavaScript, Python e Ruby. L'esempio di codice JavaScript è lo stesso discusso in dettaglio nella documentazione dell'applicazione di esempio.
-
La guida di riferimento API ora contiene il APIs Explorer, che ti consente di chiamare l'API, visualizzare la richiesta API e recuperare dati reali nella risposta.
-
L'API supporta una serie di nuovi report sia per i canali che per i proprietari dei contenuti, descritti di seguito. Ogni report è disponibile come report sul canale o report sul proprietario dei contenuti. Anche le pagine relative a dimensioni e metriche sono state aggiornate di conseguenza.
-
Il report sul luogo di visualizzazione specifica il numero di visualizzazioni del video avvenute su diversi tipi di pagine o applicazioni.
-
Il report dettagliato sui luoghi di visualizzazione identifica i player incorporati che hanno generato il maggior numero di visualizzazioni per un determinato video. Fornisce una visualizzazione più granulare rispetto al report sul luogo di visualizzazione identificando gli URL associati ai principali player incorporati.
-
Il report sulle sorgenti di traffico identifica il numero di visualizzazioni video che hanno avuto origine da diversi tipi di referrer.
-
Il report dettagliato sulle sorgenti di traffico identifica i referrer che hanno generato il maggior numero di visualizzazioni per un determinato video e un determinato tipo di sorgente di traffico. Ad esempio, questo report indica i video correlati che hanno indirizzato più traffico a un video specifico. Questo report è supportato per diverse sorgenti di traffico.
-
I report sul tempo di visualizzazione forniscono la quantità di tempo che gli spettatori hanno trascorso a guardare i tuoi contenuti. I report possono aggregare i dati per un periodo di tempo specifico (giorno, sette giorni precedenti, 30 giorni precedenti e così via) o un paese. Se un report aggrega i dati per giorno o paese, può anche specificare la durata media di ogni visualizzazione video, nonché la percentuale media di ciascun video guardato dagli utenti.
-
-
YouTube Analytics API è ora disponibile per tutti gli sviluppatori. Puoi attivare l'API per il tuo progetto senza dover prima richiedere l'accesso dal riquadro Servizi in APIs console.
-
La nuova sezione Come iniziare illustra i prerequisiti e i passaggi di base per creare un'applicazione che utilizza YouTube Analytics API.
-
La nuova sezione Informazioni sull'utilizzo delle quote fornisce linee guida per ottimizzare l'utilizzo delle quote API. Il server API calcola un costo delle query per ogni richiesta, che viene detratto dalla tua quota di utilizzo dell'API. Poiché tipi di report diversi possono avere costi delle query molto diversi, dovresti pianificare di utilizzare la tua quota in modo efficiente e l'applicazione dovrebbe richiedere solo le metriche e i dati di cui ha effettivamente bisogno.
-
La sezione Dimensioni temporali è stata aggiornata per spiegare che queste dimensioni indicano che un report di Analytics deve aggregare i dati in base a un periodo di tempo. L'API ora supporta le seguenti dimensioni temporali aggiuntive:
7DayTotals
: i dati del report verranno aggregati in modo che ogni riga contenga dati relativi a un periodo di sette giorni.30DayTotals
: i dati del report verranno aggregati in modo che ogni riga contenga dati relativi a un periodo di 30 giorni.month
: i dati nel report verranno aggregati per mese di calendario.
Analogamente, la sezione dei report disponibili è stata aggiornata per riflettere il supporto dell'API per i report che utilizzano queste dimensioni.
-
La sezione relativa alle dimensioni delle entità report è stata aggiornata per notare che le richieste API per recuperare i report dei proprietari dei contenuti devono filtrare i dati utilizzando una di queste dimensioni (
video
,channel
oshow
) o una combinazione supportata delle dimensioniclaimedStatus
euploaderType
. -
L'API ora supporta due nuove opzioni di ordinamento per i report dei video principali. Questi report, disponibili come report sui canali o sui proprietari dei contenuti, contengono metriche (visualizzazioni, commenti, Mi piace e così via) in base al paese e le scompongono per video. Ora puoi ordinare questi report in base al numero di utenti che si sono iscritti o hanno annullato l'iscrizione a un canale dalla pagina di visualizzazione del video.
-
Le definizioni delle metriche
subscribersGained
esubscribersLost
sono state aggiornate per spiegare che un canale può acquisire o perdere iscritti in diversi punti, tra cui la pagina di visualizzazione del video, la pagina del canale e la guida visualizzata sulla home page di YouTube. Quando queste metriche appaiono in un report specifico per un video, includono solo le statistiche provenienti dalla pagina di visualizzazione del video specificato.
L'API di reporting di YouTube supporta tre nuovi report sulle schermate finali, nonché nuove dimensioni e metriche per questi report. I report forniscono statistiche sulle impressioni e sui clic per le schermate finali visualizzate dopo l'interruzione della riproduzione del video.
Il Centro assistenza YouTube contiene informazioni più dettagliate sull'aggiunta di schermate finali ai video.
8 novembre 2016
Questo aggiornamento contiene le seguenti modifiche all'API di YouTube Analytics:
27 ottobre 2016
YouTube ora genera automaticamente un insieme di report sulle entrate pubblicitarie gestiti dal sistema per i proprietari dei contenuti che hanno accesso ai report corrispondenti nella sezione Report di YouTube Studio. I nuovi report dell'API gestiti dal sistema sono progettati per fornire accesso programmatico ai dati che sono disponibili anche nei report di Creator Studio scaricabili manualmente.
La panoramica dei report gestiti dal sistema fornisce una breve panoramica dei nuovi report e spiega la procedura per recuperarli tramite l'API. Questa procedura è leggermente diversa da quella utilizzata per il recupero dei report collettivi per YouTube Analytics, poiché i partner non hanno bisogno di pianificare i job per generare i report.
La proprietà id
della risorsa reportType
è stata aggiornata in modo da includere un elenco dei report gestiti dal sistema a cui puoi accedere tramite l'API:
27 settembre 2016
Nota: questo è un annuncio relativo al ritiro.
La metrica uniques
dell'API YouTube Analytics è stata ritirata. Non si tratta di una metrica principale e sarà supportata fino al 31 ottobre 2016.
15 settembre 2016
Questo aggiornamento contiene le seguenti modifiche all'API di reporting di YouTube:
19 agosto 2016
Questo aggiornamento contiene la seguente modifica all'API di reporting di YouTube:
11 agosto 2016
Questo aggiornamento contiene le seguenti modifiche:
10 agosto 2016
Questo aggiornamento include le seguenti modifiche:
18 luglio 2016
Questo aggiornamento include le seguenti modifiche:
28 giugno 2016
La documentazione dell'API di YouTube Analytics è stata aggiornata per riflettere il supporto delle metriche delle schede in numerosi report sui canali e sui proprietari dei contenuti. Le nuove metriche supportate sono:
Le metriche sono supportate nei seguenti tipi di report:
22 giugno 2016
Questo aggiornamento contiene le seguenti modifiche all'API di reporting di YouTube. La prima modifica riguarda l'API in generale, mentre le altre modifiche interessano solo i report dei proprietari dei contenuti:
19 maggio 2016
Questo aggiornamento contiene le seguenti modifiche all'API di reporting di YouTube:
12 aprile 2016
Questo aggiornamento contiene le seguenti modifiche, che interessano solo l'API di reporting di YouTube:
28 marzo 2016
L'API di reporting di YouTube e l'API di YouTube Analytics ora restituiscono le statistiche di visualizzazione per diversi servizi di condivisione aggiuntivi.
16 marzo 2016
Questo aggiornamento contiene le seguenti modifiche, che interessano sia l'API di reporting di YouTube che l'API di YouTube Analytics:
API di reporting di YouTube
API YouTube Analytics
8 febbraio 2016
L'elenco delle metriche supportate per l'API YouTube Analytics è stato aggiornato in modo che le metriche delle schede non siano più elencate come metriche supportate per quell'API. (Nessuno dei report di quell'API era documentato come supporto per nessuna delle metriche della scheda.)
Tieni presente che puoi comunque recuperare le metriche delle schede utilizzando l'API di reporting di YouTube, che supporta queste metriche per numerosi report relativi a canali e proprietari dei contenuti.
6 gennaio 2016
L'API di reporting di YouTube e l'API di YouTube Analytics ora identificano in modo specifico le viste che si verificano tramite un dispositivo Chromecast.
21 dicembre 2015
Nella documentazione, i nomi delle metriche annotation_clickable_impressions
e annotation_closable_impressions
sono stati aggiornati in modo che corrispondano ai nomi restituiti nei report. In precedenza, i nomi erano documentati come clickable_annotation_impressions
e closable_annotation_impressions
.
18 dicembre 2015
Le leggi dell'Unione Europea (UE) impongono di fornire determinate informative agli utenti finali dell'UE e di ottenere il consenso da loro. Pertanto, gli utenti finali nell'Unione Europea devono rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una notifica relativa a questo requisito nei Termini di servizio delle API di YouTube.
15 dicembre 2015
Questo aggiornamento contiene le seguenti modifiche, che interessano l'API YouTube Analytics:
10 novembre 2015
Questo aggiornamento contiene le seguenti modifiche:
29 ottobre 2015
Questo aggiornamento contiene le seguenti modifiche:
8 ottobre 2015
Questo aggiornamento contiene le seguenti modifiche:
24 settembre 2015
Questo aggiornamento contiene le seguenti modifiche:
20 agosto 2015
Questo aggiornamento contiene le seguenti modifiche:
22 luglio 2015
Questo aggiornamento contiene diverse modifiche, tutte valide solo per i proprietari dei contenuti:
1 giugno 2015
Questo aggiornamento contiene le seguenti modifiche:
31 marzo 2015
Questo aggiornamento contiene le seguenti modifiche:
16 marzo 2015
Questo aggiornamento contiene le seguenti modifiche:
25 febbraio 2015
Questo aggiornamento contiene le seguenti modifiche:
13 febbraio 2015
Questo aggiornamento contiene le seguenti modifiche:
28 agosto 2014
Questo aggiornamento contiene le seguenti modifiche:
16 luglio 2014
Questo aggiornamento contiene le seguenti modifiche:
31 gennaio 2014
Questo aggiornamento contiene le seguenti modifiche:
16 gennaio 2014
Questo aggiornamento contiene le seguenti modifiche:
6 gennaio 2014
Questo aggiornamento contiene le seguenti modifiche:
30 settembre 2013
Questo aggiornamento contiene le seguenti modifiche:
16 luglio 2013
Questo aggiornamento contiene le seguenti modifiche:
23 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
10 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
6 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
3 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
28 marzo 2013
Questo aggiornamento contiene le seguenti modifiche:
21 marzo 2013
Questo aggiornamento contiene le seguenti modifiche:
4 febbraio 2013
Questo aggiornamento contiene le seguenti modifiche:
14 novembre 2012
Questo aggiornamento contiene le seguenti modifiche:
2 ottobre 2012
Questo aggiornamento contiene le seguenti modifiche:
12 settembre 2012
Questo aggiornamento contiene le seguenti modifiche: