Log delle modifiche all'API Google Analytics Management

Aggiorniamo periodicamente l'API di gestione di Google Analytics per 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

Include tutte le API di raccolta, configurazione e generazione di report.

Include API di gestione e API di provisioning.

Impostazioni di conservazione dei dati utente nell'API Management

Ora è possibile configurare in modo programmatico le impostazioni di conservazione dei dati utente utilizzando i nuovi campi "dataConservazioneTtl" 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, viste (profilo) e obiettivo non richiedono più l'inserimento in una lista consentita. Il limite giornaliero predefinito per tutte le operazioni di scrittura nell'API di gestione è di 50 scritture al giorno. Per saperne di più, consulta la pagina Limiti e quote.

Metriche personalizzate

Si tratta di una release per la correzione di bug che risolve il problema a causa del quale la creazione di una metrica personalizzata di tipo TIME non riusciva quando non era impostata la min_value. Le richieste senza un min_value ora creano una metrica personalizzata con un valore predefinito di min_value 0.

Valute

Si tratta di una release per la correzione di bug che risolve un problema a causa del quale un sottoinsieme di valute era supportato nell'interfaccia web di Analytics, ma non nell'API. In questa release è stato aggiunto il supporto per le seguenti valute:

  • AUH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Per ulteriori informazioni, consulta: - La documentazione di riferimento sulle viste (profili). - L'articolo del Centro assistenza Informazioni sulle valute.

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 per i report non campionati non prevede 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 avranno più un link di 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 di visualizzazione (profilo). Questa proprietà indica se il filtro dei bot è abilitato per una vista (profilo). Per maggiori dettagli, consulta la documentazione di riferimento per i (profili).

Report non campionati

In questa release viene aggiunto il metodo delete ai report non campionati. Per informazioni dettagliate, consulta la documentazione di riferimento sull'eliminazione di 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 si chiamava il metodo dell'elenco dei segmenti.

Segmenti

Questa è una release per la correzione di bug. In questa release è stato corretto un problema per cui gli utenti con segmenti privati bloccati su più viste (profili) ricevevano una risposta di errore 500 quando chiamavano il metodo dell'elenco dei segmenti.

Batch

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

Viste (profili)

In questa release, la proprietà currency della vista (profilo) verrà ora impostata su USD per impostazione predefinita, 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

In questa release sono stati rimossi in modo definitivo i campi filtro IS_MOBILE e IS_TABLET, che devono essere sostituiti con DEVICE_CATEGORY=mobile e DEVICE_CATEGORY=tablet. Le richieste di inserimento, aggiornamento e patch che impostano i campi filtro in modo che utilizzino IS_MOBILE e IS_TABLET restituiranno un errore.

Filtri

Questa release supporta l'utilizzo di una dimensione personalizzata per un campo filtro aggiungendo 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.

Gol

In questa release è stato corretto anche un problema relativo alla creazione di un obiettivo con "comparisonValue": "0" che non andrebbe a buon fine.

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 ora essere effettuata utilizzando la risorsa Caricamenti.

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

Dimensioni e metriche personalizzate

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

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. Consulta la documentazione di riferimento API per informazioni dettagliate sulle query e sulle risposte per i dati di configurazione di Google Analytics.

Questa release introduce un nuovo ambito per l'API di gestione di Google Analytics. - 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. Utilizza 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 di 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. Consulta la guida alla migrazione per maggiori dettagli sulla migrazione per utilizzare la funzionalità Importazione dati.
  • La risorsa dailyUpload continuerà a funzionare per altri sei mesi, dopodiché verrà eseguita la migrazione automatica di tutti i restanti customDataSources 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 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 di sequenza ora sono 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 provenienti dagli annunci AdSense.

A causa del ritiro delle dimensioni ga:isMobile e ga:isTablet, sono state apportate le seguenti modifiche ai segmenti predefiniti:

  • 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 e questo si riflette nella nuova definizione. Se vuoi solo il traffico da dispositivi mobili, esclusi i tablet, 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. 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 per le viste (profili) sono state corrette. Dettagli: prima di questa correzione, in alcuni casi, durante la visualizzazione elenco (profili) nell'API di gestione, venivano restituite informazioni errate sul fuso orario per una vista (profilo). Ora le informazioni sul fuso orario delle viste (profili) sono coerenti con quelle impostate nell'interfaccia di amministrazione di Google Analytics.

In questa versione vengono illustrate le operazioni di scrittura per le risorse di proprietà web, vista (profilo) e obiettivo, oltre a un insieme di tre nuove risorse che consentono di gestire le autorizzazioni utente.

API per l'impostazione e la configurazione dell'account

Autorizzazioni degli utenti nell'API di gestione

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

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

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

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

Correzioni di bug:

  • La proprietà eCommerceTracking della risorsa 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 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.

In questa release sono state aggiunte 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 Data Export.

Modifiche

  • Il tipo di dati di 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 non sono più inclusi nelle raccolte corrispondenti.

In questa release sono state aggiunte due nuove versioni dell'API con molte nuove funzionalità e la versione precedente è stata ritirata. Le modifiche influiscono sul modo in cui richiedi e gestisci i dati dall'API.

Versione 3.0

  • Questa è la versione principale più recente della nostra API e non è compatibile con le versioni precedenti. Tutti i futuri sviluppi dell'API verranno eseguiti su questa versione.

  • Nuovi dati

    • Rappresentazione completa degli obiettivi evento
    • Un ID proprietà web interno che può essere utilizzato per creare un link diretto all'interfaccia utente di GA
    • Configurazioni del profilo per i parametri di query di ricerca su sito e pagine predefinite
  • Modifiche

Versione 2.4

  • Si tratta di un upgrade della versione minore, per lo più compatibile con le versioni precedenti della versione 2.3.

  • Modifiche

    • Un nuovo criterio per le quote
    • Integrazione con la Console API di Google per gestire l'accesso alle API e richiedere un aumento della quota
    • Supporto continuo dei meccanismi di autorizzazione esistenti e di 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
    • Output XML conforme alla versione 2.3, in modo che 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 della 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. Sono state aggiornate entrambe le librerie JavaScript e di Google Data Java. È 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.