Tag Floodlight di Google

Questo articolo è rivolto agli sviluppatori che vogliono spostare i tag Floodlight da un contenitore web di Tag Manager a un contenitore del server.

Tag Manager lato server ti consente di spostare i tag Contatore e Vendite Floodlight di Google dalla pagina web al server. Lo spostamento di questi tag sul server riduce la quantità di codice da eseguire nella pagina e contribuisce a migliorare i tempi di caricamento della pagina.

Prima di iniziare

Prima di poter spostare i tag nel server, assicurati di avere:

• Accesso amministratore a Google Tag Manager e Floodlight
• Configurato e installato Google Tag Manager
• Configurato un contenitore del server
• Configurato il client Google Analytics: GA4

Passaggio 1: configura il tag Linker conversioni

Il tuo account Floodlight può inviare dati sulle conversioni a Google Tag Manager solo se hai configurato un tag Linker conversioni.

Se hai già configurato un tag Linker conversioni nel contenitore del server, puoi saltare questo passaggio.

Per configurare il tag Linker conversioni:

1. Nell'area di lavoro del contenitore del server, apri il menu Tag sul lato sinistro della pagina.
2. Fai clic su Nuovo per aggiungere un nuovo tag.
3. Seleziona il tipo di tag Linker conversioni.
4. Configura l'attivatore che attiverà il tag lato server Linker conversioni.
   Nella maggior parte dei casi, l'attivatore Tutte le pagine è l'opzione migliore.
5. Assegna un nome al tag e fai clic su Salva.

Passaggio 2: configura i tag Floodlight

Google Tag Manager supporta i tag Contatore Floodlight e Vendite Floodlight nel contenitore del server.

Contatore Floodlight

Per configurare un tag Contatore Floodlight:

1. Nell'area di lavoro del contenitore del server, seleziona il menu Tag sul lato sinistro della pagina.
2. Fai clic su Nuovo per aggiungere un nuovo tag.

3. Seleziona il tipo di tag Contatore Floodlight.

   

4. Per trovare i valori richiesti per la configurazione del tag, apri un'altra finestra del browser e accedi a Campaign Manager 360. Fai clic su Inserzionisti e poi sul nome dell'inserzionista. Inserisci questi valori nel nuovo tag Contatore Floodlight di Tag Manager:

   • ID inserzionista: si trova nella pagina dei dettagli dell'inserzionista , proprio sotto il nome di quest'ultimo. Questo corrisponde anche al valore di src= in uno snippet generato del tag Floodlight.
   • Stringa tag gruppo: nella tabella Attività, identifica l'attività con cui lavorare e trova la stringa tag gruppo elencata in una colonna a destra. Questo corrisponde anche al valore di type= in uno snippet del tag Floodlight generato.
   • Stringa tag attività: nella tabella Attività, identifica l' attività con cui lavorare e trova la stringa tag attività elencata in una colonna a destra. Questo corrisponde anche al valore di cat= in uno snippet del tag Floodlight generato.

5. Imposta il metodo di conteggio che vuoi utilizzare:

   • Standard: conteggia ogni conversione.
   • Unico: conteggia la prima conversione per ogni utente unico durante una giornata di 24 ore, da mezzanotte a mezzanotte, ora di New York.
   • Per sessione: conteggia una conversione per utente per sessione. La durata della sessione è impostata dal sito in cui è implementato il tag Floodlight.

6. Apri la finestra Scegli un attivatore.

7. Nel menu Configurazione attivatore, seleziona un attivatore. Nella maggior parte dei casi, l'opzione migliore è Tutte le pagine.

   

8. Inserisci un nome del tag e fai clic su Salva.

   

Vendite Floodlight

Per configurare un tag Vendite Floodlight:

1. Nell'area di lavoro del contenitore del server, seleziona il menu Tag sul lato sinistro della pagina.
2. Fai clic su Nuovo per aggiungere un nuovo tag.

3. Seleziona il tipo di tag Vendite Floodlight. Nota: il tag Vendite Floodlight raccoglie automaticamente i seguenti valori dal campo di e-commerce corrispondente:

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. Per trovare i valori richiesti per la configurazione del tag, apri un'altra finestra del browser e accedi a Campaign Manager 360. Fai clic su Inserzionisti e poi sul nome dell'inserzionista. Inserisci questi valori nel nuovo tag Contatore Floodlight di Tag Manager:

   • ID inserzionista: si trova nella pagina dei dettagli dell'inserzionista , proprio sotto il nome di quest'ultimo. Questo corrisponde anche al valore di src= in uno snippet generato del tag Floodlight.
   • Stringa tag gruppo: nella tabella Attività, identifica l'attività con cui lavorare e trova la stringa tag gruppo elencata in una colonna a destra. Questo corrisponde anche al valore di type= in uno snippet del tag Floodlight generato.
   • Stringa tag attività: nella tabella Attività, identifica l' attività con cui lavorare e trova la stringa tag attività elencata in una colonna a destra. Questo corrisponde anche al valore di cat= in uno snippet del tag Floodlight generato.

5. Imposta il metodo di conteggio che vuoi utilizzare:

   • Standard: conteggia ogni conversione.
   • Unico: conteggia la prima conversione per ogni utente unico durante una giornata di 24 ore, da mezzanotte a mezzanotte, ora di New York.
   • Per sessione: conteggia una conversione per utente per sessione. La durata della sessione è impostata dal sito in cui è implementato il tag Floodlight.

6. Apri la finestra Scegli un attivatore.

7. Nel menu Configurazione attivatore, seleziona un attivatore. Nella maggior parte dei casi, l'opzione migliore è Tutte le pagine.

8. Inserisci un nome del tag e fai clic su Salva.

(Facoltativo) Configura le conversioni con dati del carrello

Puoi configurare il tag Vendite Floodlight in modo che invii conversioni con dati del carrello. Le conversioni con dati del carrello forniscono dettagli granulari degli eventi di conversione a livello di SKU. Se invii l'ID commerciante, l'etichetta del feed, la lingua del feed e i dati di prodotto, puoi identificare gli articoli che vendono bene e quelli che potrebbero aver bisogno di un supporto maggiore.

Passaggio 1 di 2: invia i parametri dei dati del carrello al livello dati

1. Crea un array JSON ecommerce.purchase.products. Ad esempio:

       'ecommerce':{
       'purchase':{
           'products': [{
               'id': 'String',
               'price': 'Floating point',
               'quantity': Integer,
               'country': 'String', // Optional
               'accountId': 'String' // Optional
           },
           {
               … // Each SKU (product) in the transaction
               // is in its own array item.
           }]
       }
       }'
   

2. Utilizza il dataLayer.push metodo per rendere disponibili i dati nel livello dati di Google Tag Manager.

Passaggio 2 di 2: configura il tag Vendite Floodlight

Dati sugli eventi

1. Nel contenitore del server, apri il tag Vendite Floodlight.
2. In "Report sui prodotti", seleziona la casella di controllo Fornisci dati sulle vendite a livello di prodotto.
3. Seleziona Dati sugli eventi dal menu a discesa "Origine dati". Google Tag Manager utilizzerà automaticamente i dati trasferiti al livello dati nell'array ecommerce.purchase.products.
4. Fai clic su Salva.

Configurazione personalizzata

1. Nel contenitore del server, apri il tag Vendite Floodlight.
2. In "Report sui prodotti", seleziona la casella di controllo Fornisci dati sulle vendite a livello di prodotto.
3. Seleziona Configurazione personalizzata dal menu a discesa "Origine dati".
4. Seleziona una variabile dinamica o inserisci manualmente un valore nei seguenti campi:
   • Dati di prodotto: la stringa formattata contiene i dati di prodotto.
   • ID commerciante: l'ID Google Merchant Center del rivenditore.
   • Etichetta del feed: un'etichetta che identifica il feed specifico utilizzato in Google Merchant Center.
   • Lingua del feed: la lingua del feed, rappresentata utilizzando il codice ISO 639-1 a due lettere.
5. Fai clic su Salva.

Nota: per utilizzare appieno questa funzionalità, devi soddisfare i requisiti per le conversioni con dati del carrello.

(Facoltativo) Configura le conversioni avanzate

Se non utilizzi le conversioni avanzate, vai direttamente a Convalida la configurazione.

Per configurare le conversioni avanzate segui i passaggi seguenti.

Configura una variabile Dati forniti dagli utenti

Esistono tre metodi per implementare le conversioni avanzate in Tag Manager: devi solo scegliere un'opzione per raccogliere i dati forniti dagli utenti.

	Raccolta automatica	Configurazione manuale	Configurazione del codice
Metodo raccolta	Raccoglie automaticamente i dati forniti dagli utenti in base al codice del sito web. Per controllare dove raccogliere gli input, scegli una configurazione manuale o del codice.	Specifica le proprietà CSS o le variabili JavaScript selezionate per raccogliere i dati forniti dagli utenti. Se devi assumere il controllo della formattazione e dell'hashing dei dati, scegli la configurazione del codice.	Aggiungi uno snippet di codice al tuo sito web che invii i dati dei clienti con hash per trovare corrispondenze. Questo metodo è la scelta migliore per massimizzare l'accuratezza delle conversioni avanzate, poiché ti consente di inviare dati formattati correttamente ogni volta che il tag di conversione viene attivato.
Complessità	Semplice	Media	Complesso
Competenze	Non servono particolari competenze	HTML e CSS	Sviluppo di siti web

Raccolta automatica

1. Nel contenitore web, apri il menu Variabili.
2. Crea una nuova variabile definita dall'utente di tipo Dati forniti dagli utenti.
3. Imposta Tipo su Raccolta automatica.
4. Assegna un nome alla variabile, ad esempio My user-defined data.
5. Fai clic su Salva.

Configurazione manuale

1. Nel contenitore web, apri il menu Variabili.
2. Crea una nuova variabile definita dall'utente di tipo Dati forniti dagli utenti.
3. Imposta Tipo su Configurazione manuale.

4. Per il campo dei dati utente pertinenti che vuoi fornire tramite le conversioni avanzate, aggiungi una variabile nuova o esistente.

   Nota: se nel tuo livello dati sono già presenti variabili (sia che utilizzi i selettori CSS o altri tipi di variabili), puoi selezionarle anziché crearne di nuove. Se non sei sicuro, continua a seguire le istruzioni. Le variabili possono essere sottoposte o meno a hashing.

5. Per specificare un elemento dal DOM, crea una Nuova variabile > Configurazione variabile > Elemento DOM.

6. In Metodo di selezione, puoi utilizzare un Selettore CSS o un ID. Suggerimento: se le tue variabili CSS cambiano di frequente, aggiungi un ID HTML al tuo sito e utilizza la variabile ID.

7. Inserisci il selettore CSS o l'ID. Puoi lasciare vuoto il campo Nome dell'attributo.

8. Assegna un nome alla variabile Elemento DOM e fai clic su Salva. A questo punto verrà nuovamente visualizzata la pagina "Dati forniti dall'utente".

9. Assegna un nome alla variabile Dati forniti dagli utenti , ad esempio My user-defined data.

10. Fai clic su Salva.

Configurazione del codice

Passaggio 1: identifica e definisci le variabili delle conversioni avanzate

Puoi inviare dati non sottoposti ad hashing, che Google sottoporrà ad l'hashing prima che raggiungano i server, oppure dati sottoposti a pre-hashing. Se decidi di inviare dati sottoposti a pre-hashing, codificali utilizzando SHA256 con codifica esadecimale. In ogni caso, specifica almeno uno dei seguenti campi: email o phone_number.
Per effettuare il push dei dati non sottoposti ad hashing al livello dati:

1. Sul tuo sito web, memorizza i dati forniti dagli utenti come coppie chiave/valore in una variabile JavaScript. Ad esempio:

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. Invia i dati utente insieme a un evento utilizzando dataLayer.push(). Ad esempio:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

La variabile leadsUserData è ora disponibile in Google Tag Manager.

Per eseguire il push dei dati sottoposti a pre-hashing al livello dati:

1. Sul tuo sito web, esegui l'hashing fornito dall'utente utilizzando SHA256 con codifica esadecimale. La chiave per i dati codificati deve iniziare con sha256_. Ad esempio:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. Invia i dati utente insieme a un evento utilizzando dataLayer.push(). L'esempio seguente mostra un'implementazione del livello dati che presuppone che tu abbia scritto una funzione di hashing, che esegui in modo asincrono.

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

La variabile leadsUserData è ora disponibile in Google Tag Manager.

Passaggio 2: crea la variabile Dati forniti dagli utenti

1. Nel contenitore web, apri il menu Variabili.
2. Crea una nuova variabile definita dall'utente di tipo Dati forniti dagli utenti.
3. Imposta Tipo su Codice.
4. Nel campo dei dati utente pertinenti che vuoi fornire, fai clic sul menu a discesa e seleziona Nuova variabile.
5. In Scegli il tipo di variabile, seleziona Variabile di livello dati.
6. Nella variabile di livello dati, fai riferimento ai dati utente archiviati. Ad esempio, leadsUserData.
7. Assegna un nome alla variabile di livello dati e fai clic su Salva. A questo punto verrà nuovamente visualizzata la pagina "Dati forniti dall'utente".
8. Assegna un nome alla variabile Dati forniti dagli utenti , ad esempio My user-defined data.
9. Fai clic su Salva.

Assegna la variabile al tag Google

1. Nel contenitore web, apri il menu Tag.
2. Modifica il tag Google che utilizzi per inviare i dati al server di tagging.
3. In Impostazioni di configurazione, aggiungi un nuovo parametro di configurazione chiamato user_data. Imposta Valore sulla variabile Dati forniti dagli utenti , ad esempio {{My user-provided data}}.

4. Salva le modifiche. Il tag dovrebbe avere questo aspetto:

   

Configura il tag Floodlight lato server

Nel contenitore del server, attiva le conversioni avanzate configurando il tag Vendite Floodlight o Contatore Floodlight.

Nota: quando vengono attivati, i tag Floodlight inviano a Google tutti i dati sulle conversioni disponibili (inclusi i dati forniti dagli utenti). Se vuoi modificare o escludere i parametri evento prima che il tag venga attivato, configura e utilizza le trasformazioni appropriate e collegale al tag.

I dati forniti dagli utenti ti consentono di migliorare l'accuratezza della misurazione mediante l'invio di dati utente proprietari sottoposti ad hashing dal tuo sito web. Per implementare questa funzionalità, devi prima accettare i termini e le norme per i dati forniti dagli utenti nel tuo account Search Ads 360.

Se vuoi includere i dati forniti dagli utenti per le conversioni avanzate per il web, le informazioni che consentono l'identificazione personale (PII) devono essere inviate dal sito web (contenitore lato client), che a sua volta vengono inviate dal contenitore lato server. Se non vuoi che le PII vengano inviate da un tag specifico, utilizza "Trasformazioni" per oscurarle per i tag selezionati.

(Facoltativo) Valore delle entrate

Il tag Vendite Floodlight utilizza il parametro value dell'evento come importo predefinito per calcolare le entrate. Per specificare una base diversa per calcolare il valore delle entrate, devi configurare una variabile per estrarre i dati dal database e assegnarla al tag Vendite Floodlight.

Nota: il contenitore del server cripta il valore delle entrate per garantire che i dati sulle conversioni non vengano esposti quando il server ritrasmette i dati al browser.

Per creare una nuova variabile:

1. Nel contenitore del server, apri il menu Variabili.
2. Crea una nuova variabile definita dall'utente per l'input dei dati. Ad esempio, se vuoi utilizzare un valore di un database Firestore, crea una variabile {{Ricerca Firestore}}.
3. Specifica le origini dati per la variabile.
4. Assegna un nome alla variabile, ad esempio "Ricerca profitto", e fai clic su Salva.

Per utilizzare la variabile nel tag Vendite Floodlight:

1. Nel contenitore del server, apri il menu Tag.
2. Modifica il tag Vendite Floodlight.

3. Nella sezione Parametri unici:

   • Per Origine dati, seleziona Configurazione personalizzata.
   • Per Entrate, seleziona la variabile che hai creato in precedenza.
   • Per ID ordine, inserisci un ID o utilizza una variabile per compilare dinamicamente l'ID ordine.

   

4. Salva il tag.

(Facoltativo) Parametri personalizzati

Puoi trasmettere campi personalizzati dalla pagina web a Google Marketing Platform, ad esempio match_id.

Google Tag Manager

Per configurare i campi personalizzati per Floodlight, anteponi x-dc- a un nome di parametro:

1. Nel contenitore web, apri il menu Tag.
2. Modifica un tag evento GA4 o creane uno nuovo.

3. In Parametri evento, aggiungi il nome del parametro. Per indicare che il parametro è destinato a Floodlight, anteponi x-dc-. Ad esempio, se normalmente invii match_id, modificalo in x-dc-match_id.

   

4. Salva il tag.

gtag.js

Per configurare i campi personalizzati per Floodlight, anteponi x-dc- al nome del parametro evento:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

Passaggio 3: convalida la configurazione

Dopo aver iniziato a inviare dati con il contenitore del server, puoi verificare se funziona correttamente seguendo questi passaggi:

1. Apri il tuo sito web.
2. Nel contenitore del server di Google Tag Manager, seleziona Anteprima. Tag Assistant si avvierà e caricherà il contenitore del server.
3. La scheda Tag mostra tutti i tag che sono stati attivati. Assicurati di controllare se il tag che hai configurato è stato attivato.
4. La scheda Console mostra eventuali errori che si sono verificati durante la trasmissione dei dati al contenitore del server. Verifica la presenza di errori e correggili.

Per ulteriore assistenza con il debug dei contenitori di Tag Manager, consulta la guida alla visualizzazione dell'anteprima e al debug.

Passaggi successivi

Una volta che il tag Floodlight funziona come previsto, puoi rimuovere eventuali tag Floodlight equivalenti in un contenitore web per evitare la duplicazione dei dati.