Bing UET Tag: Einrichtung und Hilfe

Laden Sie die Modul-ZIP unter Module > "Module Manager" hoch. Installieren Sie sie und öffnen Sie "Configure" für Bing UET Tag + Conversions API.

Rufen Sie Ihre numerische UET-Tag-ID aus Ihrem Microsoft-Advertising-Konto ab. Das Modul erstellt dort weder ein Tag noch Conversion-Ziele. Wählen Sie vor dem Speichern den gewünschten Shop.

Geben Sie UET-Tag-ID ein, aktivieren Sie Bing UET Tag aktivieren, wählen Sie Ihre Browserereignisse und speichern Sie. Die ID muss eine positive Zahl sein. Bei einer Neuinstallation ist Browsertracking bis zur Konfiguration deaktiviert.

Alle diese Felder befinden sich auf der Konfigurationsseite.

Die Einwilligungsintegration unterstützt MPR-Einwilligungsmodule und erkannte Zustände von Einwilligungsanbietern. Sie zeigt kein eigenes Einwilligungsbanner. Bei aktivem Marketing-Einwilligung beachten erlaubt eine fehlende unterstützte Einwilligungsentscheidung keinen Versand.

Der Tracker prüft außerdem Shop-Zuständigkeit und Richtlinien für ausgehendes Tracking. Mitarbeiter- und Opt-out-Signale können die Übermittlung verhindern. Beurteilen Sie Kundentracking nicht mit einem Browser, den das Modul als intern erkennt.

Diese Optionen sind bei einer Neuinstallation aus. Aktivieren Sie nur Signale, die Ihr Shop liefert.

Die Interaktionseinstellungen validieren Galerie-, Varianten- und Detailschwellen von 1 bis 20, Verweildauer von 5 bis 600 Sekunden und Optionsdrosselung von 250 bis 60000 ms. Lassen Sie das JSON leer für die Standardwerte.

Browser-UET und Conversions API werden getrennt aktiviert. Für Serverkäufe:

1. Lassen Sie Bing UET Tag aktivieren und Käufe erfassen aktiviert.
2. Aktivieren Sie "Capture durable buyer evidence", bevor Sie Ihre Testbestellung aufgeben.
3. Aktivieren Sie Conversions API aktivieren und geben Sie Conversions-API-Token ein.
4. Speichern Sie und prüfen Sie Bereitschafts- und Warteschlangenpanel.
5. Konfigurieren Sie den generierten Cron-Eintrag des Moduls im Zeitplaner Ihres Hostings.
6. Akzeptieren Sie Cookies in einer normalen Browsersitzung, geben Sie eine Bestellung als Kunde oder Gast auf und prüfen Sie dann, ob der Kauf in der Warteschlange erscheint.

Wird eine Bestellung angelegt, prüft das Modul Checkout-Sitzung und Einwilligung des Käufers, bevor es den Kauf in die Warteschlange aufnimmt. Ein Kauf ohne erfasste Käuferdaten wird zurückgehalten. Das Aktivieren von CAPI sendet also nicht jede Bestellung.

Das Endpunktmuster lautet:

https://capi.uet.microsoft.com/v1/{TAG_ID}/events

Die installierte Aufgabe ist send_bing_uet_conversions, geplant alle 300 Sekunden. Die Installation erstellt einen Cron-Eintrag über das gemeinsame Cron-Paket. Kopieren Sie Token und Befehl aus Ihrem installierten Modul. Ein typischer Serverbefehl lautet:

* * * * * php /var/www/html/modules/mprbinguet/cron.php --token=YOUR_TOKEN --max-seconds=300

Ersetzen Sie PHP-Pfad, Shop-Pfad und Token. Der Zeitplaner ruft den Runner auf; fällige Aufgaben verwenden ihren eigenen Fünf-Minuten-Zeitplan.

Das Warteschlangenpanel zeigt Ausstehend, Wird gesendet, Gesendet, Fehlgeschlagen, "Held", "Terminal" und "Suppressed". Verwenden Sie Fehlgeschlagene Events erneut versuchen, nachdem Sie den gemeldeten Fehler behoben haben. Zurückgehaltene und unterdrückte Events warten auf fehlende Käuferdaten oder wurden durch Einwilligung oder Richtlinie gestoppt; beheben Sie diese Ursache, statt erneut zu senden.

Testereignis senden sendet derzeit nichts: Es zeigt nur eine Meldung, dass der Microsoft-Testmodus nicht verfügbar ist. Um das Tracking zu prüfen, geben Sie eine Testbestellung auf, beobachten Sie die Warteschlange und nutzen Sie die Diagnosewerkzeuge Ihres Microsoft-Advertising-Kontos.

Dies ist eine optionale Einrichtung unter "Microsoft online refund and cancellation corrections".

Füllen Sie "Microsoft customer ID", "Microsoft account ID", "Developer token", "OAuth client ID", "OAuth client secret", "OAuth refresh token" und "Exact purchase conversion goal name" aus. Diese Felder sind zunächst leer. "Use Microsoft adjustments sandbox" ist zunächst aus.

Der Schalter "Enable online corrections" erscheint nur, wenn "Capture durable buyer evidence" aktiv ist, alle Microsoft-Zugangsdaten und der Name des Kaufziels ausgefüllt sind und für den Shop eine gespeicherte Verknüpfung zwischen Microsoft-Konto, UET-Tag und Kaufziel besteht. Die Einstellungsseite hat kein Feld, um diese Verknüpfung anzulegen. Bei einer Standardinstallation bleibt der Schalter daher verborgen, und Erstattungen und Stornierungen werden nicht an Microsoft gesendet.

Aktivieren Sie Benutzerdefinierte Ereignisse erfassen und geben Sie ein JSON-Array in Regeln für benutzerdefinierte Ereignisse ein. Ereignisnamen erlauben Buchstaben, Zahlen, Unterstriche und Bindestriche bis zu 64 Zeichen. Bis zu 15 unterschiedliche Namen und bis zu 30 konfigurierte Parameter pro Regel sind möglich. Das Modul sendet nur unterstützte UET-Parameternamen, darunter event_category, event_label, event_value, value, currency und E-Commerce-Artikelfelder.

Eine Klickregel:

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img, .images-container img","params":{"event_category":"Product","event_label":"Gallery browse"}}
]

Eine URL-Regel:

[
  {"event":"PromoPageView","trigger":"url","contains":["/promo/"],"params":{"event_category":"Campaign"}}
]

Eine Controller-Regel:

[
  {"event":"CheckoutPageView","trigger":"controller","controllers":["order"],"params":{"event_category":"Checkout"}}
]

Eine DOM-Ereignisregel:

[
  {"event":"QuoteRequest","trigger":"event","dom_event":"shop:quote-request","params":{"event_category":"Lead"}}
]

Ihr Theme kann das entsprechende Ereignis auslösen:

document.dispatchEvent(new CustomEvent('shop:quote-request', {
  detail: {params: {event_label: 'Product page quote button'}}
}));

Verwenden Sie diese konfigurierten Regeln für eigene Aufrufe. Das Modul bietet den alten Helfer window.mprbinguetTrack nicht und liest die alten Attribute data-mprbinguet-param-* nicht. URL-, Controller- und DOM-Regeln werden standardmäßig einmal pro Seite ausgelöst, Klickregeln wiederholt. Setzen Sie bei Bedarf den Regelwert once explizit.

Prüfen Sie das Bereitschaftspanel nach jeder Konfigurationsänderung. Prüfen Sie Tag-ID, Browsertracking, Einwilligung, eigene Regeln und CAPI-Zustand.

Verwenden Sie einen separaten Kundenbrowser. Erteilen Sie die erforderliche Einwilligung, öffnen Sie ein Produkt und prüfen Sie im Netzwerkprotokoll das Microsoft-UET-Skript unter bat.bing.com/bat.js und die gewählten Ereignisse. Verweigern Sie die Einwilligung in einem neuen Test und bestätigen Sie, dass das Tracking bei aktiviertem Einwilligungsschutz unterbleibt.

Testen Sie einen erfolgreichen Warenkorb- und Wunschlistenzugang. Eine fehlgeschlagene Aktion darf kein bestätigtes E-Commerce-Ereignis werden. Verwendet Ihr Theme oder Checkout eigene Ereignisse, prüfen Sie, ob es das unterstützte Erfolgssignal liefert.

Vergleichen Sie bei Käufen Transaktionsreferenz, Wertrichtlinie, Währung und Artikel mit der Bestellung. Prüfen Sie Serverwarteschlange und Protokolle sowie die Browseranfragen. Microsoft entscheidet, welche Conversions es annimmt und berichtet; prüfen Sie die Ergebnisse daher auch in Ihrem Microsoft-Advertising-Konto.

Lädt kein Tag, prüfen Sie Hauptschalter, positive numerische ID, Einwilligung, Mitarbeiterausschluss, Opt-out-Zustand und Shop-Zuständigkeitsrichtlinie. Prüfen Sie danach Skriptblocker und Browserfehler. Bleibt CAPI ausstehend, prüfen Sie den Cron-Runner. Wird es zurückgehalten, prüfen Sie, ob der Käufer eingewilligt hat und seine Checkout-Daten erfasst wurden. Bei Fehlern prüfen Sie Token und Antwort vor einem erneuten Versuch.

Deaktivieren Sie Browser- und Servertracking, wenn Sie die Erfassung nur pausieren möchten. Sichern Sie vor der Deinstallation benötigte Einstellungen und Übermittlungsnachweise. Die Deinstallation entfernt Modulmenü, geplante Aufgabe und Konfiguration. Die gemeinsame Conversion-Warteschlangentabelle wird nur gelöscht, wenn kein anderes Modul das Conversions-Paket nutzt; Warteschlangendaten können bestehen bleiben, wenn ein anderer Nutzer die gemeinsame Tabelle erhält.

Erfordert PrestaShop 1.6.0.0 oder neuer und PHP 7.1 oder neuer.