Questo articolo descrive i diversi modi per inviare eventi a un container lato server. Se hai bisogno di ulteriori informazioni, consulta Come funziona il tagging lato server.
Questo articolo spiega come:
- Inviare dati da un sito web al contenitore lato server
- Inviare dati aggiuntivi a un contenitore del server
- Ricevere i dati nel contenitore lato server
- Invia dati da fonti diverse dai siti web
Prima di iniziare
Questa guida presuppone che tu abbia già:
1. Inviare dati da un sito web al contenitore lato server
Puoi indirizzare i dati tramite un'implementazione lato server tramite Tag Manager o il tag Google (gtag.js). Scegli l'opzione di implementazione.
(Facoltativo) Invia parametri aggiuntivi con ogni evento
Puoi inviare due tipi di parametri aggiuntivi: parametri a livello di configurazione e parametri a livello di evento. I parametri di configurazione influiscono sul comportamento del tag Google e possono essere impostati solo a livello di tag Google.
I parametri evento specificano informazioni aggiuntive su un evento e possono essere impostati
per tutti gli eventi, eventi selezionati o eventi page_view.
2. Ricevere i dati nel contenitore lato server
Quando invii una richiesta HTTP a un contenitore del server, un client deve rivendicare la richiesta.
Per visualizzare l'elenco dei client disponibili:
Apri il contenitore del server.
Nella barra di navigazione a sinistra, fai clic su Clienti. Il client GA4 è preinstallato sul contenitore lato server per impostazione predefinita. Se devi utilizzare Universal Analytics, configura un client Google Analytics: Universal Analytics.
Fai clic sul nome del cliente per visualizzare o modificare i dettagli.
Impostazioni client facoltative
Nella maggior parte dei casi, il client non richiederà modifiche. Tuttavia, il tuo caso d'uso potrebbe essere diverso e ti consigliamo di modificare una delle seguenti impostazioni:
Priorità: determina l'ordine in cui verranno eseguiti i client. I numeri più alti vengono eseguiti per primi e il primo client che corrisponde alla richiesta in entrata diventerà il client attivo per quella richiesta.
Criteri di attivazione: i criteri di attivazione definiscono quando il client risponderà alle richieste:
Per i client UA: percorsi Universal Analytics predefiniti: il client si attiverà quando i percorsi della richiesta includono
/collect,/r/collecte altri percorsi simili utilizzati dai file JavaScript che inviano dati a Google Analytics. Questa impostazione è attiva per impostazione predefinita.Percorsi gtag.js predefiniti per ID specifici: utilizza questa impostazione per attivare la pubblicazione di JavaScript gtag.js tramite l'URL del contenitore del server. Se abilitato, questo client si attiverà in risposta alle richieste ai percorsi delle richieste gtag.js predefiniti, ad esempio
/gtag/js?id=TAG_ID. Fai clic su Aggiungi ID misurazione per aggiungere uno o più ID destinazione.
(Facoltativo) Ricevere dati aggiuntivi in Tag Manager lato server
Se invii parametri aggiuntivi, devi configurare il client Google Analytics 4 nel contenitore del server per analizzare i parametri aggiuntivi e creare i dati degli eventi a partire da questi.
Per utilizzare parametri aggiuntivi in un tag server:
- Nel contenitore del server, fai clic su Variabili nel riquadro di navigazione a sinistra.
- Crea una nuova variabile definita dall'utente.
- In Configurazione variabile, seleziona il tipo di variabile Dati evento.
- In Percorso chiave, inserisci il nome del parametro.
- Assegna un nome alla variabile e fai clic su Salva.
Ora puoi utilizzare il parametro evento in qualsiasi altro tag all'interno del contenitore del server.
3. (Facoltativo) Invia i dati da origini diverse dai siti web
Measurement Protocol di Google Analytics può essere utilizzato per attivare il supporto del tagging lato server da origini come app mobile e applicazioni server-to-server.
App mobile
Per fare in modo che la tua app per Android o iOS invii dati al contenitore del server, devi creare un tag immagine personalizzato e configurarlo in modo che utilizzi Measurement Protocol:
- Nel contenitore per dispositivi mobili (Android o iOS), fai clic su Tag > Nuovo.
- In Configurazione tag, seleziona il tipo di tag Immagine personalizzata.
- Imposta il valore dell'URL immagine su un'immagine di pixel sul contenitore del server nel percorso nel client di Measurement Protocol specificato in precedenza.
Aggiungi i parametri di Measurement Protocol che preferisci alla fine dell'URL di pixel:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - Deseleziona Abilita busting della cache.
- Salva il tag e pubblica il contenitore.
- Nel contenitore lato server, fai clic su Clienti > Nuovo.
- In Configurazione client, seleziona il tipo di client Measurement Protocol.
- Imposta Percorso di attivazione sul percorso dell'endpoint di raccolta dell'app.
- Salva la configurazione client e pubblica il contenitore lato server.
App server-to-server
Per inviare i dati di Measurement Protocol al contenitore del server, sostituisci il nome host www.google-analytics.com con il nome di dominio del contenitore del server. Ad esempio:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Per ricevere hit di Measurement Protocol, configura l'installazione di Tag Manager lato server con un client Measurement Protocol:
- Nel contenitore lato server, fai clic su Clienti > Nuovo.
- In Configurazione client, seleziona il tipo di client Measurement Protocol.
- Imposta Percorso di attivazione sul percorso dell'endpoint del server.
- Salva la configurazione del client e pubblica il contenitore.
Passaggi successivi
Per inviare i dati in un contesto proprietario effettivo, devi pubblicare script Google, ad esempio la libreria di Google Analytics, dai tuoi server.