Controlla i parametri evento disponibili per i tag con Trasformazioni.

Questo documento è destinato agli utenti del tagging lato server che hanno bisogno di controllare quali parametri evento sono esposti ai tag.

Un contenitore lato server contiene un client che accetta le richieste HTTP in entrata. Le informazioni nella richiesta HTTP vengono tradotte in un oggetto dati degli eventi. I tag lato server leggono l'oggetto dati dell'evento.

Le trasformazioni vengono eseguite dopo che il client ha creato l'oggetto dati degli eventi.

Cosa sono le trasformazioni?

Le trasformazioni consentono di includere, escludere o modificare i parametri degli eventi di output dal client prima che vengano esposti ai tag. Con le trasformazioni puoi salvaguardare informazioni sensibili e avere un controllo granulare sui parametri degli eventi disponibili per elaborarli ulteriormente.

Le trasformazioni consentono di creare regole per:

  • Consenti la condivisione solo di parametri evento definiti esplicitamente con i tag.
  • Aumenta i parametri evento creando regole per modificare o aggiungere i parametri evento.
  • Oscura le informazioni in arrivo escludendo i parametri evento dai tag.

Puoi applicare una trasformazione a tutti i tag, a tutti i tipi di tag o a un set selezionato individualmente. Inoltre, puoi applicare un insieme di condizioni che devono essere soddisfatte prima dell'esecuzione della trasformazione.

Le variabili vengono valutate ogni volta che viene eseguita una trasformazione. A seconda di cosa fanno le tue trasformazioni, le variabili potrebbero risolversi con valori diversi.

Consenti ai tag di utilizzare i parametri evento

La trasformazione Consenti parametri consente di specificare determinati parametri evento che vuoi esporre ai tag. I parametri evento non definiti in modo esplicito vengono ignorati.

Per consentire ai tag di utilizzare determinati parametri evento:

  1. Nell'area di lavoro, apri il menu Trasformazioni.
  2. Crea una Nuova regola di trasformazione.
  3. Fai clic su Configurazione della trasformazione e seleziona Consenti parametri.
  4. Aggiungi i parametri evento che i tag possono utilizzare. Vedi tutti i parametri evento comuni.
  5. Facoltativo: le condizioni di corrispondenza consentono di definire le regole in cui attivare la trasformazione. Per impostazione predefinita, vengono sempre applicate le regole di trasformazione.
  6. In Tag interessati, scegli i tipi di tag o i singoli tag che rispondono a questa regola di trasformazione. Per impostazione predefinita, la trasformazione si applica a tutti i tag.
  7. Assegna un nome alla regola di trasformazione e salvala.

Esempio: registra le informazioni di selezione nella tabella BigQuery

Assumere il controllo dei parametri registrati ti consente di:

  • Assicurati che le informazioni sensibili non vengano registrate nel tuo datastore interno.
  • Impedisci l'eccessiva registrazione che ti aiuta a risparmiare spazio di archiviazione e costi Cloud.
  • Archivia metriche pertinenti per il monitoraggio e il reporting.

Mostrami come fare!

Per consentire la registrazione solo di determinati parametri:

  1. Crea una Nuova regola di trasformazione.
  2. Fai clic su Configurazione della trasformazione e seleziona Consenti parametri.
  3. In Parametri da consentire, aggiungi i parametri di cui hai bisogno, ad esempio event_name, page_hostname, page_path, client_id e così via.
  4. In Tag interessati, seleziona il tag che invia i dati al tuo data warehouse. Per BigQuery, puoi utilizzare addEventCallback e BigQuery APIs in un tag personalizzato oppure esplorare la Galleria modelli della community per trovare opzioni predefinite per monitorare il tuo contenitore del server.
  5. Assegna un nome alla trasformazione e salvala. Dovrebbe avere il seguente aspetto: Screenshot di una trasformazione dei parametri consentiti

Aumenta il numero di parametri degli eventi

La trasformazione Adatta evento ti consente di modificare i valori dei parametri evento o di aggiungere nuovi parametri da rendere disponibili per i tag.

Per modificare o aggiungere determinati parametri evento:

  1. Nell'area di lavoro, apri il menu Trasformazioni.
  2. Crea una Nuova regola di trasformazione.
  3. Fai clic su Configurazione della trasformazione e seleziona Aumenta evento.

  4. In Parametri da aumentare:

    • Per modificare i parametri evento esistenti, inserisci il parametro da modificare in Nome e aggiungi un nuovo Valore. Vedi tutti i parametri comuni degli eventi.

    • Per aggiungere un nuovo valore dell'oggetto dati degli eventi, inserisci un Nome e una Variabile scelti da te.

  5. Facoltativo: le condizioni di corrispondenza consentono di definire le regole in cui attivare la trasformazione. Per impostazione predefinita, vengono sempre applicate le regole di trasformazione.

  6. In Tag interessati, scegli i tipi di tag o i singoli tag che rispondono a questa regola di trasformazione. Per impostazione predefinita, la trasformazione si applica a tutti i tag.

  7. Assegna un nome alla regola di trasformazione e salvala.

Esempio: configurare l'offerta basata sul valore per gli eventi di acquisto

Le offerte basate sul valore ti aiutano a migliorare il rendimento delle campagne ottimizzando la spesa pubblicitaria per scegliere come target gli utenti che hanno un valore maggiore per l'attività. Una volta impostate le offerte basate sul valore, Google Ads utilizza il valore di conversione per impostare le offerte più redditizie per te. La trasformazione dell'evento Aumenta è utile per configurare l'offerta basata sul valore lato server.

Mostrami come fare!

Le seguenti istruzioni sono valide solo se il tag di monitoraggio delle conversioni di Google Ads non specifica un valore di conversione.

Per configurare le offerte basate sul valore:

  1. Crea una Nuova regola di trasformazione.
  2. Fai clic su Configurazione della trasformazione e seleziona Aumenta evento.
  3. In Parametri da aumentare, aggiungi una nuova riga. Configura una variabile per caricare il valore monetario del tuo elemento nella trasformazione:
    1. Nel parametro Nome, inserisci il nome del valore che vuoi modificare, ad esempio value. Sostituisci tutti i campi value perché rappresentano il valore monetario di un evento.
    2. Nel parametro Value (Valore), configura una variabile che recuperi i prezzi dal tuo database. Ad esempio, se memorizzi i dati di prodotto in Firestore, aggiungi una variabile Firestore lookup.
  4. In Condizioni di corrispondenza, imposta l'applicazione di questa trasformazione solo a determinati eventi. Per applicare l'offerta basata sul valore solo per gli eventi di acquisto, imposta: {{Event Name}} uguale a purchase.
  5. In Tag interessati, aggiungi tutti i tag di monitoraggio delle conversioni di Google Ads a cui applicare la trasformazione.
  6. Assegna un nome al tag e salvalo. Dovrebbe avere il seguente aspetto: Screenshot che mostra la trasformazione di un parametro di aumento

Escludi i parametri evento dai tag

La trasformazione Escludi parametri è utile per rimuovere parametri evento specifici dai tag.

Attenzione: i tag potrebbero non funzionare come previsto quando i parametri richiesti sono esclusi. Controlla su quali parametri si basano i tuoi tag prima di trasformare i parametri.

Per escludere i tag da determinati parametri evento:

  1. Nell'area di lavoro, apri il menu Trasformazioni.
  2. Crea una Nuova regola di trasformazione.
  3. Fai clic su Configurazione della trasformazione e seleziona Escludi parametri.
  4. Aggiungi i parametri evento che i tag non possono usare. Vedi tutti i parametri comuni degli eventi.
  5. Facoltativo: le condizioni di corrispondenza consentono di definire le regole in cui attivare la trasformazione. Per impostazione predefinita, vengono sempre applicate le regole di trasformazione.
  6. In Tag interessati, scegli i tipi di tag o i singoli tag che rispondono a questa regola di trasformazione. Per impostazione predefinita, la trasformazione si applica a tutti i tag.
  7. Assegna un nome alla regola di trasformazione e salvala.

Esempio: escludere determinate dimensioni personalizzate GA4 in base al consenso degli utenti

I parametri di esclusione ti consentono di controllare quali dati proprietari vengono inviati a Google. Ad esempio, quando un utente nega i cookie analytics_storage, ti consigliamo di rimuovere alcune dimensioni personalizzate.

Mostrami come fare!

Per rimuovere una dimensione personalizzata:

  1. Crea una Nuova regola di trasformazione.
  2. Fai clic su Configurazione della trasformazione e seleziona Escludi parametri.
  3. In Parametri da escludere, aggiungi una nuova riga e imposta le dimensioni personalizzate che vuoi escludere, ad esempio payment_type, payment_status.
  4. In Condizioni di corrispondenza, configura la trasformazione da applicare solo quando un utente nega analytics_storage cookie.
    Definisci le seguenti condizioni:
    • {{gcs}} uguale a G100
    • {{gcs}} uguale a G110
  5. (Facoltativo) In Tag interessati, aggiungi tutti i tag a cui applicare la trasformazione.
  6. Assegna un nome al tag e salvalo. Dovrebbe avere il seguente aspetto:Esempio di trasformazione dei parametri di esclusione

Verifica che le regole di trasformazione siano applicate

Puoi verificare le regole di trasformazione visualizzando in anteprima l'area di lavoro:

  1. Apri il sito web.

  2. Nel contenitore del server di Google Tag Manager, seleziona Anteprima.

    Tag Assistant si avvia e carica il contenitore del server.

  3. Per visualizzare tutti i tag e le azioni attivati per un evento, seleziona un nome evento dall'elenco a sinistra.

Verifica l'esecuzione di una trasformazione:

  1. Se vuoi verificare, apri la scheda Tag.

  2. Seleziona un tag attivato per visualizzare le proprietà del tag, le richieste HTTP in uscita, gli attivatori di attivazione e le trasformazioni.

    Nota: le trasformazioni influiscono solo sui tag attivati. Una trasformazione può causare l'attivazione del tag se non viene modificato o rimosso i campi dei parametri evento richiesti.

  3. La panoramica Dettagli tag mostra quali trasformazioni sono state eseguite per un tag e in quale ordine. L'ordine predefinito è:

    1. Consenti parametri
    2. Aumenta il numero di parametri
    3. Escludi parametri

    Schermata di Tag Assistant che mostra una panoramica dei tag GA4

  4. Per visualizzare i dettagli della trasformazione, fai clic su una trasformazione. I parametri evento forniti dal tag vengono visualizzati nella sezione Dati evento.

    Tag Assistant che mostra i dettagli di una trasformazione.

  5. Se fai clic sulla casella Dati evento, puoi visualizzare lo stato dei parametri evento dopo l'esecuzione di tutte le trasformazioni. Per visualizzare i parametri evento originali e trasformati, seleziona Mostra originale.

    Panoramica dei parametri evento modificati