L'API di gestione di Google Analytics consente l'accesso programmatico alla funzionalità Importazione dati di Google Analytics.
Introduzione
L'API di gestione ti consente di caricare, elencare, eliminare e recuperare i file caricati, nonché di elencare i set di dati. Per una panoramica generale dei vantaggi della funzionalità Importazione dati, consulta l'articolo del Centro assistenza Informazioni sull'importazione dati.
Le due risorse nell'API di gestione che abilitano l'importazione dati sono:
- La risorsa Origine dati personalizzata, denominata set di dati nell'interfaccia web, che funge da contenitore per i file caricati. Una raccolta di origini dati personalizzate rappresenta tutti i set di dati associati a una proprietà Google Analytics.
- La risorsa Upload, che rappresenta un file caricato. Una raccolta di risorse di caricamento rappresenta tutti i file che hai caricato in un set di dati.
Casi d'uso
La funzionalità di importazione dati ha tre categorie di primo livello, ciascuna con i propri casi d'uso. L'organizzazione è la seguente:
Importazione di dati sui risultati
Dati sui rimborsi
Le transazioni e-commerce che sono state rimborsate completamente o parzialmente possono essere caricate su Google Analytics. In questo modo è più facile riconciliare automaticamente i dati dei report e-commerce di Google Analytics con i rimborsi elaborati.
Per scoprire come importare i dati sui rimborsi in Google Analytics, consulta Esempio di importazione dei dati sui rimborsi.
Importazione di dati completi
Dati utente
Puoi caricare dati utente che non consentono l'identificazione personale da strumenti CRM esterni e creare segmenti di pubblico per il remarketing di Google Ads per i segmenti di utenti più importanti.
Per scoprire come importare i dati utente in Google Analytics per creare segmenti di pubblico per il remarketing di Google Ads, consulta:
Dati della campagna
Puoi importare i dati delle campagne in Google Analytics per personalizzare l'analisi del rendimento delle campagne per la tua attività.
Per scoprire come importare i dati delle campagne in Google Analytics, consulta Importazione dei dati delle campagne utilizzando l'API di gestione.
Dati geografici
Puoi importare mappature degli ID geografici alle regioni, in modo da generare report sui dati di Google Analytics in base alla regione personalizzata. Ad esempio, negli Stati Uniti potresti operare in gruppi di stati dell'Est, del Centro e dell'Ovest; in Europa, potresti operare in gruppi di paesi del Nord, del Centro e del Sud. Durante l'importazione dei dati, puoi utilizzare ga:regionId, ga:cityId, ga:countryIsoCode o ga:subContinentCode come chiavi. Gli ID città e gli ID paese sono elencati nella tabella Targeting geografico. Il Codice ISO del paese e il Codice subcontinente sono elencati rispettivamente nelle tabelle ISO-3166-1 alpha-2 e UN M.49.
Per ulteriori informazioni sull'importazione dei dati geografici, consulta l'esempio di importazione di dati geografici.
Dati sui contenuti
Puoi caricare metadati relativi ai contenuti, ad esempio autore e argomento, per utilizzare Google Analytics al fine di effettuare un'analisi approfondita degli articoli pubblicati su un sito web.
Per scoprire come importare i dati sui contenuti in Google Analytics, consulta l'esempio di importazione dei dati sui contenuti.
Dati di prodotto
L'importazione dei dati di prodotto in Google Analytics semplifica e riduce la quantità di dati di e-commerce da inviare insieme agli hit, come le visualizzazioni di pagina e gli eventi. Puoi unire un singolo ID prodotto o SKU ai dati di prodotto importati per inserire le dimensioni e le metriche dei prodotti nei report.
Per scoprire come importare i dati di prodotto in Google Analytics, consulta Importazione dei dati di prodotto utilizzando l'API di gestione.
Importazione di dati di riepilogo
Dati di costo
Puoi caricare i dati di costo per le campagne a pagamento non Google e utilizzare la piattaforma Google Analytics per eseguire l'analisi del ROI e confrontare il rendimento della campagna per tutti gli investimenti in pubblicità online e marketing.
Per informazioni su come importare i dati di costo in Google Analytics, consulta Importazione dei dati di costo utilizzando l'API di gestione.
Concetti
Stato elaborazione
Dopo aver caricato un file, lo stato del caricamento sarà PENDING fino a quando il caricamento non sarà stato convalidato ed elaborato. Se l'elaborazione ha esito positivo, lo stato cambierà in COMPLETED.
Se si è verificato un errore durante l'elaborazione e il caricamento non è riuscito, lo stato del caricamento sarà FAILED. Ti verrà fornito un elenco di errori per aiutarti a identificare i problemi con il file. Di seguito è riportata una risposta di esempio per un caricamento che non ha superato la convalida:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Somma dei dati di costo e sovrascrittura
Quando crei un set di dati o una sorgente di dati personalizzati per i dati di costo, hai la possibilità di specificare come gestire i casi in cui un file caricato contiene una riga di dati con una chiave (ad es. data, sorgente, mezzo) corrispondente a una riga esistente. Le opzioni sono:
- summation (predefinita): i nuovi dati verranno aggiunti a tutti i dati corrispondenti precedenti e le metriche verranno sommate.
- sovrascrittura: i nuovi dati sovrascriveranno tutti i dati corrispondenti precedenti.
Per scoprire quale tipo è stato impostato per un set di dati, utilizza il metodo elenco delle origini dati personalizzate per verificare se la proprietà importBehavior è impostata su OVERWRITE o SUMMATION.
Sommatoria a livello di riga dei dati di costo e sovrascrittura
Puoi anche ignorare il comportamento del set di dati per ogni file caricato includendo la colonna ga:importBehavior nell'intestazione. Per le righe puoi impostare il valore di ga:importBehavior su SUMMATION o OVERWRITE.
Ad esempio, il seguente file sovrascriverà tutti i dati di costo precedenti per Facebook/cpc e Yahoo/cpc, ma la riga relativa a Bing/cpc verrà aggiunta ai dati di costo esistenti per quella determinata combinazione di data e sorgente/mezzo.
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Formato e vincoli
Per essere caricati su Google Analytics, i dati devono essere inseriti in un file CSV formattato correttamente. Questa sezione descrive i vincoli che deve soddisfare prima di poter essere considerato valido per il caricamento in tutti i tipi di importazione dati.
Se viene violata uno dei vincoli riportati di seguito o se si verifica un errore di analisi, la richiesta di caricamento avrà esito negativo e verrà visualizzato un messaggio di errore. L'API segnalerà fino a 10 errori in una singola risposta per aiutare gli utenti a ridurre il numero di caricamenti non validi.
Vincoli per i file
- Codifica: UTF-8
- Limite dimensione file: 1 GB
Vincoli intestazione
- La prima riga è considerata un'intestazione di colonna ed è obbligatoria. Deve definire le dimensioni e le metriche contenute in quella determinata colonna.
Vincoli di riga
- Esiste un limite di 1 MB di righe.
Formattazione delle celle
- Le celle possono avere una lunghezza massima di 2048 caratteri.
- Gli spazi iniziali e finali di una cella verranno rimossi.
- Per specificare una virgola all'interno di una cella, il valore della cella deve essere racchiuso tra virgolette. ad esempio
source1,"medium,ether",group1,100: il valore della seconda cella è medio,etere. - Per specificare le virgolette all'interno di una cella, oltre alle virgolette iniziali e finali, inserisci l'escape delle virgolette doppie. ad esempio
source1,"medium""ether",group1,100: il valore della seconda cella èmedium"ether.