Log delle modifiche all'API Google Analytics Management

Aggiorniamo periodicamente l'API di gestione di Google Analytics al fine di offrire nuove funzionalità e correggere i difetti rilevati nelle versioni precedenti. Nella maggior parte dei casi, queste modifiche saranno trasparenti per gli sviluppatori di API. Tuttavia, a volte dobbiamo apportare modifiche che richiedono agli sviluppatori di modificare le loro applicazioni esistenti.

Questa pagina documenta qualsiasi modifica apportata all'API di gestione di Google Analytics che potrebbe influire sulla tua applicazione. Consigliamo agli sviluppatori di API di controllare periodicamente questo elenco per verificare la presenza di nuovi annunci. Puoi anche iscriverti alle modifiche tramite i feed elencati nella sezione Iscriviti di seguito.

Iscriviti ai log delle modifiche correlati

Tutti i log delle modifiche dell'API Google Analytics
–
Abbonati rss

Include tutte le API di raccolta, configurazione e reporting.

Tutti i log delle modifiche dell'API Configuration
–
Abbonati rss

Include API di gestione e API di provisioning.

Log delle modifiche dell'API di gestione
–
Abbonati rss

Impostazioni di conservazione dei dati utente nell'API di gestione

Ora è possibile configurare in modo programmatico le impostazioni di conservazione dei dati utente utilizzando i nuovi campi "dataFidelizzazioneTtl" e "dataFidelizzazioneResetOnNewActivity" aggiunti alla risorsa WebProperty.

Operazioni di scrittura nell'API di gestione

Le operazioni di scrittura nell'API di gestione (ad es. creazione, aggiornamento, eliminazione, applicazione di patch) per le risorse web, vista (profilo) e obiettivo non devono più essere inserite in una lista consentita. Il limite giornaliero predefinito per tutte le operazioni di scrittura nell'API di gestione è di 50 scritture al giorno. Per ulteriori informazioni, consulta la pagina Limiti e quote.

Metriche personalizzate

Si tratta di una release per la correzione di bug; corregge il problema a causa del quale la creazione di una metrica personalizzata di tipo TIME non era riuscita se min_value non era impostato. Le richieste senza min_value ora creano una metrica personalizzata con un valore predefinito di min_value pari a 0.

In questa versione, i segmenti di pubblico per il remarketing vengono aggiunti all'API di gestione.

Segmenti di pubblico per il remarketing

L'API di gestione ti consente di create, get, list, update e patch segmenti di pubblico per il remarketing per una proprietà Google Analytics. Per ulteriori informazioni sul funzionamento dei segmenti di pubblico per il remarketing, consulta l'articolo del Centro assistenza Informazioni sui segmenti di pubblico per il remarketing in Analytics.

Report non campionati

L'API dei report non campionati non ha più un limite di 100 report al giorno. L'API utilizza lo stesso sistema di token per proprietà, al giorno utilizzato per la creazione di un report non campionato tramite l'interfaccia web.

Report non campionati

I report non campionati che non sono accessibili all'utente corrente non disporranno più di un link per il download all'interno del messaggio di risposta dell'API di gestione. Questo comportamento è ora coerente con la funzionalità della dashboard dell'interfaccia utente in cui solo i proprietari dei report possono visualizzare il link di download del documento generato.

Viste (profili)

In questa release viene aggiunta la proprietà botFilteringEnabled alla risorsa vista (profilo). Questa proprietà indica se il filtro dei bot è abilitato per una vista (profilo). Per maggiori dettagli, consulta la documentazione di riferimento sulla visualizzazione (profili).

Report non campionati

In questa release viene aggiunto il metodo delete ai report non campionati. Per maggiori dettagli, consulta la documentazione sull'eliminazione dei riferimenti nei report non campionati.

Segmenti

Questa è una release per la correzione di bug. In questa release è stato corretto un problema che causava la visualizzazione errata dei segmenti con valori di valuta nella definizione quando veniva chiamato il metodo dell'elenco dei segmenti.

Segmenti

Questa è una release per la correzione di bug. In questa release è stato corretto un problema che causava agli utenti con segmenti privati bloccati a più viste (profili) una risposta di errore 500 quando chiamano il metodo dell'elenco dei segmenti.

Batch

Con questa release, oltre all'assistenza generale per il batch, abbiamo aggiunto un supporto speciale per l'API User Permissions. Le richieste di autorizzazioni degli utenti in batch determineranno miglioramenti significativi delle prestazioni e una riduzione dell'utilizzo della quota.

Viste (profili)

Con questa release, la proprietà currency della vista (profilo) ora verrà impostata in modo predefinito su USD se non viene impostata durante un'operazione di inserimento. Anche le operazioni get e list restituiranno USD per le viste (profili) create in precedenza senza una proprietà currency.

Filtri

Questa release segna la rimozione finale dei campi filtro deprecati IS_MOBILE e IS_TABLET, che devono essere sostituiti con DEVICE_CATEGORY=mobile e DEVICE_CATEGORY=tablet. Le richieste di inserimento, aggiornamento e applicazione di patch che impostano i campi filtro in modo che utilizzino IS_MOBILE e IS_TABLET restituiranno un errore.

Filtri

In questa release è stato aggiunto il supporto dell'utilizzo di una dimensione personalizzata per un campo filtro mediante l'aggiunta di una proprietà fieldIndex a tutte le sezioni dei dettagli del filtro. Ad esempio, ora è possibile impostare l'espressione di filtro con "field": "CUSTOM_DIMENSION" e "fieldIndex": "1" per fare in modo che il filtro funzioni sulla prima dimensione personalizzata.

Obiettivi

In questa release è stato corretto anche un problema che causava la creazione di un obiettivo con "comparisonValue": "0".

Questa release segna la disattivazione e la rimozione finali della risorsa dailyUpload. La risorsa dailyUpload è stata ufficialmente ritirata il 20 giugno 2014. L'importazione di tutti i dati di costo dovrebbe essere effettuata utilizzando la risorsa Caricamenti.

In questa versione sono state aggiunte due nuove raccolte all'API di gestione, alle dimensioni personalizzate e alle metriche personalizzate.

Dimensioni e metriche personalizzate

Ora è possibile creare, elencare, ottenere, applicare patch e aggiornare dimensioni e metriche personalizzate con l'API di gestione.

La risposta del metodo list per tutte le raccolte ora include un elenco vuoto per la proprietà items quando la raccolta non contiene risorse. In precedenza, la proprietà items veniva omessa dalla risposta. Per informazioni dettagliate su query e risposte per i dati di configurazione di Google Analytics, consulta la documentazione di riferimento API.

Questa release introduce un nuovo ambito per l'API Google Analytics Management. - analytics.manage.users.readonly - Visualizza le autorizzazioni utente di Google Analytics.

È stato aggiunto un nuovo campo DEVICE_CATEGORY filtri e IS_MOBILE e IS_TABLET sono stati ritirati. Usa i criteri DEVICE_CATEGORY=mobile e DEVICE_CATEGORY=tablet.

La risorsa Vista (profilo) ora include una proprietà enhancedECommerceTracking che indica se l'E-commerce avanzato è attivato (true) o disattivato (false).

Questa release include nuovi tipi di importazione dati e il ritiro della risorsa dailyUpload.

Importazione dati

Per informazioni dettagliate su come utilizzare l'API di gestione per importare i dati nell'account Google Analytics, consulta la Guida per gli sviluppatori sull'importazione dati.

Caricamenti

  • La risorsa upload ora supporta i seguenti tipi di caricamento:
    • Dati campagna
    • Dati sui contenuti
    • Dati di costo
    • Dati prodotto
    • Dati sul rimborso
    • Dati utente
  • La risorsa upload ha un nuovo metodo migrateDataImport per eseguire la migrazione dei dati di costo customDataSources esistenti.

Ritiro dei caricamenti giornalieri

  • La risorsa dailyUpload è ora deprecata. Per informazioni dettagliate sulla migrazione per utilizzare la funzionalità di importazione dati, consulta la guida alla migrazione.
  • La risorsa dailyUpload continuerà a funzionare per altri sei mesi, dopodiché verrà eseguita la migrazione automatica di tutti i customDataSources rimanenti con proprietà uploadType impostata su analytics#dailyUploads, che funzioneranno solo con la risorsa upload.
  • Gli utenti attuali della risorsa dailyUpload devono aggiornare il proprio codice ed eseguire la migrazione per utilizzare la risorsa di caricamento il prima possibile.

In questa release sono state aggiunte due nuove API di configurazione.

Filtri

Report non campionati: API di gestione

È in corso l'aggiunta all'API di gestione di una nuova risorsa denominata Report non campionati. I report non campionati sono report di Google Analytics (GA) generati utilizzando dati non campionati.I report non campionati sono attualmente disponibili solo per gli utenti di GA Premium. 

Segmenti: API di gestione v2.4 e v3.0

Sono state apportate le seguenti modifiche alla raccolta di segmenti:

  • I segmenti di utenti e sequenze sono ora supportati nell'API.
  • La raccolta segmenti ora restituisce tutti i segmenti a livello di sessione e a livello di utente integrati e personalizzati.
  • La proprietà definition per i segmenti ora utilizzerà la nuova sintassi dei segmenti. Sono incluse le definizioni dei segmenti a livello di sessione esistenti che verranno modificati da definition: "" a definition: "sessions::condition::".
  • Una nuova proprietà type è stata aggiunta alla risorsa Segmento per indicare se un segmento è CUSTOM (creato da un utente nell'interfaccia web) o BUILT_IN (fornito da Google Analytics).

Esperimenti

Le seguenti metriche di AdSense possono ora essere utilizzate come obiettivi di ottimizzazione:

  • ga:adsenseAdsClicks: il numero di volte in cui è stato fatto clic sugli annunci AdSense sul tuo sito.
  • ga:adsenseAdsViewed: il numero di annunci AdSense visualizzati. All'interno di un'unità pubblicitaria possono essere visualizzati più annunci.
  • ga:adsenseRevenue: le entrate totali generate dagli annunci AdSense.

Nuova raccolta riepiloghi account

Sono state apportate le seguenti modifiche ai segmenti predefiniti a causa del ritiro delle dimensioni ga:isMobile e ga:isTablet:

  • Il segmento gaid::-11 è stato rinominato da Traffico da cellulari a Traffico da cellulari e tablet. La definizione di questo segmento è stata modificata da ga:isMobile==Yes a ga:deviceCategory==mobile,ga:deviceCategory==tablet. Tieni presente che ga:isMobile ha incluso traffico da tablet, che risulta nella nuova definizione. Se vuoi solo il traffico da dispositivi mobili, esclusi i tablet, poi passa al nuovo segmento Traffico da dispositivi mobili (gaid::-14).
  • La definizione del segmento gaid::-13 è stata modificata da ga:isTablet==Yes a ga:deviceCategory==tablet. Questo valore continua a rappresentare il traffico da tablet.
  • Il segmento gaid::-14 è stato aggiunto. Il nome del segmento è Traffico da cellulari e la definizione è ga:deviceCategory==mobile.

Correzioni di bug:

  • Le informazioni sul fuso orario delle viste (profili) sono state corrette. Dettagli: prima di questa correzione, in alcuni casi, quando l'elenco delle viste (profili) nell'API di gestione, venivano restituite informazioni errate sul fuso orario di una vista (profilo). Ora le informazioni sul fuso orario per le viste (profili) sono coerenti con quelle impostate nell'interfaccia di amministrazione di Google Analytics.

Questa versione introduce le operazioni di scrittura per le risorse web, le viste (profilo) e l'obiettivo e un insieme di tre nuove risorse che abilitano la gestione delle autorizzazioni utente.

API per l'impostazione e la configurazione dell'account

Autorizzazioni dell'utente nell'API di gestione

Nell'ambito del lancio dei nuovi segmenti, introdurremo le seguenti modifiche alla raccolta dei segmenti:

  • Tutti gli ID segmento verranno modificati da numeri interi positivi a stringhe alfanumeriche. Se hai salvato ID segmento degli utenti, ti consigliamo di aggiornarli in modo da utilizzare i nuovi ID.
  • La raccolta di segmenti restituirà solo i segmenti a livello di visita esistenti. I nuovi segmenti visitatore, coorte e in sequenza non sono attualmente supportati nell'API.
  • La raccolta di segmenti continuerà a restituire i segmenti predefiniti esistenti con gli stessi ID numerici negativi, ma i nuovi segmenti predefiniti al momento non sono supportati.

In questa release vengono aggiunte due nuove proprietà alla risorsa proprietà web:

  • profileCount: il conteggio del profilo di reso per una proprietà. In questo modo puoi filtrare le proprietà che non hanno un profilo (ad es. profileCount = 0).
  • industryVertical: restituisce il verticale o la categoria di settore selezionati per una proprietà.

Correzioni di bug:

  • La proprietà eCommerceTracking della risorsa del profilo è ora coerente con le impostazioni e-commerce nella sezione di amministrazione dell'interfaccia web. Restituisce true quando il monitoraggio e-commerce è attivato e false in caso contrario.
  • La risorsa proprietà web ora include una proprietà level che indica se la proprietà web è PREMIUM o STANDARD.
  • È stato aggiunto un nuovo endpoint all'API di gestione v3 per accedere alle risorse degli esperimenti e modificarle.
  • La risorsa del profilo ora include una proprietà type per identificare se un profilo è configurato per un sito web o un'app. I due valori possibili sono: WEB o APP.

Questa release aggiunge utili risposte di errore all'API di gestione.

  • Nuovi codici di errore, motivi e descrizioni sono stati aggiunti al corpo delle risposte di errore dell'API. Tutti i codici sono stati documentati per entrambe le versioni (versione 2.4 e versione 3.0) dell'API di gestione.

Questa release aggiunge dati, modifica le funzionalità esistenti e corregge un bug.

Nuovi dati

  • La raccolta Segmento avanzato ora contiene un campo segmentId che può essere utilizzato nel parametro segmento dell'API di esportazione dei dati.

Modifiche

  • Il tipo di dati per max-results è stato modificato in integer.

  • Il valore predefinito e massimo di max-results è stato modificato in 1000.

Correzioni di bug

  • Gli account, le proprietà web e i profili per gli esperimenti dello Strumento per ottimizzare il sito di Google non sono più inclusi nelle raccolte corrispondenti.

Questa release aggiunge due nuove versioni dell'API con molte nuove funzionalità e ritira la versione precedente. Le modifiche influiscono sul modo in cui richiedi e gestisci i dati dall'API.

Versione 3.0

  • Si tratta dell'ultima versione principale della nostra API e non è compatibile con le versioni precedenti. Tutto lo sviluppo futuro dell'API verrà effettuato su questa versione.

  • Nuovi dati

    • Rappresentazione completa degli obiettivi di un evento
    • Un ID proprietà web interno che può essere utilizzato per creare un link diretto all'interfaccia utente GA
    • Configurazioni dei profili per i parametri di query di ricerca predefinita nella pagina e nel sito

  • Modifiche

Versione 2.4

  • Si tratta di un upgrade di una versione secondaria per lo più compatibile con la versione precedente 2.3.

  • Modifiche

    • Un nuovo criterio delle quote
    • Integrazione con la Console API di Google per gestire l'accesso API e richiedere una quota maggiore
    • Supporto continuo per i meccanismi di autorizzazione esistenti e OAuth 2.0
    • Nuovo URL per effettuare richieste: https://www.googleapis.com/analytics/v2.4/management/…
    • Risposte solo in XML
    • Nessun supporto per la libreria client JavaScript dei dati di Google
    • L'output XML è conforme alla versione 2.3, pertanto le altre librerie client di dati di Google esistenti continueranno a funzionare.

Ritiro

  • Annunciamo il ritiro della versione legacy 2.3 dell'API di gestione. Continuerà a funzionare per due mesi, dopodiché tutte le richieste della versione 2.3 restituiranno una risposta corrispondente alla versione 2.4.

Questa è la versione beta dell'API di gestione di Google Analytics.

Nuovi feed

Librerie client aggiornate

  • L'API di gestione verrà rilasciata nella stessa libreria dell'API di esportazione dei dati di Google Analytics. Sia le librerie Google Data Java che JavaScript sono state aggiornate. È possibile accedere a ogni feed specificando l'URI del feed appropriato per il metodo getManagementFeed() delle librerie.

Nuova documentazione

  • È stata creata una nuova sezione della documentazione per gli sviluppatori di Google Analytics per descrivere il funzionamento della nuova API di gestione.