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 die JavaScript-Version des Verfolgungscodes des UET-Tags verwenden. SPA-Ereignisse werden mit derselben Syntax ausgelöst wie benutzerdefinierte Ereignisse: mit der Aktion 'page_view' und dem erforderlichen Parameter 'page_path' ('page_title' ist optional). Der Parameter 'page_path' muss mit '/' 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änderung: Lösen Sie ein SPA-Ereignis aus, sobald Ihre Anwendung dynamischen Inhalt 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 mit dem SPA-Ereignis „pageLoad“ verbunden (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ösen Sie ein SPA-Ereignis auf allen Seiten aus, einschließlich des ersten Ladens. Dieses Szenario ist mit dem vorherigen fast identisch, hier wird jedoch das automatische pageLoad-Ereignis 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 zudem das automatische Laden von Seiten. Dies erreichen Sie durch das Hinzufügen von 'disableAutoPageView: true' zu den Initialisierungsparametern. (Hinweis: Ändern Sie nicht direkt den Codeausschnitt, um dies zu deaktivieren.) Dies stimmt mit dem vorherigen Szenario überein, das SPA-Ereignis muss jedoch nicht beim ersten Laden der Seite zuerst ausgelöst werden. Die nachfolgenden SPA-Ereignisse müssen jedoch trotzdem ausgelöst werden, bevor damit verbundene benutzerdefinierte Ereignisse ausgelöst werden (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, Sie möchten auf Ihrer Webseite ein benutzerdefiniertes Ereignis verfolgen, das sich darauf bezieht, wann Besucher auf die Schaltfläche „Jetzt herunterladen“ auf einer Ihrer Webseiten klicken.

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 klicken Sie dann abhängig von Ihrem Browser auf Quellcode anzeigen oder auf Seitenquelltext anzeigen. Auf dieser Seite sehen Sie auch einige Schaltflächen. Durch Klicken auf eine 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.

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.

Es folgt ein Beispiel für das Übergeben des variablen Umsatzes für ein Ziel vom Typ „Ziel-URL“ auf PHP-Seiten. 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 Ereignisabschlussziele

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 ihn 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 diesen Parameter durch einen der folgenden Werte in der rechten Spalte dieser Tabelle, abhängig von der Seite, auf der Sie diesen JavaScript verwenden:

  Nachverfolgte dynamische Remarketing-Liste	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 klicken Sie dann abhängig von Ihrem Browser auf Quellcode anzeigen oder auf Seitenquelltext anzeigen. Auf dieser Seite können Sie auch eine Produkt-ID und einen Seitentyp definieren und dann auf eine Schaltfläche klicken, 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, Ereigniskategorie, 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 Zielgruppen-Targeting mit einer dynamischen Remarketing-Liste müssen Sie den folgenden Codeausschnitt 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>