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.

Google Tag Manager lato server ti consente di spostare i tag di vendita e contatore Google Floodlight dalla pagina web al server. Spostare questi tag sul server ridurrà la quantità di codice da eseguire nella pagina e contribuirà a migliorare i tempi di caricamento della pagina.

Prima di iniziare

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

Passaggio 1: configura il tag Linker conversioni

Il tuo account Floodlight può inviare i 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. Dettagli del tag Linker conversioni

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 a sinistra della pagina.
  2. Fai clic su Nuovo per aggiungere un nuovo tag.
  3. Seleziona il tipo di tag Contatore Floodlight.

    Finestra di dialogo Scegli tipo di tag con il tag Contatore Floodlight evidenziato

  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 valore corrisponde anche al valore di src= in uno snippet del tag Floodlight generato.
    • 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 generato del tag Floodlight.
    • Stringa tag attività: nella tabella Attività, identifica l'attività con cui vuoi lavorare e trova la stringa tag attività elencata in una colonna a destra. La stringa corrisponde anche al valore di cat= in uno snippet generato del tag Floodlight.
  5. Imposta il metodo di conteggio che preferisci:

    • Standard: conteggia ogni conversione.
    • Unico: conteggia la prima conversione per ogni utente unico durante ogni 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 è eseguito il deployment del tag Floodlight.
  6. Apri la finestra Scegli un attivatore.

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

    Finestra di dialogo Scegli attivatore con l'attivatore Tutte le pagine evidenziato

  8. Inserisci un nome per il tag e fai clic su Salva.

    Screenshot che mostra il campo del nome del tag contatore Floodlight modificato in Tag contatore
Floodlight

Vendite Floodlight

Per impostare un tag Vendite Floodlight:

  1. Nell'area di lavoro del contenitore del server, seleziona il menu Tag sul lato a sinistra 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 corrispondente campo e-commerce:

    *   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 valore corrisponde anche al valore di src= in uno snippet del tag Floodlight generato.
    • 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 generato del tag Floodlight.
    • Stringa tag attività: nella tabella Attività, identifica l'attività con cui vuoi lavorare e trova la stringa tag attività elencata in una colonna a destra. La stringa corrisponde anche al valore di cat= in uno snippet generato del tag Floodlight.
  5. Imposta il metodo di conteggio che preferisci:

    • Standard: conteggia ogni conversione.
    • Unico: conteggia la prima conversione per ogni utente unico durante ogni 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 è eseguito il deployment del tag Floodlight.
  6. Apri la finestra Scegli un attivatore.

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

  8. Inserisci un nome per il tag e fai clic su Salva.

(Facoltativo) Configura le conversioni avanzate

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

Per configurare le conversioni avanzate, segui i passaggi riportati di seguito.

Configurare una variabile di dati forniti dall'utente

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 sottoposti ad hashing dei clienti per la corrispondenza.
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 Complessa
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 dall'utente.
  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 dall'utente.
  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.

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

  8. Assegna un nome e salva la variabile Elemento DOM. A questo punto verrà visualizzata nuovamente la pagina Dati forniti dall'utente.

  9. Assegna un nome alla variabile Dati forniti dall'utente, 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 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 eseguire 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': 'name@example.com',
      'phone_number': '+11234567890',
      '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': 'name@example.com',
          'phone_number': '+11234567890',
          '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 di dati forniti dall'utente

  1. Nel contenitore web, apri il menu Variabili.
  2. Crea una nuova variabile definita dall'utente di tipo Dati forniti dall'utente.
  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 e Salva la variabile livello dati. A questo punto verrà visualizzata nuovamente la pagina Dati forniti dall'utente.
  8. Assegna un nome alla variabile Dati forniti dall'utente, 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 dall'utente, ad esempio {{My user-provided data}}.
  4. Salva le modifiche. Il tag dovrebbe essere simile al seguente:

    Screenshot della configurazione finale del tag Google che fa riferimento alla variabile dei dati forniti dall&#39;utente.

Configurare il tag Floodlight lato server

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

alt_text

I dati forniti dagli utenti ti consentono di migliorare la precisione della misurazione inviando dal tuo sito web dati proprietari sottoposti ad hashing e forniti dagli utenti. 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 dall'utente 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 viene inviato 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 valore predefinito per calcolare le entrate. Per specificare una base diversa per il calcolo del valore delle entrate, devi configurare una variabile per estrarre i dati dal database e assegnarli al tag Floodlight delle vendite.

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 da un database Firestore, crea una variabile &lcub;&lcub;Ricerca in Firestore&rcub;&rcub;.
  3. Specifica le origini dati per la variabile.
  4. Assegna un nome alla variabile, ad esempio "Ricerca profitto", e 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, scegli Configurazione personalizzata.
    • Per Entrate, seleziona la variabile creata in precedenza.
    • Per ID ordine, inserisci un ID o utilizza una variabile per compilare dinamicamente l'ID ordine.

    Monitoraggio delle vendite Floodlight con il valore
    delle entrate

  4. Salva il tag.

(Facoltativo) Parametri personalizzati

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

Google Tag Manager

Per configurare i campi personalizzati per Floodlight, anteponi x-dc- al nome di un 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 i dati devono essere inviati a Floodlight, anteponi x-dc-. Ad esempio, se normalmente invii match_id, cambialo in x-dc-match_id.

    Configurazione dei parametri dc- nel tag web GA4.

  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

Una volta iniziato a inviare i 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 avvierà e caricherà il contenitore del server.
  3. La scheda Tag mostra tutti i tag attivati. Assicurati di verificare se il tag che hai configurato è stato attivato.
  4. La scheda Console mostra tutti gli errori che si sono verificati durante la trasmissione dei dati al contenitore del server. Controlla se sono presenti errori e risolvili.

Per ulteriore assistenza per il debug dei contenitori di Tag Manager, consulta la guida all'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.