Utilizza l'API Data Manager per inviare eventi consigliati e personalizzati di Google Analytics.
Per maggiori dettagli, consulta Inviare eventi.
Se esegui l'upgrade da Measurement Protocol di Google Analytics, consulta Eseguire l'upgrade da Measurement Protocol all'API Data Manager per istruzioni.
Casi d'uso
Ecco alcuni casi d'uso per l'invio di eventi consigliati e personalizzati con l'API Data Manager:
Collegare il comportamento online a quello offline.
Misurare le interazioni sia sul lato client sia sul lato server.
Inviare eventi che si verificano al di fuori dell'interazione utente standard, ad esempio le conversioni offline.
Inviare eventi da dispositivi e app in cui non è disponibile la raccolta automatica, come chioschi e smartwatch.
Dati forniti dall'utente
Puoi inviare dati proprietari dei clienti, come indirizzi email, numeri di telefono e indirizzi fisici sottoposti ad hashing, nel campo userData di un Event. Ciò
consente di migliorare la misurazione delle conversioni, l'attribuzione e la creazione di segmenti di pubblico in
Google Analytics.
Quando invii i dati forniti dagli utenti, tieni presente quanto segue:
Inviati con gli eventi: nell'API Data Manager, i dati forniti dall'utente devono essere inviati come parte di un
Event. I caricamenti autonomi senza un evento non sono supportati.Formattazione e hashing: gli identificatori personali (ad esempio indirizzo email, numero di telefono, nome e indirizzo) devono essere normalizzati e sottoposti ad hashing utilizzando SHA-256 prima del caricamento. Gli altri campi (come città, stato o provincia, codice postale e codice paese) sono normalizzati, ma non sottoposti ad hashing. Segui la guida Formattare i dati utente per i requisiti specifici.
Crittografia: puoi facoltativamente criptare i dati utente sottoposti ad hashing.
User-ID: ti consigliamo di fornire
userIdinsieme auserDataogni volta che è disponibile un identificatore utente coerente.Implementazione: consulta Aggiungere dati forniti dall'utente per istruzioni sulla creazione delle richieste.
Considerazioni sull'integrazione
Quando utilizzi l'API Data Manager, tieni presente quanto segue.
Remarketing
Google Analytics supporta il remarketing su più dispositivi quando attivi Google signals. Per il
remarketing cross-device, è necessario userId.
Inoltre, puoi inviare dati forniti dagli utenti per attivare la corrispondenza dei segmenti di pubblico proprietari.
Identificatori pubblicità
Google Analytics unisce automaticamente gli identificatori pubblicitari (come GBRAID o WBRAID)
raccolti durante le interazioni online con gli eventi dell'API Data Manager utilizzando
clientId o appInstanceId.
Impostazioni privacy
Google Analytics unisce gli eventi dell'API Data Manager alle interazioni online utilizzando
clientId o appInstanceId per adottare le impostazioni della privacy degli utenti, ad esempio
"annunci non personalizzati" e "limita il monitoraggio degli annunci".
Puoi anche specificare le impostazioni del consenso dell'utente direttamente su ogni evento utilizzando l'oggetto
consent.
Informazioni geografiche e sul dispositivo
Google Analytics unisce automaticamente le informazioni geografiche e sul dispositivo più recenti
dal tagging con gli eventi API Data Manager utilizzando clientId o appInstanceId.
In questo modo, gli eventi dell'API Data Manager vengono riportati nei report che includono
dimensioni geografiche e dispositivo.
Se vuoi che un evento dell'API Data Manager rifletta le informazioni geografiche e sul dispositivo
di una sessione specifica anziché le informazioni più recenti per
clientId o appInstanceId, includi una voce in
additionalEventParameters con parameterName impostato su session_id e
value impostato sull'ID della sessione specifica e invia l'evento entro
24 ore dall'inizio della sessione.
Puoi fornire informazioni geografiche e informazioni sul dispositivo per gli eventi utilizzando l'API Data Manager.
Server-server completo
Sebbene sia possibile inviare eventi a Google Analytics solo con l'API Data Manager, potrebbe essere disponibile solo la generazione di report parziali. Lo scopo dell'API Data Manager è quello di ampliare gli eventi esistenti raccolti utilizzando gtag, Tag Manager o Firebase. Alcuni nomi di eventi e parametri sono riservati per l'utilizzo tramite la raccolta automatica e non possono essere inviati tramite l'API Data Manager.
Generare o rinominare eventi
Gli eventi inviati con l'API Data Manager non attivano regole per generare o rinominare eventi. La tua applicazione deve implementare la logica per inviare eventi personalizzati tramite l'API Data Manager, in modo simile alle regole configurate nell'interfaccia utente di Google Analytics.