Questo articolo descrive i diversi modi per inviare eventi a un contenitore lato server. Se hai bisogno di ulteriori informazioni di base, consulta la pagina relativa al funzionamento del 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 dati nel contenitore lato server
- Inviare dati da origini 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 instradare i dati tramite un'implementazione lato server tramite Tag Manager o gtag.js. Scegli l'opzione di implementazione.
(Facoltativo) Inviare parametri aggiuntivi con ogni evento
Puoi inviare altri due tipi di parametri aggiuntivi: parametri a livello di configurazione e parametri a livello di evento. I parametri di configurazione influenzano il 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, per gli eventi selezionati o per gli eventi page_view.
Consigli per la configurazione
Ti consigliamo di utilizzare il tag GA4 su una pagina web per inviare dati al contenitore del server. Questo tag può utilizzare diversi metodi di trasporto per garantire la migliore percentuale di recapito degli eventi. Questi metodi includono, a titolo esemplificativo:
- Pixel immagine
- API Fetch
- XHR
- Service worker in esecuzione in un iframe caricato dal dominio del contenitore del server.
Per assicurarti che tutti i metodi siano supportati, controlla quanto segue:
Content Security Policy (CSP)
| Istruzione | Contenuti | Scopo |
| img-src | [SERVER_CONTAINER_URL] | Richieste di misurazione |
| connect-src | [SERVER_CONTAINER_URL] | Richieste di misurazione |
| frame-src | [SERVER_CONTAINER_URL] | Implementazione del service worker |
Inoltre, X-Frame-Options non deve limitare il caricamento degli iframe dall'URL del contenitore del server.
Consulta la pagina https://developers.google.com/tag-platform/security/guides/csp per le norme specifiche per prodotto.
2. Ricevere 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 Client. Il client GA4 è preinstallato nel contenitore lato server per impostazione predefinita.
Fai clic sul nome del client per visualizzare o modificare i dettagli.
(Facoltativo) Impostazioni del client
Nella maggior parte dei casi, il client non richiede modifiche. Tuttavia, il tuo caso d'uso potrebbe essere diverso e potresti voler modificare una delle seguenti impostazioni:
Priorità:determina l'ordine di esecuzione dei client. Vengono eseguiti prima quelli con priorità più alta e i client che per primi vengono associati alla richiesta in entrata diventano attivi per tale richiesta.
Criteri di attivazione:i criteri di attivazione definiscono quando il client risponde alle richieste:
- 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. Quando è attiva, questo client verrà attivato in risposta alle richieste inviate ai percorsi di richiesta gtag.js predefiniti, ad esempio
/gtag/js?id=TAG_ID. Fai clic su Aggiungi ID misurazione per aggiungere uno o più ID di destinazione.
- 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. Quando è attiva, questo client verrà attivato in risposta alle richieste inviate ai percorsi di richiesta gtag.js predefiniti, ad esempio
(Facoltativo) Ricevere dati aggiuntivi in Tag Manager lato server
Se invii parametri aggiuntivi, devi configurare il client Google Analytics 4 nel contenitore del server in modo che analizzi i parametri aggiuntivi e crei dati sugli eventi da questi.
Alcuni tag server includeranno i parametri aggiuntivi nelle richieste in uscita senza alcuna configurazione. Per escludere questi parametri, crea una trasformazione per rimuovere il valore.
Per utilizzare parametri aggiuntivi in altri tag:
- Nel contenitore del server, fai clic su Variabili nella 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 salvala.
Ora puoi utilizzare il parametro evento in qualsiasi altro tag all'interno del contenitore del server.
3. (Facoltativo) Inviare 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-server. Questa opzione ti consente di inviare eventi al contenitore nel formato Measurement Protocol. Il contenitore invia questi eventi a Google Analytics utilizzando lo stesso meccanismo di tutti gli altri eventi SGTM.
Questa opzione non supporta tutte le funzionalità dell'endpoint Measurement Protocol, come la derivazione di informazioni geografiche e sul dispositivo dagli eventi di tagging.
App mobile
Per fare in modo che la tua app Android o iOS invii dati al contenitore del server, crea un tag immagine personalizzato e configuralo in modo che utilizzi Measurement Protocol:
- Nel contenitore mobile (Android o iOS), fai clic su Tag > Nuovo.
- In Configurazione tag seleziona il tipo di tag Immagine personalizzata.
- Imposta il valore di URL immagine su un'immagine pixel nel contenitore del server nel percorso del client Measurement Protocol che hai specificato in precedenza.
Aggiungi i parametri Measurement Protocol desiderati alla fine dell'URL del 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 Attiva busting della cache.
- Salva il tag e pubblica il contenitore.
- Nel contenitore lato server, fai clic su Client > Nuovo.
- In Configurazione client, seleziona il tipo di client Measurement Protocol.
- Imposta Percorso di attivazione sul percorso dell'endpoint di raccolta della tua app.
- Salva la configurazione del client e pubblica il contenitore lato server.
App server-server
Per inviare dati 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 Measurement Protocol, configura l'installazione di Tag Manager lato server con un client Measurement Protocol:
- Nel contenitore lato server, fai clic su Client > 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 dati in un contesto proprietario effettivo, devi pubblicare gli script Google, ad esempio la libreria di Google Analytics, dai tuoi server.