Controllare i parametri evento disponibili per i tag con le trasformazioni

Questo documento è rivolto agli utenti del tagging lato server che hanno bisogno di controllare quali parametri evento vengono 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 sugli eventi. I tag lato server leggono l'oggetto dati sugli eventi.

Che cosa sono le trasformazioni?

Le trasformazioni consentono di includere, escludere o modificare i parametri evento generati dal client prima che vengano esposti ai tag. Con le trasformazioni puoi salvaguardare le informazioni sensibili e avere un controllo granulare sui parametri evento disponibili per un'ulteriore elaborazione.

Le trasformazioni consentono di creare regole per:

• Consentire la condivisione solo dei parametri evento definiti in modo esplicito con i tag.
• Aumentare il numero di parametri evento creando regole per modificare o aggiungere parametri evento.
• Oscurare le informazioni in arrivo escludendo i parametri evento dai tag.

Puoi applicare una trasformazione a tutti i tag, a interi tipi di tag o a un insieme 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 delle trasformazioni, le variabili potrebbero restituire valori diversi.

Consentire 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 trasformazione e seleziona Consenti parametri.
4. Aggiungi i parametri evento che i tag possono utilizzare. Visualizza tutti i parametri evento comuni.
5. (Facoltativo) Condizioni di corrispondenza consente di definire le regole per l'attivazione della trasformazione. Per impostazione predefinita, le regole di trasformazione vengono sempre applicate.
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 viene applicata a tutti i tag.
7. Assegna un nome alla regola di trasformazione e salvala.

Esempio: registrare informazioni selezionate nella tabella BigQuery

Il controllo dei parametri registrati ti consente di:

• Assicurarti che le informazioni sensibili non vengano registrate nel datastore interno.
• Evitare la registrazione eccessiva, risparmiando così sui costi di archiviazione e cloud.
• Memorizzare le metriche pertinenti per il monitoraggio e la generazione di report.

Mostrami come fare.

Per consentire la registrazione solo di determinati parametri:

1. Crea una nuova regola di trasformazione.
2. Fai clic su Configurazione 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 data warehouse. Per BigQuery, puoi utilizzare addEventCallback e BigQuery APIs in un tag personalizzato oppure esplorare la Galleria modelli della community per le opzioni predefinite per monitorare il contenitore del server.
5. Assegna un nome alla trasformazione e salvala. Dovrebbe avere un aspetto simile a questo:

Aumentare il numero di parametri evento

La trasformazione Aumenta evento consente di modificare i valori dei parametri evento o di aggiungere nuovi parametri da rendere disponibili ai 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 trasformazione e seleziona Aumenta evento.

4. In Parametri da aumentare:

   • Per modificare i parametri evento esistenti, inserisci il parametro che vuoi modificare in Nome e aggiungi un nuovo Valore. Visualizza tutti i parametri evento comuni.

   • Per aggiungere un nuovo valore dell'oggetto dati sugli eventi, inserisci un Nome e una Variabile a tua scelta.

5. (Facoltativo) Condizioni di corrispondenza consente di definire le regole per l'attivazione della trasformazione. Per impostazione predefinita, le regole di trasformazione vengono sempre applicate.

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 viene applicata 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

L'offerta basata sul valore ti aiuta a migliorare il rendimento della campagna ottimizzando la spesa pubblicitaria per raggiungere gli utenti che hanno un valore più elevato per l'attività. Una volta configurata l'offerta basata sul valore, Google Ads utilizza il valore di conversione per impostare offerte che hanno un valore maggiore per te. La trasformazione Aumenta evento è utile per configurare l'offerta basata sul valore lato server.

Mostrami come fare.

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

Per configurare l'offerta basata sul valore:

1. Crea una nuova regola di trasformazione.
2. Fai clic su Configurazione trasformazione e seleziona Aumenta evento.
3. In Parametri da aumentare, aggiungi una nuova riga. Configura una variabile per caricare il valore monetario dell'articolo 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 Valore, configura una variabile che recupera i prezzi dal database. Ad esempio, se memorizzi i dati dei prodotti in Firestore, aggiungi una variabile Ricerca Firestore.
4. In Condizioni di corrispondenza, configura in modo che questa trasformazione venga applicata solo a determinati eventi. Per applicare l'offerta basata sul valore solo agli 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 deve essere applicata questa trasformazione.
6. Assegna un nome al tag e salvalo. Dovrebbe avere un aspetto simile a questo:

Escludere 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 vengono esclusi. Prima di trasformare i parametri, controlla quali parametri utilizzano i tag.

Per escludere determinati parametri evento dai tag:

1. Nell'area di lavoro, apri il menu Trasformazioni.
2. Crea una nuova regola di trasformazione.
3. Fai clic su Configurazione trasformazione e seleziona Escludi parametri.
4. Aggiungi i parametri evento che i tag non possono utilizzare. Visualizza tutti i parametri evento comuni.
5. (Facoltativo) Condizioni di corrispondenza consente di definire le regole per l'attivazione della trasformazione. Per impostazione predefinita, le regole di trasformazione vengono sempre applicate.
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 viene applicata a tutti i tag.
7. Assegna un nome alla regola di trasformazione e salvala.

Esempio: escludere le dimensioni personalizzate di Google Analytics selezionate in base al consenso dell'utente

La trasformazione Escludi parametri ti consente di controllare quali dati proprietari vengono inviati a Google. Ad esempio, quando un utente nega i cookie analytics_storage, potresti voler rimuovere le dimensioni personalizzate selezionate.

Mostrami come fare.

Per rimuovere una dimensione personalizzata:

1. Crea una nuova regola di trasformazione.
2. Fai clic su Configurazione 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 in modo che la trasformazione venga applicata solo quando un utente nega i cookie analytics_storage.
   Crea le seguenti condizioni:
   • {{gcs}} è uguale a G100
   • {{gcs}} è uguale a G110
5. (Facoltativo) In Tag interessati, aggiungi tutti i tag a cui deve essere applicata questa trasformazione.
6. Assegna un nome al tag e salvalo. Dovrebbe avere un aspetto simile a questo:

Verificare che le regole di trasformazione vengano applicate

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

1. Apri il tuo 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 il nome di un evento dall'elenco a sinistra.

Verifica che una trasformazione sia stata eseguita:

1. Nell'evento che vuoi verificare, apri la scheda Tag.

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

   Nota: le trasformazioni influiscono solo sui tag attivati. Una trasformazione può impedire l'attivazione del tag se modifica o rimuove i campi dei parametri evento obbligatori.

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

   1. Consenti parametri
   2. Aumenta parametri
   3. Escludi parametri

   

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

   

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