Utilizza l'API Data Manager per inviare eventi consigliati e personalizzati di Google Analytics.
Invia eventi consigliati e personalizzati
Se esegui l'upgrade da Measurement Protocol di Google Analytics, consulta Esegui l'upgrade da Measurement Protocol all'API Data Manager per istruzioni.
Panoramica del flusso di lavoro
Per inviare i dati sugli eventi con l'API Data Manager, completa i seguenti passaggi:
Prepara le destinazioni:definisci gli oggetti
Destinationper il campodestinationsdella richiesta di importazione per specificare l'account di destinazione e la destinazione della conversione o dell'evento. Per maggiori dettagli, consulta Prepara le destinazioni.Prepara i dati e gli identificatori degli eventi:compila i campi
Eventcon i dettagli degli eventi e gli identificatori richiesti (ad esempio identificatori di clic sull'annuncio, client o istanza di app). Se includi i dati di contatto degli utenti inuserData, normalizza ed esegui l'hashing SHA-256 degli identificatori in base alle linee guida per la formattazione e, facoltativamente, criptali. Per i dettagli, consulta Prepara i dati sugli eventi.Crea e invia la richiesta di importazione: invia una richiesta
events.ingestcontenentedestinations, i recordEventeencryptionInfose hai criptatouserData. UtilizzavalidateOnly: trueper testare il payload per verificare la presenza di errori di tipo fast-fail prima di inviare i dati di produzione. Consulta Invia eventi per i requisiti dei campi e gli esempi di codice.Controlla la diagnostica: recupera la diagnostica dell'elaborazione asincrona e verifica lo stato di importazione con
requestStatus.retrieve.
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. In questo modo, puoi 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 dagli utenti 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 via) devono essere normalizzati e sottoposti ad hashing utilizzando l'algoritmo SHA-256 prima del caricamento. Altri campi (come città, provincia o regione, codice postale e codice paese) vengono normalizzati, ma non sottoposti ad hashing. Segui la guida Formatta i dati utente per i requisiti specifici.
Crittografia: facoltativamente, puoi criptare i dati utente sottoposti ad hashing.
User-ID: ti consigliamo di fornire
userIdinsieme auserDataogni volta che è disponibile un identificatore dell'utente coerente.Implementazione: consulta Aggiungi dati forniti dagli utenti per istruzioni sulla creazione delle richieste.
Considerazioni sull'integrazione
Tieni presente le seguenti considerazioni quando utilizzi l'API Data Manager.
Remarketing
Google Analytics supporta il remarketing sullo stesso dispositivo 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 pubblicità (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 dell'utente, come "annunci non personalizzati" e "limitazione del monitoraggio degli annunci".
Puoi anche specificare le impostazioni relative al 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
provenienti dal tagging con gli eventi dell'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 del dispositivo.
Se vuoi che un evento dell'API Data Manager rifletta le informazioni geografiche e del 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-to-server completa
Sebbene sia possibile inviare eventi a Google Analytics esclusivamente con l'API Data Manager, potrebbe essere disponibile solo una generazione di report parziale. Lo scopo dell'API Data Manager è migliorare 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.
Genera o rinomina gli eventi
Gli eventi inviati con l'API Data Manager non attivano regole per la generazione o la ridenominazione degli 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.