Informazioni utili sulla configurazione del tag UET

I gestori di tag sostituiscono i tag statici con tag dinamici più facili da implementare e aggiornare. Il tag dinamico è un contenitore, un piccolo frammento di codice che consente di inserire dinamicamente tag nel sito Web. È possibile considerare il tag del contenitore come un bucket che contiene altri tipi di tag.

UET funziona con tutti i principali sistemi di gestione dei tag. Di seguito è riportato l'elenco corrente dei (e collegamenti alle istruzioni per) i gestori di tag testati e supportati:

• Google Tag Manager
• Qubit Opentag
• Tealium
• Ensighten
• Signal
• Adobe Dynamic Tag Manager
• Adobe Launch

UET è progettato per funzionare con tutte le principali piattaforme di siti Web. Ecco l'elenco corrente di (e collegamenti alle istruzioni per) piattaforme testate e supportate che consentono di installare tag UET:

• BigCommerce
• Shopify
• WordPress.com
• Wix

I siti Web SPA devono usare il codice di monitoraggio dei tag UET JavaScript. Se il codice di monitoraggio UET è stato aggiunto di recente, potrebbe essere già abilitato per il monitoraggio SPA per impostazione predefinita. Per verificare, si può controllare se il frammento di codice del tag contiene o meno il seguente testo in grassetto:

<script> (function(w,d,t,r,u) {var f,n,i;w[u]=w[u]||[] ,f=function(){var o={ti:"TAG_ID_HERE", enableAutoSpaTracking: true}; o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")} ,n=d.createElement(t),n.src=r,n.async=1,n.onload=n .onreadystatechange=function() {var s=this.readyState;s &&s!=="loaded"&& s!=="complete"||(f(),n.onload=n. onreadystatechange=null)},i= d.getElementsByTagName(t)[0],i. parentNode.insertBefore(n,i)})(window,document,"script"," //bat.bing.com/bat.js","uetq"); </script>

Se il frammento di codice del tag non contiene il parametro precedente e si vuole usare il monitoraggio SPA automatico, si può accedere all'interfaccia utente di Microsoft Advertising e ottenere il nuovo frammento di evento con il comportamento sopra indicato abilitato per impostazione predefinita. È quindi possibile aggiornare il sito Web in modo da usare il nuovo frammento.

Se si stanno già monitorando le visualizzazioni delle pagine SPA manualmente, può essere utile disabilitare questo comportamento. A tale scopo, modificare il valore del parametro enableAutoSpaTracking nel frammento di codice del tag su false. È anche consigliabile disabilitare questa opzione se il sito Web non usa lo stato della cronologia del browser per l'esplorazione. In caso di dubbi, è preferibile mantenerla attivata.

Per istruzioni legacy su come tenere traccia manualmente delle visualizzazioni delle pagine SPA, vedere di seguito:

Gli eventi SPA si attivano usando la stessa sintassi degli eventi personalizzati, con l'azione 'page_view' e il parametro 'page_path' obbligatorio ('page_title' è facoltativo). Il parametro 'page_path' deve iniziare con '/'. Esempio:

window.uetq = window.uetq || []; 
window.uetq.push('event', 'page_view', { 'page_path': '/spa_page' });

Ecco tre diversi modi per attivare gli eventi SPA. Si noti che è consigliabile usare il primo modo. Per ogni opzione, è disponibile una pagina Web di esempio che è possibile visitare per visualizzare il codice appropriato in azione.

• Modifica del contenuto: attivare un evento SPA ogni volta che l'applicazione carica contenuto dinamico. In questo caso, l'URL reale viene inviato automaticamente in un evento pageLoad standard al primo caricamento. È possibile usare questo URL negli obiettivi di destinazione e tutti gli eventi personalizzati attivati nella prima pagina verranno associati. Ogni evento SPA genererà un evento pageLoad con l'URL spa, che non deve essere un percorso caricabile. È possibile fare riferimento a questi URL anche negli obiettivi. Tutti gli eventi personalizzati attivati dopo un evento SPA verranno associati solo al caricamento di pagine SPA (in altre parole, non all'URL originale).
  • È possibile verificare il funzionamento di questo codice nella pagina Web di esempio relativa alla modalità "Modifica del contenuto".
• Tutte le pagine: attivare un evento SPA in tutte le pagine, incluso il caricamento iniziale. Questo scenario è identico a quello precedente, ad eccezione dell'evento pageLoad automatico che non viene usato. Poiché viene ancora attivato, è importante ordinare gli eventi in modo che l'evento SPA venga attivato prima di qualsiasi altro evento personalizzato. Se si attivano in modo non in ordine, alcuni o tutti possono essere associati all'evento pageLoad automatico (e all'URL originale), anziché all'evento pageLoad SPA (e all'URL SPA incluso page_path).
  • È possibile verificare il funzionamento di questo codice nella pagina Web di esempio relativa alla modalità "Tutte le pagine".
• Tutte le pagine, disabilitate automaticamente: attivare un evento SPA in tutte le pagine e disabilitare anche il caricamento automatico delle pagine. Questa operazione viene eseguita aggiungendo 'disableAutoPageView: true' ai parametri di inizializzazione (nota: non modificare direttamente il codice del frammento di codice per disabilitarlo). Si tratta dello stesso scenario precedente, ma rimuove il requisito che l'evento SPA deve essere attivato per primo al caricamento iniziale della pagina. Tuttavia, gli eventi SPA successivi devono comunque essere attivati prima di qualsiasi evento personalizzato associato (o verranno attribuiti all'evento SPA precedente).
  • È possibile verificare il funzionamento di questo codice nella pagina Web di esempio relativa alla modalità "Tutte le pagine con disabilitazione automatica".

Dopo aver creato un obiettivo di conversione eventi personalizzato o un elenco di remarketing usando eventi personalizzati (vedere Come monitorare eventi personalizzati con UET), è necessario aggiungere l'evento personalizzato JavaScript al codice di rilevamento dei tag UET. Si supponga che l'evento personalizzato di cui si vuole tenere traccia nella pagina Web siano persone che selezionano un pulsante "Scarica ora" in una delle pagine Web.

Per visualizzare un esempio di codice di rilevamento dei tag UET degli eventi personalizzati installato nel corpo di una pagina Web, visitare questa pagina Web (solo in inglese), fare clic con il pulsante destro del mouse nella pagina Web e quindi selezionare Visualizza origine o Visualizza origine pagina a seconda del browser. In questa pagina verranno visualizzati anche alcuni pulsanti. La selezione di ogni pulsante attiverà un evento personalizzato. Se si usa uno strumento di monitoraggio di terze parti come Fiddler, è possibile visualizzare la richiesta HTTP generata per bat.bing.com per segnalare ogni evento personalizzato.

Per eventi di e-commerce di esempio, vedere Eventi personalizzati di esempio per i clienti e-commerce.

Dopo aver creato un obiettivo di conversione dei ricavi variabili (vedere Come segnalare ricavi variabili con UET), è necessario modificare il codice di monitoraggio UET per supportarlo.

Si esaminerà ora come passare i ricavi variabili per un obiettivo del tipo di URL di destinazione nelle pagine PHP. Nell'esempio seguente viene letto un valore dinamico per i ricavi delle variabili da una funzione JavaScript. È possibile inviare facilmente un valore statico o leggere da una variabile JavaScript o da un elemento HTML.

Per aggiungere il codice alle pagine PHP mediante l'editor della pagina Web, vedere il seguente codice di monitoraggio del tag UET di esempio:

<script>
 (function(w,d,t,r,u){var f,n,i;w[u]=w[u]||[] ,f=function(){var o={ti:"TAG_ID_HERE"}; o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")} ,n=d.createElement(t),n.src=r,n.async=1,n.onload=n .onreadystatechange=function() {var s=this.readyState;s &&s!=="loaded"&& s!=="complete"||(f(),n.onload=n. onreadystatechange=null)},i= d.getElementsByTagName(t)[0],i. parentNode.insertBefore(n,i)})(window,document,"script"," //bat.bing.com/bat.js","uetq");
</script>

<script> function GetRevenueValue() { return 6; }
</script>
<script>
 window.uetq = window.uetq || []; window.uetq.push('event', '', {'revenue_value': GetRevenueValue(), 'currency': 'Replace_with_Currency_Code'});
</script>

Opzioni avanzate: Esempi di codice per gli obiettivi di conversione evento

Ora che si conosce il codice da aggiungere alla fine del codice di monitoraggio del tag UET per gli obiettivi di conversione URL di destinazione, ecco alcuni altri codici da provare:

Obiettivo di conversione evento

È necessario aggiungere codice diverso per segnalare i ricavi variabili per un obiettivo di conversione degli eventi. Se si usa la stessa funzione JavaScript del passaggio 2, l'aspetto sarà simile al seguente:

<script> window.uetq = window.uetq || []; window.uetq.push('event', 'Event action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value', 'revenue_value': GetRevenueValue(), 'currency': 'Replace_with_Currency_Code'}); </script>

Nota: per visualizzare l'elenco completo di codici di valuta, vedere Valute ricavi obiettivo conversione.

Dopo aver creato un elenco di remarketing dinamico (vedere Elenchi di remarketing dinamico: remarketing per i prodotti), è necessario aggiungere parametri personalizzati al codice di monitoraggio del tag UET per fare in modo che funzioni.

Aggiungere il codice JavaScript seguente in ogni pagina del sito Web:

<script>
   window.uetq = window.uetq || []; 
   window.uetq.push ('event', '', {'ecomm_prodid': 'Replace_with_Product_ID', 'ecomm_pagetype': 'Replace_with_Page_Type'}); 
</script>

Nel codice JavaScript precedente modificare i parametri seguenti:

• Replace_with_Product_ID : Sostituire questo parametro con uno degli ID prodotto seguenti:
  • ID SKU esatto che identifica in modo univoco un prodotto. Questa operazione viene talvolta definita UPC (codice prodotto universale).
  • Un ID gruppo di articoli che rappresenta un insieme di varianti per lo stesso prodotto (come il colore o le varie dimensioni).

  Importante

  L'ID prodotto nel codice JavaScript deve corrispondere a un ID del Microsoft Merchant Centerfeed dei prodotti.

• Replace_with_Page_Type : Sostituire questo parametro con uno dei seguenti valori della colonna nella parte destra di questa tabella, in base alla pagina in cui il codice JavaScript verrà utilizzato:

  Elenco di remarketing dinamico che si sta tracciando	Tipo di pagina necessario
  Visitatori generici	'ecomm_pagetype': 'home' 'ecomm_pagetype': 'category' 'ecomm_pagetype': 'other' Nota: gli utenti esclusi dal tipo di pagina per i risultati di ricerca, il prodotto, il carrello o l'acquisto saranno inclusi nel gruppo di destinatari dei visitatori generici.
  Utenti che cercano il prodotto	'ecomm_pagetype': 'searchresults'
  Utenti che visualizzano il prodotto	'ecomm_pagetype': 'product'
  Utenti che hanno abbandonato il carrello	'ecomm_pagetype': 'cart'
  Acquirenti precedenti	'ecomm_pagetype': 'purchase'

  Nota: i clienti che acquistano un prodotto vengono aggiunti all'elenco "acquirenti precedenti" e vengono rimossi da altri elenchi (per quel particolare prodotto). Per il corretto funzionamento, il tag UET nella pagina di conferma dell'acquisto deve inviare sia l'ID prodotto (ecomm_prodid) che il tipo di pagina (ecomm_pagetype).

Per visualizzare un esempio di codice di rilevamento tag UET di remarketing dinamico installato nel corpo di una pagina Web, visitare questa pagina Web (solo in inglese), fare clic con il pulsante destro del mouse nella pagina Web e quindi selezionare Visualizza origine o Visualizza origine pagina a seconda del browser. In questa pagina è anche possibile definire un ID prodotto e un tipo di pagina e quindi selezionare un pulsante per attivare un evento personalizzato per questo elenco dinamico di remarketing. Se si usa uno strumento di monitoraggio di terze parti come Fiddler, è possibile visualizzare la richiesta HTTP generata per bat.bing.com per segnalare ogni evento personalizzato.

Come illustrato nelle sezioni precedenti, per determinate funzionalità di Microsoft Advertising è necessario aggiungere e modificare un frammento di codice JavaScript nel tag UET esistente:

• Eventi personalizzati: Per gli obiettivi di conversione o gli elenchi di remarketing basati su eventi personalizzati, è necessario modificare il frammento di codice seguente in modo che restituisca azione evento, categoria evento, etichetta evento e/o valore evento:

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', 'Replace_with_Event_Action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value'}); 
  </script>

• Ricavi variabili: Per gli obiettivi di conversione che monitorano i ricavi variabili è necessario modificare il frammento di codice seguente in modo che restituisca valore ricavi e codice valuta:

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', '', {'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
  </script>

• Remarketing dinamico: Per definire come target un elenco di remarketing dinamico, è necessario modificare il frammento di codice seguente in modo che restituisca ID prodotto e tipo di pagina:

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', '', {'ecomm_prodid': 'Replace_with_Product_ID', 'ecomm_pagetype': 'Replace_with_Page_Type'}); 
  </script>

Se si implementano più funzionalità, è consigliabile tenere presenti un paio di aspetti:

• È consigliabile tenere il frammento di codice JavaScript di ogni funzionalità separato nel codice della pagina Web (in altre parole, in sezioni <script > </script > distinte) perché ogni frammento di codice invia un evento.
• Nello specifico, non è possibile usare un frammento di codice JavaScript per monitorare entrambi gli elementi seguenti nella stessa pagina Web:
  • Ricavi variabili per l'obiettivo di conversione URL di destinazione
  • Eventi personalizzati in base a un obiettivo di conversione o un elenco di remarketing

  In questo caso devono essere presenti due frammenti di codice distinti nel codice della pagina Web:

  • Frammento di codice 1 — per i ricavi variabili per l'obiettivo di conversione URL di destinazione:

    <script>
       window.uetq = window.uetq || []; 
       window.uetq.push ('event', '', {'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
    </script>

  • Frammento 2 — per eventi personalizzati in base a un obiettivo di conversione o a un elenco di remarketing. Si noti tuttavia che, se si tiene traccia dei ricavi delle variabili per un obiettivo di conversione degli eventi personalizzato ( non un obiettivo di conversione dell'URL di destinazione), è necessario includerlo nel frammento di codice evento personalizzato:

    <script>
       window.uetq = window.uetq || []; 
       window.uetq.push ('event', 'Replace_with_Event_Action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value', 'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
    </script>