Utilizza l'API Data Manager per inviare eventi consigliati e personalizzati di Google Analytics.
Inviare eventi consigliati e personalizzati
Se stai eseguendo l'upgrade da Measurement Protocol di Google Analytics consulta Eseguire l'upgrade da Measurement Protocol all'API Data Manager per istruzioni.
Panoramica del flusso di lavoro
Per inviare dati sugli eventi con l'API Data Manager, completa i seguenti passaggi:
Prepara le destinazioni: definisci gli oggetti
Destinationper ildestinationscampo della richiesta di importazione per specificare l'account di destinazione e la conversione o la destinazione evento. Per i dettagli, consultaPreparare le destinazioni.Prepara i dati sugli eventi e gli identificatori: Compila
Eventi campi con i dettagli dell'evento e gli identificatori obbligatori (ad es. identificatori di clic sull'annuncio, cliente o istanza dell'app identificatori). Se includi le informazioni di contatto dell'utente inuserData, normalizza e sottoponi ad hashing SHA-256 gli identificatori in base alle linee guida di formattazione e, facoltativamente, criptali. Per i dettagli, consulta Preparare i dati sugli eventi.Crea e invia la richiesta di importazione: invia una richiesta
events.ingestcontenente i recorddestinations,EventeencryptionInfose hai criptatouserData. UtilizzavalidateOnly: trueper testare il payload per errori di fail-fast prima di inviare i dati di produzione. Per i requisiti dei campi e gli esempi di codice, consulta Inviare eventi perControlla la diagnostica: recupera la diagnostica di elaborazione asincrona e verifica lo stato di importazione con
requestStatus.retrieve.
Casi d'uso
Di seguito sono riportati 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 sottoposti ad hashing e indirizzi fisici, 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 dati forniti dall'utente, 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 es. indirizzo email, numero di telefono, nome e indirizzo) devono essere normalizzati e sottoposti ad hashing utilizzando SHA-256 prima del caricamento. Gli altri campi (ad es. città, stato o provincia, codice postale e codice paese) vengono normalizzati, ma non sottoposti ad hashing. Per i requisiti specifici, consulta la guida Formattare i dati utente.
Crittografia: puoi criptare facoltativamente i dati utente sottoposti ad hashing.
User-ID: ti consigliamo di fornire
userIdinsieme auserDataogni volta che è disponibile un identificatore dell'utente coerente.Implementazione: per istruzioni sulla creazione delle richieste, consulta Aggiungere dati forniti dall'utente.
Considerazioni sull'integrazione
Quando utilizzi l'API Data Manager, tieni presente le seguenti considerazioni.
Remarketing
Google Analytics supporta il remarketing sullo stesso dispositivo quando attivi i segnali di Google. Per il
remarketing cross-device, userId è necessario.
Inoltre, puoi inviare dati forniti dall'utente per attivare la corrispondenza dei segmenti di pubblico proprietari.
Identificatori pubblicità
Google Analytics unisce automaticamente gli identificatori pubblicitari (ad es. 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 con le interazioni online utilizzando
clientId o appInstanceId per adottare le impostazioni privacy dell'utente, ad esempio
"Annunci non personalizzati" e "Limita il monitoraggio degli annunci".
Puoi anche specificare le impostazioni di consenso dell'utente direttamente su ogni evento utilizzando l'
consent oggetto.
Informazioni geografiche e sul dispositivo
Google Analytics unisce automaticamente le informazioni geografiche e sul dispositivo più recenti
del tagging con gli eventi dell'API Data Manager utilizzando clientId o appInstanceId.
In questo modo, gli eventi dell'API Data Manager vengono visualizzati nei report che includono le dimensioni geografiche e del 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 esclusivamente con l'API Data Manager, potrebbe essere disponibile solo la generazione di report parziale. Lo scopo dell'API Data Manager è aumentare 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 le 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.