Impostazione di attività Floodlight

Dettagli tecnici per il tag Google e lo snippet evento

Successiva: Monitoraggio delle conversioni interdominio

Il tag Google semplifica il tagging dei prodotti Google di misurazione dei siti, monitoraggio delle conversioni e remarketing. Per registrare una conversione Floodlight, un tag Google si avvale di due snippet di codice, uno snippet globale da installare su ogni pagina del sito e uno snippet evento Floodlight da installare sulla pagina di conversione.

Quando crei un'attività Floodlight, Search Ads 360 genera automaticamente uno snippet globale e uno snippet evento. Questo articolo illustra i campi negli snippet generati da Search Ads 360.

Nota: se crei attività Floodlight in Campaign Manager 360, potresti notare campi aggiuntivi o valori diversi.

Snippet globale

Le pagine AMP (Accelerated Mobile Pages) richiedono un tag diverso rispetto alle pagine per desktop e per dispositivi mobili standard. Prima di implementare il tag, stabilisci quello per il quale è stata configurata la pagina.

Pagine non AMP (Accelerated Mobile Pages)

Ecco un esempio dello snippet globale per le pagine non AMP. Questo snippet deve essere posizionato tra i tag e su ogni pagina del sito.

  <script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments)}; gtag('js', new Date()); gtag('config', 'DC-1234567'); </script> 

Diamo un'occhiata ai campi chiave dello snippet globale:

src="https://www.googletagmanager.com/gtag/js?id=DCM_FLOODLIGHT_CONFIG_ID"
Mostra un identificatore per l'account in cui il tag è stato inizialmente generato. Un tag generato in Search Ads 360 o in Campaign Manager 360 rappresenta l'ID configurazione Floodlight.
gtag('config', 'DCM_FLOODLIGHT_CONFIG_ID');
Il comando config identifica la configurazione Floodlight a cui è associato il tag. Per visualizzare questo ID in Search Ads 360:
1. Nel riquadro di navigazione a sinistra, fai clic su Impostazioni degli inserzionisti.
2. Nella scheda Impostazioni degli inserzionisti, l'ID Floodlight compare nel campo ID Floodlight in Campaign Manager 360.
Se utilizzi il tag Google con più configurazioni Floodlight o prodotti Google, il sito avrà già uno snippet globale con i comandi config. In questo caso, devi solo aggiungere il comando config dell'inserzionista in questione allo snippet globale esistente su ogni pagina del sito. Scopri di più su come utilizzare il tag Google per il monitoraggio delle conversioni Floodlight.

Non devi passare dinamicamente i dati nei campi dello snippet globale. Dopo essere stato installato sul tuo sito con gli identificatori di account corretti, lo snippet globale è completo.

Pagine AMP (Accelerated Mobile Pages)

Ecco un esempio dello snippet globale per le pagine AMP. Questo snippet deve essere posizionato tra i tag e su ogni pagina del sito.

<amp-analytics type="gtag" data-credentials="include"> <script type="application/json"> { "configRewriter": { "varGroups": { "dns": {"enabled": true} } }, "vars": { "gtag_id": "DC-1234567", "config": { "DC-1234567": { "groups": "default", "dc_natural_search": { "exclusion_parameters": [ "^foo[_]bar=qux$", "^yes=no^" ], "engines": { "aol": "1;2;a", "ask": "3;4;b", "google": "5;6;c", "msn": "7;8;d", "yahoo": "9;0;e", "yahoo_japan": "11;12;f" } } } } }, "triggers": { } } </script> </amp-analytics>

Diamo un'occhiata ai campi chiave del tag Google:

configRewriter
Questo campo indica se la pagina è configurata per la generazione di report sui risultati di ricerca naturale.
dc_natural_search
Questo campo contiene il parametro di esclusione e l'elenco dei motori da scegliere come target.

Non devi passare dinamicamente i dati nei campi del tag Google. Una volta installato sul tuo sito con gli identificatori di account corretti, il tag Google è completo.

Snippet evento

Di seguito viene riportato un esempio di snippet evento generato in Search Ads 360 per un'attività di transazione. Lo snippet evento deve essere collocato sulle pagine contenenti gli eventi monitorati. Può essere collocato ovunque sulla pagina dopo lo snippet globale, ma per un monitoraggio più preciso, consigliamo di inserirlo nella sezione .

Per alcuni di questi campi dovrai impostare i valori dinamicamente utilizzando i dati ricavati dalla conversione registrata. Nell'esempio che segue, i segnaposto per i valori dinamici sono riportati tra parentesi, ad esempio: [Revenue].

<script> gtag('event', 'purchase', { 'allow_custom_scripts': true, 'value': '[Revenue]', 'transaction_id': '[Order ID]', 'send_to': 'DC-1234567/group1/thank123+transactions', 'u1': '[Custom Floodlight variable]' }); </script> <noscript> <img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123; qty=1;cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=; ord=[Order ID]?" width="1" height="1" alt=""> </noscript>

Esaminiamo più nel dettaglio i campi principali dello snippet evento:

'allow_custom_scripts' : true
Abilita i tag Floodlight dinamici. Tutte le attività create in Search Ads 360 generano tag dinamici e, affinché i tag dinamici funzionino correttamente, questo campo deve essere impostato su true.
'value': '[Entrate]'
Solo per gli snippet evento di transazione. L'importo delle entrate generate da una conversione, ovvero il prezzo di acquisto degli articoli in vendita. Nella maggior parte dei casi, il relativo valore è costituito dalle entrate generate, non dal prezzo di acquisto totale, che potrebbe includere imposta sulle vendite, IVA, costi di spedizione o altri tipi di costi.

Specifica un numero senza virgole o simboli di valuta. Puoi utilizzare un punto decimale (.), se preferisci.
'transaction_id': '[ID ordine]'
Solo per gli snippet evento di transazione. Un identificatore univoco generato dinamicamente per ogni transazione. L'ID ordine deve essere un numero maggiore di zero.

Gli ID ordine sono inclusi nel report Percorso verso la conversione (P2C) in Report Builder.
'send_to' : 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
Identifica l'attività Floodlight associata al tag e il relativo metodo di conteggio.
- [floodlightConfigID]: identifica la configurazione Floodlight associata allo snippet evento. Si tratta dello stesso valore riportato nel comando 'config' dello snippet globale.
- [activityGroupTagString]/[activityTagString]: identifica l'attività e il gruppo attività. Search Ads 360 genera queste stringhe quando crei un gruppo attività e un'attività. Per visualizzare queste stringhe in Search Ads 360, procedi nel seguente modo:
  1. Nel riquadro di navigazione a sinistra, fai clic su Impostazioni degli inserzionisti.
  2. Fai clic sulla scheda Floodlight▼ e seleziona Attività Floodlight.
  3. La tabella di report include una colonna Stringa tag attività e una colonna Stringa tag gruppo attività Floodlight.
    Nella riga della tabella che riporta un'attività Floodlight, i valori in tali colonne corrisponderanno ai valori nel comando send_to dello snippet evento dell'attività.
- [countingMethod]: specifica il metodo adottato dall'attività per conteggiare le conversioni. Gli snippet evento generati da Search Ads 360 indicano uno dei seguenti metodi di conteggio:
  
  Gli snippet evento generati in Campaign Manager 360 potrebbero specificare altri metodi di conteggio.
  - Standard conteggia tutte le conversioni effettuate da ciascun utente. Questo è il metodo di conteggio per le attività di tipo Azione generate in Search Ads 360.
  - Transactions conteggia il numero di transazioni avvenute e il relativo costo. Ad esempio, se un utente visita un sito web e acquista cinque libri per un totale di 100 €, viene registrata una conversione con quel valore monetario. Questo è il metodo di conteggio per le attività di tipo Transazione generate in Search Ads 360.
- 'u1': '[Custom Floodlight variable]'
  Le variabili Floodlight personalizzate possono accettare qualsiasi valore che decidi di trasmettere. Puoi utilizzare questi valori come metriche o dimensioni e segmenti in Search Ads 360. Non devi passare dati che Search Ads 360 potrebbe utilizzare o riconoscere come informazioni personali.

Campi personalizzati nello snippet evento

Puoi inserire dati personalizzati negli snippet evento utilizzando il campo dc_custom_params.

Questo campo accetta tutti i valori che vuoi passare a Google Marketing Platform. Non puoi trasmettere dati che Google Marketing Platform potrebbe utilizzare o riconoscere come informazioni che consentono l'identificazione personale. Ecco alcuni campi comuni che puoi utilizzare con il campo dc_custom_params:

Nome campo	Formato valore	Metodo di conteggio	Descrizione
`ord`	Numero	Tutti	Il tag globale del sito gestisce il busting della cache automaticamente. Se scegli di sostituire questa impostazione e controllare manualmente il busting della cache, puoi utilizzare il campo `ord`. Aggiungi un valore al campo `ord` in base al tipo di tag e al metodo di conteggio come faresti per un tag iframe.
`num`	Numero	Contatore - Unico	Il tag globale del sito gestisce il busting della cache automaticamente. Se scegli di sostituire questa impostazione e controllare manualmente il busting della cache, puoi utilizzare il campo `num`. Aggiungi un valore al campo `num` come faresti per un tag iframe.
`dc_lat`	0 o 1	Tutti	Questo campo vale per tutti i tag su dispositivi mobili. Accetta il valore 0 o 1. Il valore 1 contraddistingue un utente che ha attivato l'opzione che limita il monitoraggio degli annunci per IDFA o AdID al fine di disattivare gli annunci basati sugli interessi e il remarketing. Se tale opzione è disattivata, il valore è 0. Se mancante o non popolato, questo campo verrà impostato su 0 per impostazione predefinita.
`tag_for_child_directed_treatment`	0 o 1	Tutti	Questo campo vale per tutti i tag su dispositivi mobili. Accetta il valore 0 o 1. Un valore 1 contraddistingue una richiesta che potrebbe provenire da un utente minore di 13 anni, secondo quanto previsto dalla legge COPPA.
`tfua`	0 o 1	Tutti	Accetta il valore 0 o 1. Un valore 1 contraddistingue una richiesta che può provenire da un utente di età inferiore ai 16 anni (l'età potrebbe variare in base al paese), in conformità con il Regolamento generale sulla protezione dei dati (GDPR) dell'Unione europea o altre normative.
`npa`	0 o 1	Tutti	Accetta il valore 0 o 1. Un valore 1 contraddistingue una richiesta che potrebbe provenire da un utente che preferisce disattivare il remarketing. Se mancante o non completato, questo campo verrà impostato su 0 per impostazione predefinita.
`match_id`	stringa	tutti	Un inserzionista univoco ha creato un identificatore (trasmesso tramite Floodlight) che può essere sincronizzato con Google per l'attribuzione di conversioni offline. Il parametro Match ID ha un limite di 50 caratteri ed è sensibile alle maiuscole. Il parametro Match ID può contenere solo lettere, numeri, trattini bassi, trattini e punti.

Esempio di snippet evento con il campo `dc_custom_params`

<script> gtag('event', 'purchase', { 'allow_custom_scripts': true, 'value': '[Revenue]', 'transaction_id': '[OrderID]', 'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]', 'dc_custom_params': { 'ord': '1', 'num': '1234', 'dc_lat': '1', 'tag_for_child_directed_treatment': '0', 'tfua': '1', 'npa': '1', 'match_id':[your_match_id], } }); </script> <noscript> <img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];qty=1;cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;ord=[OrderID]?" width="1" height="1" alt=""/> </noscript>

Sezione degli snippet evento

Gli snippet evento generati da Search Ads 360 includono un tag <noscript> facoltativo che contiene a sua volta un tag immagine Floodlight. Questo tag viene utilizzato per generare rapporti sulle conversioni nei browser che non supportano JavaScript. Se utilizzi tag iframe o immagine Floodlight, ti consigliamo di eseguire la migrazione al tag Google o di utilizzare Google Tag Manager con il Linker conversioni per misurare le conversioni in modo più preciso e sfruttare le integrazioni e le funzionalità dinamiche più recenti non appena diventano disponibili.

Ulteriori informazioni per gli sviluppatori di siti web

Per saperne di più sull'aggiunta del tag Google (gtag) al sito, consulta la Guida per gli sviluppatori gtag.js.

È stato utile?

Come possiamo migliorare l'articolo?