Universelle Ereignisnachverfolgung (Universal Event Tracking, UET) mithilfe eines IMG-Tags

Wenn Sie kein JavaScript-basiertes UET-Tagging verwenden können, können Sie eine Nicht-JavaScript-basierte Version verwenden. Eine Option ist die Verwendung eines IMG-Tags.

Wichtig

Es wird empfohlen, die JavaScript-Version des UET-Tags zu verwenden, wenn dies möglich ist. Erfahren Sie mehr über das JavaScript-UET-Tag.

Universelle Ereignisnachverfolgung (Universal Event Tracking, UET)

Die universelle Ereignisnachverfolgung (Universal Event Tracking, UET) ist ein Microsoft-Framework, das Benutzerbindungsdaten auf Ihrer Website erfasst und Features wie Abschlussnachverfolgung (z. B. Einkäufe oder Leads), Zielgruppen-Targeting (z. B. Remarketing), automatisches Bieten und Microsoft Advertising für den Handel ermöglicht. Erfahren Sie mehr über UET und warum es für die Abschlussnachverfolgung und das Erneute Remarketing in Microsoft Advertising wichtig ist.

Es wird empfohlen, die JavaScript-Version des UET-Tags zu verwenden und auf allen Seiten Ihrer Website zu installieren. JavaScript-UET-Tags erfassen umfangreichere Daten für die Abschlussnachverfolgung und das Remarketing. Wenn JavaScript-basiertes Tagging jedoch nicht möglich ist, können Sie eine Nicht-JavaScript-basierte Version verwenden. Eine Möglichkeit dazu ist über ein <img>-Tag.

UET-Ereignisframework

Das UET-Framework definiert mehrere Ereignisse:

Laden der Seite: Wird bei allen Seitenbesuchen ausgelöst.
Benutzerdefiniertes Ereignis: Wird für bestimmte Ereignisse und Seitentypen ausgelöst und erfasst umfangreichere Daten.

Bei einem Seitenaufruf können mehrere UET-Ereignisse ausgelöst werden. verwendet den mid-Parameter, um verschiedene Ereignisse zu verbinden, die auf derselben Seite ausgelöst werden.

Die Implementierung von UET ohne Skript sieht wie folgt aus:

Erfassen und speichern Sie msclkid in einem Erstanbietercookie auf Ihrer Website. Dies wird für alle pageLoad- und benutzerdefinierten Ereignisse freigegeben.
Sie müssen die pageLoad-Ereignisdefinition verstehen und für alle Seitenaufrufe auslösen.
Sie müssen die benutzerdefinierte Ereignisdefinition verstehen und sie auf bestimmten Seiten it den erforderlichen Parametern auslösen. Jede Seitenansicht hat nur ein pageLoad-Ereignis, aber möglicherweise mehrere benutzerdefinierte Ereignisse.
Einige benutzerdefinierte Ereignisse müssen ausgelöst werden, wenn der Benutzer eine Aktion ausführt und nicht wenn die Seite geladen wird. Wenn der Benutzer beispielsweise ein Produkt zu einem Warenkorb hinzufügt, wird die Seite möglicherweise nicht aktualisiert, und die Ereignisdetails müssen erfasst werden, nachdem er die Schaltfläche „Zum Warenkorb hinzufügen“ ausgewählt hat. Verwenden Sie einen geeigneten Mechanismus, um dieses UET-Ereignis auszulösen.

API-Endpunkt

UET löst diesen Endpunkt aus, wenn ein Ereignis ausgelöst wird: https://bat.bing.com/action/0?
Die erwartete Antwort lautet: 204

Zu erfassende Parameter

MSCLKID

MSCLKID wird in der Konvertierungszuordnung verwendet und zum Zeitpunkt des Anzeigenklicks generiert. Diese ID wird an die URL der Zielseite angefügt, wenn das Auto-Tagging der Microsoft Klick-ID aktiviert ist. Sie sollte in einem Erstanbietercookie auf Ihrer Website gespeichert und mit dem UET-Anruf gesendet werden.

MSCLKID ist eine GUID, z. B. "cdd4agh1c9a4cad9544dd7e5006d5".

Vorgeschlagener Cookie-Name: _uetmsclkid

Cookie-Ablauf: 90 Tage

Hier ein Beispiel:

<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 ermöglicht das Verknüpfen verschiedener Ereignisse von derselben Seite, z. B. pageLoad und benutzerdefinierte Ereignisse. Hier ist ein Beispiel für Code, der zum Generieren von MID verwendet wird:

<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>

Eine vollständige Liste der Parameter, die Sie mit pageLoad oder benutzerdefinierten Ereignissen erfassen können, finden Sie in dieser Tabelle.

Elemente

Elemente erfassen Details zu Produkten wie Produkt-ID, Menge und Preis. Sie werden in Seitenaufrufen und Ereignissen erfasst, die mehrere Produkte betreffen, z. B. das Ereignis „Zum Warenkorb hinzufügen“ oder der Besuch der Warenkorbseite.

Führen Sie zum Hinzufügen mehrerer Produkte die folgenden Schritte aus:

Erstellen Sie eine durch Trennzeichen getrennte Liste, damit verschiedene Elemente erfasst werden können. Zum Beispiel die Produkt-IDs 12345 und 23456: id=prod12345&quantity=2&price=25.1,id=prod23456&quantity=1&price=121.1
URL codiert die gesamte Zeichenfolge: id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod23456%26quantity%3D1%26price%3D121.1
Fügen Sie sie als Wert für den Parameter 'items': items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod23456%2 6quantity%3D1%26price%3D121.1

Beispiele für API-Aufrufe für verschiedene Ereignisse/Seiten

PageLoad-Ereignis

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

Benutzerdefinierte Ereignisse für einzelhandelsspezifische Szenarien
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

Benutzerdefiniertes Ereignis mit von Werbekunden definierten Bezeichnungen
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

Implementierungsdetails für IMG-Tag

Sie können ein Microsoft Advertising UET-Tag als Bildpixel mit einer Größe von 0 auslösen.

Ein UET-Tag kann an einer beliebigen Stelle auf der Seite hinzugefügt werden. Eine Beispielimplementierung innerhalb des Head-Tags ist unten dargestellt:

<head>
<title>UET IMG based example</title>
<meta charset="utf-8" />
<!--BEGIN: Microsoft Advertising UET tag.-->
<img src="//bat.bing.com/action/0?ti=1234567&
ver=2.3&
evt=pageLoad&
mid=d34f6979-ecfc-ecac745d-e40447afd9b2&
uid=3966616149922&
vid= a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
p= ttps%3A%2F%2Fwww.contoso.com%2Fsearch%3Fq%3Dwall%2Bclock&
r=https%3A%2F%2Fwww.bing.com%2F&
tl= Wall%20Clocks&
kw=clocks,homedecor" height="0" width="0" style="display:none; visibility: hidden;" />
<!--END: Microsoft Advertising UET tag-->
<link href="StyleSheet/styles.css" rel="stylesheet">
</head>

Beim Laden der Seite wird das UET-Tag ausgelöst, was zu einer HTTPS-Anforderung führt. Diese Anforderung wird an die Domäne "bat.bing.com" gesendet, und die URL enthält die erforderlichen Parameter für Microsoft Advertising.