[GA4] Informazioni sull'importazione dati

Perché utilizzare l'importazione dati?

Ciascun sistema aziendale che utilizzi genera i propri dati. Il tuo sistema CRM potrebbe contenere informazioni quali valutazioni della fedeltà dei clienti, lifetime value e preferenze di prodotto. Se sei un publisher web, il tuo sistema di gestione dei contenuti potrebbe memorizzare dimensioni quali autore e categoria dell'articolo. Se hai un'attività di e-commerce, memorizzi gli attributi degli articoli come prezzo, stile e taglia.

Inoltre, utilizzi Analytics per misurare il traffico e il rendimento dei tuoi siti web e delle tue app.

In genere, ogni insieme di dati è memorizzato in un proprio silo non influenzato da altri dati. L'importazione dati ti consente di unire tutti questi dati in Analytics in una pianificazione definita per eliminare questi silo, usufruire di nuove informazioni e semplificare l'individuazione dei dati.

Come funziona l'importazione dati

Caricamento dei dati

Devi caricare i file CSV contenenti dati esterni in una proprietà Analytics. Puoi esportare questi file CSV da uno strumento aziendale offline come il sistema CRM o CMS oppure, per quantità di dati inferiori, puoi creare i file manualmente in un editor di testo o in un foglio di lavoro.

L'importazione dati unisce i dati offline caricati ai dati degli eventi raccolti da Analytics. I dati importati migliorano i report, i confronti e i segmenti di pubblico. Il risultato è un quadro più completo delle attività online e offline.

Unire i dati

I dati vengono uniti in due modi diversi a seconda del tipo di dati importati:

• Tempo di raccolta/elaborazione: i dati importati vengono uniti ai dati di Analytics quando questi vengono raccolti ed elaborati come se fossero stati raccolti con l'evento e i dati uniti vengono scritti nelle tabelle aggregate di Analytics. I dati importati non vengono uniti ai dati storici di Analytics (dati già elaborati). Se elimini il file dei dati importati, non avvengono ulteriori unioni, ma quelle che hanno già avuto luogo rimangono in uso.
  
  I dati utente e i dati degli eventi offline vengono uniti al momento della raccolta/elaborazione.

• Tempo generazione report/query: i dati importati vengono uniti ai dati di Analytics quando apri un report e Analytics invia una query per i suoi dati. Questo tipo di unione è temporaneo: se elimini il file dei dati importati, non avvengono ulteriori unioni e i dati uniti non saranno più accessibili in Analytics.
  
  I dati di costo, degli articoli e sugli eventi personalizzati vengono uniti quando generi report e/o esegui query.
  
  I dati relativi alla generazione dei report e/o all'esecuzione delle query non sono disponibili quando crei segmenti di pubblico in Analytics o quando crei segmenti in Esplorazioni.

Quando importi i dati, quelli importati in precedenza vengono mantenuti e vengono aggiunti i nuovi dati importati. Tieni presente che se i dati importati hanno lo stesso insieme di chiavi dei dati importati in precedenza, questi ultimi verranno sovrascritti.

Tipi di metadati che puoi importare

Metadati

L'importazione dei metadati si aggiunge ai dati già raccolti ed elaborati da una proprietà. In genere i metadati sono archiviati in una dimensione o una metrica personalizzata, anche se in alcuni casi è consigliabile sovrascrivere le informazioni predefinite già raccolte (ad esempio l'importazione di un catalogo dei prodotti con categorie aggiornate).

Puoi importare i seguenti tipi di dati:

• Dati di costo: dati su clic, costi e impressioni delle reti pubblicitarie di terze parti (non Google)
• Dati degli articoli: metadati dei prodotti, ad esempio taglia, colore, stile o altre dimensioni correlate al prodotto
• Dati utente: metadati sugli utenti, ad esempio tasso di fedeltà o lifetime value del cliente, che possono essere utilizzati per creare segmenti ed elenchi per il remarketing
• Eventi offline: eventi offline da origini che non hanno una connessione a internet o che non supportano la raccolta di eventi in tempo reale
• Dati sugli eventi personalizzati: metadati degli eventi importati tramite campi standard e/o dimensioni personalizzate

Limiti

Dimensione dell'origine dati	1 GB
Caricamenti giornalieri	120 caricamenti al giorno per proprietà

 

Tipo di dati di importazione	Limite di origini dati per proprietà	Limite spazio di archiviazione per tipo di dati
Dati di costo	Fino a 5	1 GB per tutte le origini di importazione
Dati articolo	Fino a 5	1 GB per tutte le origini di importazione
Dati utente	Fino a 10	Non applicabile
Eventi offline	Fino a 10	Non applicabile
Dati sugli eventi personalizzati	Fino a 5	1 GB per tutte le origini di importazione

Puoi trovare l'utilizzo corrente della quota all'interno del prodotto tramite il pulsante "Informazioni sulla quota".

Come importare i dati

Quando importi i dati, crei un'origine dati. Un'origine dati è la combinazione del file CSV che vuoi caricare e di una mappatura dei campi Analytics esistenti ai campi nel file CSV. Ad esempio:

Non caricare un file che include chiavi duplicate, ad esempio, 2 campi denominati user_id

Puoi consultare questo articolo se vuoi informazioni sulle origini dati.

Prerequisiti per l'utilizzo di SFTP per caricare i dati

Se prevedi di utilizzare l'opzione SFTP nel passaggio 5, assicurati che il server SFTP supporti gli algoritmi delle chiavi host ssh-rsa e ssh-dss. Scopri di più sulla verifica degli algoritmi delle chiavi host che utilizzi e su come formattare l'URL del server SFTP.

Avviare la procedura di importazione

1. In  Amministrazione, in Raccolta e modifica dei dati, fai clic su Importazione dati.
   Il link precedente si apre sull'ultima proprietà Analytics a cui hai eseguito l'accesso. Puoi cambiare la proprietà utilizzando il selettore proprietà. Devi disporre del ruolo Editor o superiore a livello di proprietà per avvia correttamente il processo di importazione.
2. Crea una nuova origine dati o selezionane una esistente. Consulta le sezioni seguenti.

Creare una nuova origine dati

1. Fai clic su Crea origine dati.
2. Inserisci un nome per l'origine dati.
3. Seleziona il tipo di dati:
   • Dati di costo (solo importazione tempo query)
   • Dati degli articoli (importazione tempo generazione report/query)
   • Dati utente per ID utente (importazione tempo di raccolta/elaborazione)
   • Dati utente per ID client (importazione tempo di raccolta/elaborazione)
   • Dati evento offline (importazione tempo di raccolta/elaborazione)
   • Dati sugli eventi personalizzati (importazione tempo generazione report/query)
4. Se richiesto, fai clic su Leggi i termini. Questo messaggio viene visualizzato se stai importando dati utente o dispositivo.
5. Esegui una delle seguenti operazioni:
   • Seleziona Caricamento di file CSV manuale, seleziona il file CSV sul computer e poi fai clic su Apri.
   Oppure
   • Seleziona SFTP.
   • Nome utente del server SFTP: inserisci il nome utente per il server SFTP.
   • URL server SFTP: inserisci l'URL per il server SFTP.
   • Frequenza: scegli la frequenza di caricamento (giornaliera, settimanale, mensile).
   • Ora di inizio: seleziona l'ora di inizio del caricamento.
   • Una volta creata l'origine dati, la chiave pubblica del tuo server SFTP sarà visibile nell'interfaccia in cui stai creando l'origine dati e sarà disponibile nei dettagli delle origini dati (vedi di seguito).
6. Fai clic su Avanti per passare alla fase di mappatura.
7. Seleziona i campi di Analytics e i campi importati che vuoi mappare reciprocamente. Modifica i nomi dei campi secondo necessità.
8. Fai clic su Importa.

Caricare i dati in un'origine dati esistente

1. Nella riga di un'origine dati esistente, fai clic su Importa ora.
2. Se l'origine dati è configurata per l'importazione tramite CSV, seleziona il file CSV da importare e fai clic su Apri.

Il file CSV deve includere gli stessi campi o sottoinsiemi di campi dell'originale. Se vuoi importare campi diversi per lo stesso tipo di dati, devi eliminare l'origine dati esistente e crearne una nuova.

I dati importati nella proprietà sorgente verranno esportati automaticamente in entrambe le proprietà di aggregazione e secondarie.

Verificare gli algoritmi delle chiavi host SFTP e formattare l'URL del server SFTP

Verificare gli algoritmi

Puoi utilizzare vari metodi per verificare se il server SFTP utilizza l'algoritmo della chiave host ssh-rsa o ssh-dss. Ad esempio, puoi utilizzare il client di accesso remoto OpenSSH per controllare i log del server utilizzando il seguente comando:

ssh -vv <nome server sftp>

Se il tuo server supporta uno di questi algoritmi, nel log del server dovresti notare una riga simile alla seguente:

debug2: host key algorithms: rsa-sha2-512, rsa-sha2-256, ssh-rsa

Formattare l'URL del server SFTP

Se l'URL del server SFTP non è formattato correttamente, la configurazione dell'importazione non andrà a buon fine e verrà visualizzato un messaggio di errore interno.

In genere, un URL del server SFTP contiene tre parti che devi prendere in considerazione per caricare i file di importazione dati. Ad esempio:

sftp://example.com//home/jon/upload.csv contiene le seguenti parti:

• Dominio: example.com
• Home directory: //home/jon
• Percorso del file: /upload.csv

Nell'esempio precedente, il file di caricamento si trova nella home directory.

Puoi formattare la parte del dominio dell'URL in diversi modi utilizzando il nome di dominio oppure l'indirizzo IPv4 o IPv6 del server, con o senza il numero di porta:

• Nome di dominio: sftp://example.com
• IPv4 (con numero di porta): sftp://142.250.189.4:1234
• IPv4 (senza numero di porta): sftp://142.250.189.4
• IPv6 (con numero di porta): sftp://[2607:f8b0:4007:817::2004]:1234
• IPv6 (senza numero di porta): sftp://[2607:f8b0:4007:817::2004]

Se non includi il numero di porta, la porta predefinita è la 22.

Puoi formattare correttamente l'URL per includere o escludere la home directory. I seguenti esempi di URL formattati correttamente utilizzano diversi formati per identificare il dominio. Gli esempi includono i numeri di porta, ma puoi scegliere di non utilizzarli.

• Includi la home directory:
  • sftp://example.com//home/jon/upload.csv (nome di dominio)
  • sftp://142.250.189.4:1234//home/jon/upload.csv (IPv4 con numero di porta)
• Escludi la home directory:
  • sftp://example.com/upload.csv (nome di dominio)
  • sftp://[2607:f8b0:4007:817::2004]:1234/upload.csv (IPv6 con numero di porta)

Se il file di caricamento si trova in una sottodirectory della home directory, l'URL sarà simile al seguente:

sftp://example.com//home/jon/data/upload.csv

In questo caso, puoi utilizzare i seguenti tipi di formati:

• Includi la home directory:
  • sftp://example.com//home/jon/data/upload.csv
  • sftp://142.250.189.4:1234//home/jon/data/upload.csv (IPv4 con numero di porta)
• Escludi la home directory:
  • sftp://example.com/data/upload.csv
  • sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 con numero di porta)

Se il file di caricamento non è memorizzato nella home directory (//home/jon) o in una sottodirectory della home directory (//home/jon/data), ma nella directory /foo/bar, il formato corretto dell'URL per il file di caricamento sarà simile al seguente:

sftp://example.com//foo/bar/upload.csv (//foo/bar sostituisce la home directory)

Visualizzare i dettagli delle origini dati, recuperare la chiave pubblica SFTP, importare nuovi dati ed eliminare un'origine dati

1. In  Amministrazione, in Raccolta e modifica dei dati, fai clic su Importazione dati.
   Il link precedente si apre sull'ultima proprietà Analytics a cui hai eseguito l'accesso. Puoi cambiare la proprietà utilizzando il selettore proprietà.

   Devi disporre del ruolo Visualizzatore o superiore a livello di proprietà per visualizza i dettagli dell'origine dati.

2. Nella riga dell'origine dati, fai clic su .

Puoi visualizzare il nome, il tipo di dati, la chiave pubblica e la cronologia di ogni caricamento.

• Chiave pubblica: la chiave pubblica del server SFTP associata a una chiave privata corrispondente che Analytics archivia (e non condivide mai). Questa chiave viene utilizzata per garantire una connessione privata protetta tra il tuo server e i server di importazione dati di Analytics. È fondamentale autorizzare questa chiave pubblica sul tuo server per garantire che l'importazione dei dati possa funzionare in modo sicuro e protetto.
• % di righe importate: il numero di righe importate correttamente diviso per il numero di righe nel file di importazione. 100% significa che tutte le righe sono state importate correttamente.
• Tasso di corrispondenza: il report di chiavi nel file di importazione che si trovano nella tua proprietà negli ultimi 90 giorni. 100% indica che i dati degli ultimi 90 giorni sono tutti utili e pertinenti.
  Nota: % di righe importate e tasso di corrispondenza sono pertinenti per l'importazione dei dati di costo, degli articoli e sugli eventi personalizzati, ma non sono applicabili all'importazione dei dati utente o dei dati sugli eventi offline.

Per importare nuovi dati:

Fai clic su Importa ora e scegli il file CSV pertinente sul computer.

Per eliminare l'origine dati:

1. Fai clic su > Elimina origine dati.
2. Leggi l'avviso di eliminazione e fai clic su Elimina origine dati.

Puoi eliminare i dati importati in modalità tempo di raccolta/elaborazione, ma se vuoi rimuovere i dati caricati in precedenza da tutti gli eventi elaborati da Analytics, potrebbe essere necessario eliminare anche un utente o una proprietà utente. L'eliminazione di un file già importato non comporterà la rimozione dei dati elaborati associati agli eventi raccolti dal completamento dell'importazione. Puoi consultare questo articolo per saperne di più sulle richieste di eliminazione dei dati.

Nomi e prefissi riservati

I seguenti nomi evento, nomi di parametri evento, nomi di proprietà utente e prefissi sono riservati a un uso esclusivo da parte di Analytics. Se provi a caricare dati che includono i nomi o i prefissi riservati, tali dati non verranno caricati.

Ad esempio:

• Se provi a importare un evento con un nome riservato, l'evento e i relativi parametri non verranno importati.
• Se provi a caricare un evento con un nome valido, ma uno dei parametri ha un nome riservato, verrà importato l'evento, ma non il parametro con il nome riservato.

Nomi di eventi riservati

• ad_activeview
• ad_activeview
• ad_exposure
• ad_impression
• ad_query
• adunit_exposure
• app_clear_data
• app_install
• app_remove
• app_update
• error
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• os_update
• screen_view
• session_start
• user_engagement

Nomi di parametri evento riservati

• firebase_conversion

Nomi di proprietà utente riservati

• first_open_after_install
• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id

Prefissi riservati (si applica ai parametri evento e alle proprietà utente)

• ga_
• google_
• firebase_