Universal Event Tracking (UET) mediante un tag IMG

Universal Event Tracking (UET) mediante un tag IMG

Se non è possibile utilizzare l'assegnazione di tag UET basata su JavaScript, è possibile usare una versione non basata su JavaScript. Un'opzione possibile consiste nell'usare un tag IMG.

Universal Event Tracking (UET)

Universal Event Tracking (UET) è un framework Microsoft che acquisisce i dati sul coinvolgimento degli utenti sul proprio sito Web e abilita funzionalità come il monitoraggio delle conversioni (ad es. acquisti o lead), il targeting del pubblico (ad es. remarketing), l'offerta automatica e Microsoft Advertising per il commercio. Ulteriori informazioni su UET e perché è importante per il monitoraggio delle conversioni e il remarketing in Microsoft Advertising.

Si consiglia di utilizzare la versione JavaScript del tag UET e di installarla su tutte le pagine del sito Web. I tag UET JavaScript acquisiscono dati più completi per il monitoraggio delle conversioni e il remarketing. Tuttavia, se l'assegnazione di tag basata su JavaScript non è fattibile, è possibile utilizzare una versione non basata su JavaScript. Un modo per farlo è tramite un tag <img>.

Framework degli eventi UET

Il framework UET definisce più eventi:

• Caricamento pagina: attivato in tutte le visite alla pagina.
• Evento personalizzato: attivato su eventi e tipi di pagina specifici e acquisisce dati più completi.

Durante la stessa visita alla pagina possono essere attivati più eventi UET. utilizza il parametro mid per collegare diversi eventi attivati nella stessa pagina.

L'implementazione di UET senza script è simile a quanto segue:

• Acquisire e salvare msclkid in un cookie dei siti Web visualizzati sul proprio sito Web. Verrà condiviso con tutti gli eventi personalizzati e pageLoad.
• Comprendere la definizione dell'evento pageLoad e attivarla su tutte le visualizzazioni della pagina.
• Comprendere la definizione dell'evento personalizzato e attivarlo su pagine specifiche con i parametri richiesti. Ciascuna visualizzazione della pagina avrà un solo evento pageLoad ma potrebbe avere più eventi personalizzati.
• Alcuni eventi personalizzati devono essere attivati quando l'utente esegue un'azione anziché quando viene caricata la pagina. Ad esempio, quando l'utente aggiunge un prodotto a un carrello, la pagina potrebbe non aggiornarsi e i dettagli dell'evento devono essere acquisiti dopo aver selezionato il pulsante "Aggiungi al carrello". Utilizzare un meccanismo appropriato per attivare questo evento UET.

Endpoint API

UET attiva questo endpoint quando viene attivato un evento: https://bat.bing.com/action/0?
La risposta prevista è: 204

Parametri da acquisire

MSCLKID

MSCLKID viene utilizzato nell'attribuzione della conversione e viene generato al momento del clic sull'annuncio. Questo ID viene aggiunto all'URL della pagina di destinazione quando è abilitata la l'assegnazione automatica di tag di Microsoft Click ID. Dovrebbe essere memorizzato in un cookie proprietario sul proprio sito Web e inviato con la chiamata UET.

MSCLKID è un GUID, come "cdd4afcccb1c9a4cad9544dd7e5006d5".

Nome del cookie suggerito: _uetmsclkid

Scadenza del cookie: 90 giorni

Ecco un esempio:

<script>
    function setCookie(name, value, days) {
        var date = new Date();
        date.setTime(date.getTime() + days * 864e5);
        var expires = "; expires=" + date.toGMTString();
        document.cookie = name + "=" + value + expires;
    }
    function getParam(p) {
        var match = RegExp("[?&]" + p + "=([^&]*)").exec(window.location.search);
        return match && decodeURIComponent(match[1].replace(/\+/g, " "));
    }
    var msclkid = getParam("_uetmsclkid ");
    if (msclkid) {
        setCookie("_uetmsclkid", msclkid, 90);
    }
</script>

MID

Mid consente di unire diversi eventi dalla stessa pagina, come eventi personalizzati e pageLoad. Ecco un esempio di codice utilizzato per generare il MID:

<script>
    this._S4 = function () {
        return Math.floor((1 + Math.random()) * 0x10000)
        .toString(16)
        .substring(1);
    };
    this.getGuid = function () {
        var guid =
            this._S4() +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            this._S4() +
            this._S4();
        return guid;
    };
</script>

Per un elenco completo dei parametri che è possibile acquisire con eventi personalizzati o pageLoad, esaminare questa tabella.

Items

Il parametro Items acquisisce dettagli sui prodotti come ID prodotto, quantità e prezzo. Vengono acquisiti nelle visualizzazioni di pagina e negli eventi che coinvolgono più prodotti, come l'evento "Aggiungi al carrello" o la visita alla pagina del carrello.

Esempi di chiamate API per diversi eventi/diverse pagine

Evento caricamento pagina

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
evt=pageLoad&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
p=https%3A%2F%2Fwww.contoso.com%2Fsearch%3Fq%3Dwall%2Bclock&
r=https%3A%2F%2Fwww.bing.com%2F&
tl=Wall%20Clocks&
kw=clocks,homedecor  

Eventi personalizzati per scenari specifici di vendita al dettaglio
Homepage

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=home 

Category browse page

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=category&
ecomm_category=cat123&
prodid=pid1,pid2,pid3,pid4,pid5,pid6,pid7,pid8,pid9,pid10 

Search results page

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=searchresults&
search_term=wall%20clocks&
prodid=pid1,pid2,pid3,pid4,pid5,pid6,pid7,pid8,pid9,pid10 

Product display page

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=product&
prodid=pid1  

Add to cart event
The example below captures the details for an add to cart event happening on the product display page. If the add to cart happens on another page type, use that pagetype.

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=add_to_cart&
pagetype=product&
prodid=pid12345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1&
gv=50.2&
gc=usd 

Cart page

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=cart&
prodid=prod12345,prod2345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod2345%26quantity%3D1%26price%3D121.1&
gv=171.3&
gc=usd 

Purchase confirmation page

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=purchase&
pagetype=purchase&
prodid=prod12345,prod2345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod2345%26q uantity%3D1%26price%3D121.1&
gv=171.3&
gc=usd 

Evento personalizzato con etichette definite dall'inserzionista
Custom labels like ea, ec, ev and el can be used to define custom remarketing lists and conversion events.

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=add_to_cart&
ec=shoes&
el=recommendations&
ev=23.99 

Dettagli dell'implementazione per il tag IMG