Die Ereignisse in Ihrem GTM/GA4
Die Aktivität der Suche in das Analytics des Shops spiegeln, mit der Ereignistabelle und dem fertig importierbaren Container.
Ab dem Pro-Tarif kann das Suchpanel die Aktivität der Suche in das Analytics des Shops selbst spiegeln. Das schaltet sich an zwei Stellen ein, und beide sind nötig: der Tarif mit der Funktion, und der Schalter „Ereignisse an das Analytics des Shops senden (GTM / GA4)“ in den Shop-Einstellungen. Ist eines von beiden aus, bleibt der dataLayer des Shops genau so, wie er war.
Jedes Ereignis wird der Seite selbst zweimal übergeben, als CustomEvent des Browsers (buskara:search) und als Push in den dataLayer (buskara_search), und von sich aus verlässt nichts die Seite: dieser Weg schreibt keine Cookies und lädt keine Skripte. Wer entscheidet, was an GA4 weitergeht und mit welcher Einwilligung, ist Ihr Tag Manager.
Die Ereignisse
| Ereignis | Wann es auslöst | Parameter |
|---|---|---|
buskara_open |
das Suchpanel öffnet sich | keine |
buskara_search |
eine Suche kommt zustande (nicht bei jedem Tastendruck) | search_term, results, search_id |
buskara_result_click |
Klick auf ein Ergebnis | item_id, item_name, price, brand, index, search_term, search_id |
buskara_add_to_cart |
eine Hinzufügung zum Warenkorb in einer Sitzung, die gesucht hat: der Button der Suche, der Assistent, oder der Button des Shops selbst nach einer Suche | item_id, item_name, price, brand, quantity, search_term, search_id |
buskara_similar_open |
das Panel der ähnlichen Produkte öffnet sich | item_id, item_name, search_term, search_id |
buskara_quiz_* |
jeder Schritt des Assistenten (start, answer, back, product_click, handoff, chat_message, checkout, …) |
type, slug, step + Extras des Schritts |
Zum buskara_search: das Suchpanel wartet, bis die Eingabe zur Ruhe kommt, bevor es sendet. „Kopfhörer“ zu tippen erzeugt ein Dutzend Zwischensuchen, und nur die letzte ist die, die die Person wollte; GA hat keine Möglichkeit, ein bereits gesendetes Ereignis zurückzunehmen.
In drei Schritten anschließen
- Lade den fertigen GTM-Container im Panel herunter und importiere ihn in den Tag Manager: er bringt die Variablen, die Trigger und die GA4-Tags schon fertig mit. Wenn Ihnen das lieber ist, folge hier der Anleitung Schritt für Schritt: Die Suche des Shops in Google Analytics.
- Öffne die Variable „Buskara - GA4 Measurement ID“ und ersetze den Platzhalter durch Ihre Measurement ID (GA4: Admin → Data Streams).
- Suche im Preview im Shop und prüfe, ob die Ereignisse ankommen; danach Submit.
Ohne Tag Manager erfüllen die CustomEvent denselben Zweck mit wenigen Zeilen:
document.addEventListener('buskara:search', function (e) {
gtag('event', 'buskara_search', e.detail);
});
Drei wichtige Hinweise
- Die Null ist ein Wert. Ein Bericht über
buskara_searchmitresults = 0ist die Liste dessen, was die Besucher suchen und nicht finden. Er speist Einkaufsentscheidungen, Synonyme und Regeln. search_idverbindet die beiden Welten. Es ist dieselbe Kennung, die das Panel benutzt, womit sich die Zahlen aus GA mit denen des Panels abgleichen lassen.- Die Einwilligung liegt bei Ihnen. Die importierten Tags kommen ohne festgelegten Einwilligungsstatus; das Gating passiert in den Regeln Ihres eigenen Containers, wie bei jedem anderen Tag.
Und Microsoft Clarity
Wenn der Shop schon Microsoft Clarity benutzt, gibt es in den Shop-Einstellungen einen zweiten Schalter, „Ereignisse an Microsoft Clarity senden“, mit eigener Tarif-Funktion (ebenfalls ab Pro).
Eingeschaltet übergibt das Suchpanel dieselben buskara_*-Ereignisse an das Clarity, das es auf der Seite findet, und markiert jede Sitzung mit zwei Tags, buskara_search_term und buskara_item_name, womit sich dort Aufzeichnungen und Heatmaps nach dem filtern lassen, was die Leute gesucht haben. Ein halbes Dutzend Aufzeichnungen von Sitzungen zu sehen, die einen Begriff gesucht haben und ohne Klick gegangen sind, ist mehr wert als viele Berichte.
Zwei Hinweise: Clarity empfängt keine Parameter in den Ereignissen (das liegt am Werkzeug, nicht an uns), daher die Tags; und das Suchpanel lädt das Clarity-Skript nie, ohne es auf der Seite tut der Schalter also nichts.
Die beiden Schalter sind unabhängig: Sie können nur an GTM spiegeln, nur an Clarity, oder an beide.