Questo articolo descrive i diversi modi per inviare eventi a un contenitore lato server. Per ulteriori informazioni, consulta come funziona il tagging lato server.
Questo articolo spiega come:
- Inviare dati da un sito web al contenitore lato server
- Invia dati aggiuntivi a un contenitore del server
- Ricevere i dati nel contenitore lato server
- Inviare dati da origini diverse dai siti web
Prima di iniziare
Questa guida presuppone che tu abbia già:
1. Invia i 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) Invia 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 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, per eventi selezionati o per eventi page_view.
2. Ricevere i dati nel contenitore lato server
Quando invii una richiesta HTTP a un contenitore del server, un client deve rivendicarne la proprietà.
Per visualizzare l'elenco dei clienti disponibili:
Apri il contenitore del server.
Nella barra di navigazione a sinistra, fai clic su Clienti. Il client GA4 è preinstallato nel contenitore lato server per impostazione predefinita.
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 potresti voler modificare una delle seguenti impostazioni:
Priorità:determina l'ordine di esecuzione dei client. Vengono eseguiti prima quelli con priorità più alta e il client che per primo viene associato alla richiesta in entrata diventa attivo 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 è attivo, 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 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 è attivo, 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 per analizzare i parametri aggiuntivi e creare i dati sugli eventi.
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 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 Salva.
Ora puoi utilizzare il parametro event in qualsiasi altro tag all'interno del contenitore del server.
3. (Facoltativo) Invia 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 per l'utilizzo di 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 nel client Measurement Protocol specificato in precedenza.
Aggiungi eventuali parametri Measurement Protocol 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 dell'app.
- Salva la configurazione del 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 dell'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 i dati in un contesto proprietario autentico, devi pubblicare gli script Google, come la libreria Google Analytics, dai tuoi server.