Informazioni utili sulla configurazione del tag UET

Gli strumenti di gestione dei tag sostituiscono i tag statici con tag dinamici che risultano più semplici da implementare e aggiornare. Il tag dinamico è un contenitore, un piccolo frammento di codice che consente di inserire dinamicamente tag nel proprio sito Web. Il tag contenitore è in pratica un bucket che contiene altri tipi di tag.

UET funziona con tutti i principali sistemi di gestione dei tag. Di seguito è disponibile l'elenco dei sistemi di gestione dei tag attualmente verificati e supportati con collegamenti alle istruzioni per il loro utilizzo:

• 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. Di seguito è disponibile l'elenco delle piattaforme di siti Web attualmente verificate e supportate che consentono di installare tag UET. L'elenco include anche collegamenti alle istruzioni per il loro utilizzo:

• BigCommerce
• Shopify
• WordPress.com
• Wix

Nei siti Web SPA è necessario utilizzare il codice di monitoraggio del tag UET JavaScript. Gli eventi SPA vengono attivati utilizzando 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' }); 

Di seguito sono illustrati tre modi diversi di attivare gli eventi SPA. Si tenga presente che è consigliabile utilizzare il primo modo. Per ogni opzione, è disponibile una pagina Web di esempio che è possibile visitare per vedere come funziona il codice appropriato.

• Modifica del contenuto: Un evento SPA viene attivato ogni volta che l'applicazione carica contenuto dinamico. In questo caso, l'URL effettivo viene automaticamente inviato in un evento pageLoad standard al primo caricamento. È possibile utilizzare questo URL negli obiettivi di destinazione. Ogni evento personalizzato attivato nella prima pagina verrà associato a tale URL. Ogni evento SPA genererà un evento pageLoad con l'URL SPA, che non deve necessariamente essere un percorso caricabile. È possibile fare riferimento a questi URL anche negli obiettivi. Qualsiasi evento personalizzato attivato dopo un evento SPA verrà associato solo all'evento pageLoad SPA, ovvero 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: Un evento SPA viene attivato in tutte le pagine, incluso il caricamento iniziale. Questo scenario è analogo a quello precedente, ad eccezione del fatto che l'evento pageLoad automatico non viene utilizzato. Poiché l'attivazione viene comunque eseguita, è importante ordinare gli eventi in modo che l'evento SPA venga attivato prima di qualsiasi altro evento personalizzato. Se vengono attivati senza applicare tale ordine, è possibile che alcuni o tutti gli eventi vengano associati all'evento pageLoad automatico (e all'URL originale), anziché all'evento pageLoad SPA (e all'URL SPA che include page_path).
  • È possibile verificare il funzionamento di questo codice nella pagina Web di esempio relativa alla modalità "Tutte le pagine".
• Tutte le pagine con disabilitazione automatica: Un evento SPA viene attivato in tutte le pagine e il caricamento automatico della pagina viene disabilitato. Questo comportamento viene ottenuto aggiungendo "disableAutoPageView: true" nei parametri di inizializzazione. Nota: non modificare il frammento di codice direttamente per la disabilitazione. Questo scenario è analogo al precedente ma non richiede che l'evento SPA venga attivato per primo al caricamento della pagina iniziale. È comunque necessario che gli eventi SPA successivi vengano attivati prima di qualsiasi evento personalizzato associato a tali eventi. In caso contrario, l'evento personalizzato verrebbe attribuito 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 l'obiettivo di conversione di un evento personalizzato o l'elenco di remarketing che utilizza gli eventi personalizzati (vedere Come monitorare eventi personalizzati con UET), è necessario aggiungere il codice JavaScript dell'evento personalizzato al codice di monitoraggio del tag UET. Si supponga che l'evento personalizzato che si desidera monitorare nella pagina Web sia persone che selezionano un pulsante "Scarica ora" in una delle proprie pagine Web.

Per vedere un esempio di codice di monitoraggio del tag UET di un evento personalizzato installato nel corpo di una pagina Web, visitare questa pagina Web (disponibile solo in inglese), fare clic con il pulsante destro del mouse sulla pagina Web e quindi scegliere Visualizza sorgente o Visualizza sorgente pagina in base al browser. Nella pagina sono inoltre presenti alcuni pulsanti. Ogni pulsante attiva un evento personalizzato. Se si utilizza uno strumento di monitoraggio di terze parti come Fiddler, è possibile vedere 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.

Di seguito è disponibile un esempio che illustra come passare i ricavi variabili per un obiettivo di tipo URL di destinazione nelle pagine PHP. In questo esempio, un valore dinamico per i ricavi variabili viene letto da una funzione JavaScript. È possibile inviare semplicemente un valore statico oppure leggere da una variabile JavaScript o 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>
		 

Advanced: Code samples for event conversion goals

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

Per segnalare i ricavi variabili per un obiettivo di conversione evento, è necessario aggiungere un codice diverso. Se si utilizza la stessa funzione JavaScript del passaggio 2, avrà l'aspetto 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 dinamici: 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:
  • L'esatto ID SKU che identifica univocamente un prodotto. A volte viene denominato UPC (Universal Product Code).
  • 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 feed dei prodotti di Microsoft Merchant Center.

• 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 monitorando	Tipo di pagina richiesto
  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: Gli utenti che acquistano un prodotto vengono aggiunti all'elenco "Acquirenti precedenti" e vengono rimossi dagli altri elenchi (per tale prodotto specifico). Affinché questo funzioni, il tag UET nella pagina di conferma dell'acquisto deve inviare sia l'ID prodotto (ecomm_prodid) sia il tipo di pagina (ecomm_pagetype).

Per vedere un esempio di codice di monitoraggio del tag UET del remarketing dinamico nel corpo di una pagina Web, visitare questa pagina Web (disponibile solo in inglese), fare clic con il pulsante destro del mouse sulla pagina Web e quindi scegliere View source o Visualizza sorgente pagina in base al browser. In questa pagina è inoltre possibile definire un ID prodotto e un tipo di pagina e quindi selezionare un pulsante per attivare un evento personalizzato per questo tipo di gruppo di destinatari prodotto. Se si utilizza uno strumento di monitoraggio di terze parti come Fiddler, è possibile vedere 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': 'Sostituire_con_ID_Prodotto', 'ecomm_pagetype': 'Sostituire_con_Tipo_Pagina'});  
   </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 utilizzare 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 di codice 2 per gli eventi personalizzati in base a un obiettivo di conversione o un elenco di remarketing. Si tenga tuttavia presente che se si monitorano i ricavi variabili per l'obiettivo di conversione di un evento personalizzato (non un obiettivo di conversione URL di destinazione), è necessario includere quanto segue nel frammento di codice dell'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>