Ausführliche Informationen zum Einrichten der universellen Ereignisnachverfolgung (UET)

Tag Manager-Programme ersetzen statische Tags durch dynamische Tags, die einfacher implementiert und aktualisiert werden können. Das dynamische Tag ist ein Container, ein kleiner Codeausschnitt, mit dem Sie Tags dynamisch in Ihre Website einfügen können. Stellen Sie sich das Container-Tag wie einen Bucket vor, der andere Arten von Tags enthält.

UET kann mit allen wichtigen Tag-Verwaltungssystemen verwendet werden. Es folgt die aktuelle Liste der getesteten und unterstützten Tag Manager-Programme (und Links zu entsprechenden Anweisungen):

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

UET ist so konzipiert, dass es mit allen wichtigen Website-Plattformen verwendet werden kann. Es folgt die aktuelle Liste der getesteten und unterstützten Plattformen (und Links zu entsprechenden Anweisungen), die das Installieren von UET-Tags zulassen:

• BigCommerce
• Shopify
• WordPress.com
• Wix

SPA-Websites müssen den JavaScript-UET-Tagverfolgungscode verwenden. Wenn Sie kürzlich Ihren UET-Nachverfolgungscode hinzugefügt haben, ist er möglicherweise bereits standardmäßig für die SPA-Nachverfolgung aktiviert. Um dies zu überprüfen, können Sie überprüfen, ob Ihr Tagausschnitt den folgenden fett formatierten Text enthält oder nicht:

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

Wenn Ihr Tagausschnitt den obigen Parameter nicht enthält und Sie die automatische SPA-Nachverfolgung verwenden möchten, können Sie zur Microsoft Advertising-Benutzeroberfläche wechseln und den neuen Ereignisausschnitt mit dem oben genannten Verhalten standardmäßig abrufen. Anschließend können Sie Ihre Website aktualisieren, um den neuen Codeausschnitt zu verwenden.

Sie können dieses Verhalten deaktivieren, wenn Sie SPA-Seitenansichten bereits manuell nachverfolgen. Ändern Sie dazu den Wert des enableAutoSpaTracking-Parameters in Ihrem Tagausschnitt in FALSCH. Sie können dies auch deaktivieren, wenn Ihre Website den Browserverlaufszustand nicht für die Navigation verwendet. Es wird jedoch empfohlen, sie aktiviert zu lassen, wenn Sie sich nicht sicher sind.

Ältere Anweisungen zum manuellen Nachverfolgen von SPA-Seitenansichten finden Sie unten:

SPA-Ereignisse werden mit der gleichen Syntax wie bei benutzerdefinierten Ereignissen ausgelöst, mit der Aktion 'page_view' und einem erforderlichen Parameter 'page_path' ('page_title' ist optional). Der Parameter 'page_path' muss mit einem '/' beginnen. Beispiel:

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

Es folgen drei Möglichkeiten zum Auslösen von SPA-Ereignissen. Beachten Sie bitte, dass wir die erste Möglichkeit empfehlen. Für jede Option ist eine Beispielwebseite vorhanden, die Sie aufrufen können, um den entsprechenden Code in Aktion zu sehen.

• Inhaltsänderungen: Lösen Sie ein SPA-Ereignis jedes Mal aus, wenn Ihre Anwendung dynamische Inhalte lädt. In diesem Fall wird die reale URL automatisch beim ersten Laden in einem standardmäßigen pageLoad-Ereignis gesendet. Sie können diese URL in Ihren Zielen vom Typ „Ziel-URL“ verwenden, und jedes benutzerdefinierte Ereignis, das auf dieser ersten Seite ausgelöst wird, wird diesem zugeordnet. Jedes SPA-Ereignis generiert ein pageLoad-Ereignis mit der SPA-URL, wobei es sich nicht um einen Pfad handeln muss, der tatsächlich geladen werden kann. Sie können auch in Ihren Zielen auf diese URLs verweisen. Jedes benutzerdefinierte Ereignis, das nach einem SPA-Ereignis ausgelöst wird, wird nur dem SPA-Ereignis „pageLoad“ zugeordnet (also nicht die ursprüngliche URL).
  • Besuchen Sie unsere Webseite mit dem Beispiel „Inhaltsänderung“, um diesen Code in Aktion zu sehen.
• Alle Seiten: Löst ein SPA-Ereignis auf allen Seiten aus, einschließlich des anfänglichen Ladens. Dieses Szenario ist mit dem vorherigen fast identisch, hier wird das automatische pageLoad-Ereignis jedoch nicht verwendet. Da es dennoch ausgelöst wird, müssen Sie Ihre Ereignisse so sortieren, dass das SPA-Ereignis vor allen anderen benutzerdefinierten Ereignissen ausgelöst wird. Wenn sie in einer anderen Reihenfolge ausgelöst werden, können einige oder sogar alle Ereignisse dem automatischen pageLoad-Ereignis (und der ursprünglichen URL) zugeordnet werden, anstatt dem SPA-Ereignis „pageLoad“ (und der SPA-URL einschließlich page_path).
  • Besuchen Sie unsere Webseite mit dem Beispiel „Alle Seiten“, um diesen Code in Aktion zu sehen.
• Alle Seiten, automatisch deaktiviert: Lösen Sie ein SPA-Ereignis auf allen Seiten aus, und deaktivieren Sie zusätzlich das automatische Laden von Seiten. Dies wird erreicht, indem den Initialisierungsparametern 'disableAutoPageView: true' hinzugefügt wird (Hinweis: Ändern Sie den Codeausschnitt nicht direkt zum Deaktivieren). Dies entspricht dem vorherigen Szenario, entfernt jedoch die Anforderung, dass das SPA-Ereignis zuerst beim ersten Laden der Seite ausgelöst werden muss. Nachfolgende SPA-Ereignisse müssen jedoch weiterhin vor benutzerdefinierten Ereignissen ausgelöst werden, die ihnen zugeordnet sind (oder sie werden dem vorherigen SPA-Ereignis zugeordnet).
  • Besuchen Sie unsere Webseite mit dem Beispiel „Alle Seiten, automatisch deaktiviert“, um diesen Code in Aktion zu sehen.

Nachdem Sie ein Abschlussziel für ein benutzerdefiniertes Ereignis oder eine Remarketing-Liste mit benutzerdefinierten Ereignissen erstellt haben (siehe So verfolgen Sie benutzerdefinierte Ereignisse mit UET nach), müssen Sie dem Verfolgungscode Ihres UET-Tags den JavaScript-Code für das benutzerdefinierte Ereignis hinzufügen. Angenommen, das benutzerdefinierte Ereignis, das Sie auf Ihrer Webseite nachverfolgen möchten, ist die Auswahl der Schaltfläche "Jetzt herunterladen" auf einer Ihrer Webseiten.

Ein Beispiel eines Verfolgungscodes des UET-Tags für ein benutzerdefiniertes Ereignis, das im Hauptteil einer Webseite installiert ist, finden Sie auf dieser Webseite (nur auf Englisch). Klicken Sie mit der rechten Maustaste auf die Webseite, und wählen Sie dann abhängig von Ihrem Browser Quellcode anzeigen oder Seitenquelltext anzeigen. Auf dieser Seite sehen Sie auch einige Schaltflächen. Durch Auswahl einer Schaltfläche wird ein benutzerdefiniertes Ereignis ausgelöst. Wenn Sie ein Überwachungstool eines Drittanbieters wie Fiddler verwenden, sehen Sie eine generierte HTTP-Anforderung für bat.bing.com zum Melden jedes benutzerdefinierten Ereignisses.

Beispiele für benutzerdefinierte E-Commerce-Ereignisse finden Sie unter Beispiele für benutzerdefinierte Ereignisse für E-Commerce-Kunden.

Nachdem Sie ein Abschlussziel für variable Umsätze erstellt haben (siehe So wird variabler Umsatz mit UET gemeldet), müssen Sie den UET-Verfolgungscode entsprechend bearbeiten.

Sehen wir uns an, wie Sie variablen Umsatz für ein Zielziel vom Typ "ZIEL-URL" auf PHP-Seiten übergeben. Im Beispiel unten wird ein dynamischer Wert für den variablen Umsatz aus einer JavaScript-Funktion gelesen. Sie können auch einfach einen statischen Wert senden oder aus einer JavaScript-Variablen oder einem HTML-Element lesen.

Wenn Sie den Code mit Ihrem Webseiten-Editor zu PHP-Seiten hinzufügen möchten, finden Sie unten ein Beispiel für den Verfolgungscode für das UET-Tag:

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

Erweitert: Codebeispiele für Ereigniskonvertierungsziele

Nun kennen Sie den Code, der am Ende des Verfolgungscodes für das UET-Tag für Abschlussziele vom Typ „Ziel-URL“ angefügt werden muss. Möglicherweise möchten Sie auch einige andere testen:

Ereignisabschlussziel

Wenn Sie variablen Umsatz für ein Ereignisabschlussziel melden möchten, muss ein anderer Code angefügt werden. Wenn Sie dieselbe JavaScript-Funktion wie in Schritt 2 verwenden, würde dies wie folgt aussehen:

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

Hinweis: Die vollständige Liste der Währungscodes finden Sie unter Währungen für den Umsatz von Abschlusszielen.

Nachdem Sie eine dynamische Remarketing-Liste erstellt haben (siehe Dynamische Remarketing-Listen: Remarketing für Produkte), müssen Sie dem Verfolgungscode Ihres UET-Tags benutzerdefinierte Parameter hinzufügen, um für die korrekte Funktionsweise zu sorgen.

Fügen Sie den folgenden JavaScript-Code in jede Seite Ihrer Website ein:

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

Ändern Sie im oben gezeigten JavaScript die folgenden Parameter:

• Replace_with_Product_ID : Ersetzen Sie dies durch eine der folgenden Produkt-IDs:
  • Die exakte SKU-ID, die ein Produkt eindeutig identifiziert. Sie wird manchmal auch UPC (Universal Product Code, Universaler Produktcode) genannt.
  • Eine Artikelgruppen-ID, die eine Gruppe von Variationen desselben Produkts darstellt (z. B. Optionen für Farbe oder Größe).

  Wichtig

  Die Produkt-ID in Ihrem JavaScript-Code muss mit einer ID in Ihrem Microsoft Merchant Center-Produktfeed übereinstimmen.

• Replace_with_Page_Type : Ersetzen Sie dies durch den folgenden Wert in der rechten Spalte dieser Tabelle, abhängig von der Seite, auf der Sie dieses JavaScript verwenden:

  Dynamische Remarketing-Liste, die Sie verfolgen	Erforderlicher Seitentyp
  Allgemeine Besucher	'ecomm_pagetype': 'home' 'ecomm_pagetype': 'category' 'ecomm_pagetype': 'other' Hinweis: Jeder Benutzer, der nicht im Seitentyp für Suchergebnisse, Produkt, Warenkorb oder Kauf enthalten ist, wird in die Zielgruppe der allgemeinen Besucher aufgenommen.
  Personen, die ein Produkt gesucht haben	'ecomm_pagetype': 'searchresults'
  Personen, die ein Produkt angesehen haben	'ecomm_pagetype': 'product'
  Personen, die den Einkaufswagen verlassen haben	'ecomm_pagetype': 'cart'
  Bisherige Käufer	'ecomm_pagetype': 'purchase'

  Hinweis: Kunden, die ein Produkt kaufen, werden der Liste „Bisherige Käufer“ hinzugefügt und aus anderen Listen entfernt (für dieses bestimmte Produkt). Hierzu muss das UET-Tag auf Ihrer Seite mit der Kaufbestätigung sowohl die Produkt-ID (ecomm_prodid) als auch den Seitentyp (ecomm_pagetype) senden.

Ein Beispiel für den Verfolgungscode eines UET-Tags für eine dynamische Remarketing-Liste, der im Hauptteil einer Webseite installiert ist, finden Sie auf dieser Webseite (nur auf Englisch). Klicken Sie mit der rechten Maustaste auf die Webseite, und wählen Sie dann abhängig von Ihrem Browser Quellcode anzeigen oder Seitenquelltext anzeigen. Auf dieser Seite können Sie auch eine Produkt-ID und einen Seitentyp definieren und dann eine Schaltfläche auswählen, um ein benutzerdefiniertes Ereignis für diese dynamische Remarketing-Liste auszulösen. Wenn Sie ein Überwachungstool eines Drittanbieters wie Fiddler verwenden, sehen Sie eine generierte HTTP-Anforderung für bat.bing.com zum Melden jedes benutzerdefinierten Ereignisses.

Wie in den vorigen Abschnitten erläutert, müssen Sie bei bestimmten Microsoft Advertising-Funktionen Ihrem vorhandenen UET-Tag einen JavaScript-Codeausschnitt hinzufügen und diesen bearbeiten:

• Benutzerdefinierte Ereignisse: Für Abschlussziele oder Remarketing-Listen, die auf benutzerdefinierten Ereignissen basieren, müssen Sie den folgenden Codeausschnitt so bearbeiten, dass die Ereignisaktion, die Ereigniskategorie, die Ereignisbezeichnung und/oder der Ereigniswert zurückgegeben werden:

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

• Variable Umsätze: Für Abschlussziele, mit denen variable Umsätze verfolgt werden, müssen Sie den folgenden Codeausschnitt so bearbeiten, dass der Umsatzwert und der Währungscode zurückgegeben werden:

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

• Dynamisches Remarketing: Für das Targeting mit einer dynamischen Remarketing-Liste müssen Sie den folgenden Ausschnitt so bearbeiten, dass die Produkt-ID und der Seitentyp zurückgegeben werden:

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

Wenn Sie mehrere dieser Funktionen implementieren, müssen Sie die folgenden Punkte beachten:

• Da jeder Codeausschnitt ein Ereignis sendet, wird empfohlen, den JavaScript-Codeausschnitt für jede Funktion im Code Ihrer Webseite getrennt einzufügen (verwenden Sie also separate Abschnitte <script > </script > ).
• Insbesondere ist es nicht möglich, die beiden folgenden Elemente auf derselben Webseite mit einem JavaScript-Codeausschnitt zu verfolgen:
  • Variable Umsätze für das Abschlussziel Ziel-URL
  • Benutzerdefinierte Ereignisse auf Basis eines Abschlussziels oder einer Remarketing-Liste

  In diesem Fall müssen Sie zwei separate Codeausschnitte in den Code Ihrer Webseite einfügen:

  • Codeausschnitt 1 — für variable Umsätze für das Abschlussziel „Ziel-URL“:

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

  • Codeausschnitt 2 — für benutzerdefinierte Ereignisse auf Basis eines Abschlussziels oder einer Remarketing-Liste. Wenn Sie jedoch variable Umsätze für ein Abschlussziel mit einem benutzerdefinierten Ereignis verfolgen ( nicht für ein Abschlussziel des Typs „Ziel-URL“), fügen Sie folgende Zeilen in den Codeausschnitt für das benutzerdefinierte Ereignis ein:

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