Inviare dati a Tag Manager lato server

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à:

• Configurare un contenitore del server in Tag Manager
• Configurare un server di tagging

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.

Tag Manager gtag.js

Tag Google: GA 4

Per configurare un tag Google per l'elaborazione lato server, devi aggiungere l'URL del contenitore del server.

Crea una variabile di configurazione per l'URL del contenitore del server

1. Apri Google Tag Manager

2. Seleziona il contenitore web che vuoi configurare.

3. Apri il menu Variabili.

4. Crea una nuova variabile definita dall'utente di tipo Tag Google: impostazioni di configurazione.

5. Aggiungi i seguenti parametri:

   • Nome: server_container_url
   • Valore: impostato sull'URL del contenitore del server di Tag Manager.

6. Assegna un nome alla variabile, ad esempio "URL server", e fai clic su Salva.

Assegna l'URL del contenitore del server a un tag Google

1. Apri il menu Tag .
2. Aggiungi un nuovo tag Google o modificane uno esistente.
3. In Impostazioni di configurazione, seleziona la variabile contenitore del server appena creata.
   Suggerimento: per vedere quali parametri sono stati ereditati dalla variabile di impostazioni, fai clic su Mostra impostazioni ereditate.
4. Per assicurarti che il tag Google venga attivato prima di altri attivatori, fai clic su Attivazione e utilizza l'attivatore Inizializzazione - Tutte le pagine. Scopri di più sugli attivatori di pagina.
5. Salva il tag e pubblica il contenitore.

(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.

Parametri di configurazioneTutti gli eventiSeleziona eventipage_view eventi

Scopri come riutilizzare le impostazioni di configurazione in Google Tag Manager.

Per inviare parametri aggiuntivi a tutti gli eventi, riutilizza le impostazioni evento in Google Tag Manager.

Per inviare parametri aggiuntivi con un evento Google Analytics 4:

1. In un contenitore web, aggiungi un tag evento Google Analytics 4 o modificane uno esistente.
2. Fai clic su Parametri evento > Aggiungi riga.
3. Aggiungi il parametro da inviare con l'evento. Per i parametri evento predefiniti, consulta la documentazione di riferimento sugli eventi consigliati.
   • In Nome campo, aggiungi il nome del parametro, ad esempio language.
   • In Valore, aggiungi il valore del parametro.

Suggerimento: se il tuo valore deve essere determinato al momento del caricamento di Tag Manager, utilizza una variabile anziché un valore hardcoded.

1. Configura un attivatore da attivare su Inizializzazione - Tutte le pagine.
2. Salva il tag e pubblica il contenitore.

Per inviare un parametro in un evento page_view:

1. In un contenitore web, modifica un tag Google esistente.

2. Disabilita il valore predefinito page_view nelle impostazioni di configurazione aggiungendo il nuovo parametro:

   • Nome: send_page_view
   • Valore: false

3. Crea un nuovo tag Google Analytics: evento GA4.

   • Seleziona il tag di configurazione modificato nel passaggio 1.
   • Imposta Nome evento su page_view.

4. Aggiungi il parametro da inviare con l'evento. Per i parametri evento predefiniti, consulta la documentazione di riferimento sugli eventi consigliati. - In Nome campo aggiungi il nome del parametro, ad esempio language.

   • In Valore, aggiungi il valore del parametro.

Suggerimento: se il tuo valore deve essere determinato al momento del caricamento di Tag Manager, utilizza una variabile anziché un valore hardcoded.

1. Configura un attivatore da attivare su Inizializzazione - Tutte le pagine.
2. Salva il tag e pubblica il contenitore.

2. Ricevere i dati nel contenitore lato server

Quando invii una richiesta HTTP a un contenitore del server, un client deve rivendicarne la proprietà.

Termine chiave: i "client" fungono da ponte tra il software in esecuzione sul dispositivo di un utente e il contenitore Tag Manager lato server. Ricevono i dati di misurazione da un dispositivo, li trasformano in uno o più eventi, li elaborano nel contenitore e pacchettizzano i risultati da inviare nuovamente al dispositivo.

Per visualizzare l'elenco dei clienti disponibili:

1. Apri Google Tag Manager

2. Apri il contenitore del server.

3. Nella barra di navigazione a sinistra, fai clic su Clienti. Il client GA4 è preinstallato nel contenitore lato server per impostazione predefinita.

4. 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.

(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:

1. Nel contenitore del server, fai clic su Variabili nel riquadro di navigazione a sinistra.
2. Crea una nuova variabile definita dall'utente.
3. In Configurazione variabile, seleziona il tipo di variabile Dati evento.
4. In Percorso chiave, inserisci il nome del parametro.
5. 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:

1. Nel contenitore mobile (Android o iOS), fai clic su Tag > Nuovo.
2. In Configurazione tag, seleziona il tipo di tag Immagine personalizzata.
3. 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
4. Deseleziona Attiva busting della cache.
5. Salva il tag e pubblica il contenitore.
6. Nel contenitore lato server, fai clic su Client > Nuovo.
7. In Configurazione client, seleziona il tipo di client Measurement Protocol.
8. Imposta Percorso di attivazione sul percorso dell'endpoint di raccolta dell'app.
9. 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:

1. Nel contenitore lato server, fai clic su Client > Nuovo.
2. In Configurazione client, seleziona il tipo di client Measurement Protocol.
3. Imposta Percorso di attivazione sul percorso dell'endpoint del server.
4. 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.

Carica script Google tramite il mio server