UET (Rastreamento Universal de Eventos) usando uma marca IMG

UET (Rastreamento Universal de Eventos) usando uma marca IMG

Se você não puder usar a marcação UET baseada em JavasScript, poderá usar uma versão não baseada em JavaScript. Uma opção é usar uma marca IMG.

UET (Rastreamento Universal de Eventos)

O UET (Rastreamento Universal de Eventos) é uma estrutura da Microsoft que captura dados de envolvimento do usuário em seu site e habilita recursos como controle de conversão (por exemplo, compras ou clientes potenciais), direcionamento de público-alvo (por exemplo, remarketing), recuperação automática e Microsoft Advertising para comércio. Saiba mais sobre o UET e por que ele é importante para o controle de conversão e o remarketing na Microsoft Advertising.

É recomendável que você use a versão JavaScript da marca do UET e a instale em todas as páginas do seu site. As marcas UET do JavaScript capturam dados mais avançados para controle de conversão e remarketing. No entanto, se a marcação baseada em JavaScript não for viável, você poderá usar uma versão não baseada em JavaScript. Uma maneira de fazer isso é por meio de uma marca <img>.

Estrutura de eventos UET

A estrutura do UET define vários eventos:

• Carregamento de página: disparado em todas as visitas à página.
• Evento personalizado: disparado em eventos específicos e tipos de página e captura dados mais avançados.

Vários eventos UET podem ser disparados na mesma visita de página. A usa o parâmetro mid para conectar diferentes eventos disparados na mesma página.

A implementação de UET sem script tem esta aparência:

• Capture e salve msclkid em um cookie primário no seu site. Isso será compartilhado com todos os eventos pageLoad e personalizados.
• Entenda pageLoad e dispare-o em todas as exibições de página.
• Entenda a definição de evento personalizado e dispare-o em páginas específicas com os parâmetros necessários. Cada exibição de página terá apenas um pageLoad, mas poderá ter vários eventos personalizados.
• Alguns eventos personalizados precisarão ser disparados quando o usuário executar uma ação em vez de quando a página for carregada. Por exemplo, quando o usuário adicionar um produto a um carrinho, talvez a página não seja atualizada, e os detalhes do evento precisarão ser capturados depois da seleção do botão "Adicionar ao carrinho". Use um mecanismo apropriado para disparar esse evento UET.

Ponto de extremidade de API

O UET dispara este ponto de extremidade quando um evento é disparado: https://bat.bing.com/action/0?
A resposta esperada é: 204

Parâmetros a serem capturados

MSCLKID

MSCLKID é usado na atribuição de conversão e é gerado no momento do clique do anúncio. Essa ID é acrescentada à URL da página de aterrissagem quando a marcação automática da ID de clique da Microsoft estiver habilitada. Ela deve ser armazenada em um cookie de terceiros em seu site e enviada com a chamada à UET.

MSCLKID é um GUID, como "cdd4afcccb1c9a4cad9544dd7e5006d5".

Nome do cookie sugerido: _uetmsclkid

Expiração do cookie: 90 dias

Veja aqui um exemplo:

<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 permite unir eventos diferentes da mesma página, como pageLoad e eventos personalizados. Aqui está um exemplo de código usado para gerar 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>

Para obter uma lista completa de parâmetros que você pode capturar com pageLoad ou eventos personalizados, examine esta tabela.

Itens

Os itens capturam detalhes de produtos, como ID do produto, quantidade e preço. Eles são capturados em exibições de página e eventos que envolvam vários produtos, como o evento "adicionar ao carrinho" ou visitar a página do carrinho.

Exemplos de chamadas à API para diferentes eventos/páginas

Evento de carregamento de página

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  

Os eventos personalizados para cenários específicos de varejo
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 personalizado com rótulos definidos pelo anunciante
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 

Detalhes da implementação da marca IMG