Questo articolo descrive i diversi modi per inviare eventi a un lato server containerizzato. Se hai bisogno di ulteriori informazioni di base, scopri come il tagging lato server funziona.
Questo articolo spiega come:
- Invia i dati da un sito web al contenitore lato server
- Invia dati aggiuntivi a un contenitore del server
- Ricevere i dati nel contenitore lato server
- Invia 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 indirizzare i dati attraverso un'implementazione lato server tramite Tag Manager oppure e gtag.js. Scegli l'opzione di implementazione.
(Facoltativo) Invia parametri aggiuntivi con ogni evento
Puoi inviare altri due tipi di parametri aggiuntivi: A livello di configurazione e parametri a livello di evento. I parametri di configurazione influiscono sul modo in cui il tag Google funziona e può essere impostato solo a livello di tag Google.
I parametri evento specificano informazioni aggiuntive su un evento e possono essere impostati
per tutti gli eventi, seleziona gli eventi o gli eventi page_view.
2. Ricevi dati nel tuo contenitore lato server
Quando invii una richiesta HTTP a un contenitore del server, un client deve richiesta.
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 sono preinstallate sul contenitore lato server per impostazione predefinita. Se devi lavorare con Universal Analytics, configura un parametro Google Analytics: Universal Analytics di alto profilo.
Fai clic sul nome del cliente per visualizzare o modificare i dettagli.
Impostazioni client facoltative
Nella maggior parte dei casi, il client non richiede modifiche. Tuttavia, il tuo caso d'uso potrebbero essere diverse e potresti voler modificare una delle seguenti impostazioni:
Priorità: determina l'ordine di esecuzione dei client. Numeri più alti 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 cliente rispondi alle richieste:
Per i clienti UA: percorsi Universal Analytics predefiniti: il client si attiva quando i percorsi di richiesta includono
/collect,/r/collecte Altri percorsi simili utilizzati dai file JavaScript che inviano dati a Google Analisi. Questa impostazione è attiva per impostazione predefinita.Percorsi gtag.js predefiniti per ID specifici: utilizza questa impostazione per attivare la funzionalità. 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 una o più destinazioni ID.
(Facoltativo) Ricevi dati aggiuntivi in Tag Manager lato server
Se invii parametri aggiuntivi, devi: Configurare il client Google Analytics 4 nel contenitore del server per analizzare parametri aggiuntivi e creare dati sugli eventi utilizzandoli.
Alcuni tag del server includeranno i parametri aggiuntivi nei tag richieste senza 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 sugli eventi.
- 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 tuo server containerizzato.
3. (Facoltativo) Invia dati da origini diverse dai siti web
È possibile utilizzare Measurement Protocol di Google Analytics per attivare l'interfaccia lato server Supporto del tagging da fonti quali app mobile e server-to-server diverse applicazioni.
App mobile
Per fare in modo che la tua app per Android o iOS invii i dati al contenitore del server, devi crea un tag immagine personalizzato e configuralo per utilizzare Measurement Protocol:
- Nel tuo 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 di URL immagine su un'immagine di pixel nel contenitore del server all'indirizzo
il percorso nel client Measurement Protocol specificato in precedenza.
Aggiungi eventuali parametri di Measurement Protocol alla fine del pixel.
URL:
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 Clienti > Nuovo.
- In Configurazione client, seleziona il client Measurement Protocol. di testo.
- 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 valore
Nome host www.google-analytics.com con il nome di dominio del tuo server
containerizzato. 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 il tuo Tag Manager lato server installazione con un client Measurement Protocol:
- Nel contenitore lato server, fai clic su Clienti > Nuovo.
- In Configurazione client, seleziona il client Measurement Protocol. di testo.
- 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 reale, devi pubblicare script Google, come la libreria di Google Analytics, dai tuoi server.