Die bluebarry-Suche kann ihre Suchen und Produktklicks an deine eigene Google-Analytics-4-Property senden. Sie nutzt dafür die Ereignisnamen von Google selbst, sodass sie in den Standardberichten von GA4 neben deinen übrigen Shopdaten erscheinen. Du trägst nur deine Mess-ID in bluebarry ein. Im Google Tag Manager ändert sich nichts.
Bevor du startest
- Die bluebarry-Suche ist in deinem Shop live, siehe Suche in deinem Shop live schalten.
- Du hast deine GA4-Mess-ID. Sie beginnt mit G- und steht in GA4 unter Admin → Data streams in deinem Webstream.
Mess-ID eintragen
- Geh in bluebarry zu Store data → Integrations und such unter Marketing & analytics die Karte Google Analytics 4.
- Gib deine ID unter Measurement ID ein, zum Beispiel
G-AB12CD34EF. - Klick auf Save.
Ab dann gehen Suchen und Produktklicks der bluebarry-Suche an diese Property. Um das zu beenden, leere das Feld und klick auf Save.
Ereignisse in GA4
| Ereignis | Gesendet, wenn |
|---|---|
| search | Jemand hat gesucht. Eine Live-Suche im Dropdown wird gesendet, sobald 1,5 Sekunden lang nicht mehr getippt wird. Eine Suche auf der Ergebnisseite wird sofort gesendet. |
| select_item | Jemand hat ein Produkt aus der bluebarry-Suche geöffnet. |
| Parameter | Bei | Inhalt |
|---|---|---|
| search_term | search, select_item | Was eingegeben wurde. |
| search_results | search | Wie viele Produkte insgesamt zur Suche passen. |
| search_source | search | live_search für das Dropdown beim Tippen, results_page für die vollständige Ergebnisseite. |
| item_list_name | select_item | Search suggestions für das kompakte Dropdown, Search results für das Ergebnisraster und die Ergebnisseite. |
| index | select_item | Die Position des Produkts in den Ergebnissen, beginnend bei 1. |
| item_id | select_item | Die eigene Produkt-ID deines Shops, dieselbe wie in deinen Ereignissen add_to_cart und purchase. |
- „s“, „sc“, „schuh“ zählt als eine Suche. Filtern, Sortieren oder Blättern in derselben Suche wird nicht noch einmal gesendet.
- bluebarry sendet kein eigenes add_to_cart. Dein Shop sendet es bereits, und GA4 ordnet es dem select_item davor zu. Dasselbe gilt für Käufe.
- bluebarry sendet auch kein view_search_results. Das erweiterte Messen von GA4 sendet es schon anhand der Adresse der Ergebnisseite, es würde also doppelt gezählt.
Suchparameter in GA4 registrieren
search_term kennt GA4 bereits. Damit du search_source und search_results in Berichten nutzen kannst, registrierst du sie einmal:
- Geh in GA4 zu Admin → Data display → Custom definitions.
- Klick auf Create custom dimension. Gib ihr einen Namen, zum Beispiel „Suchquelle“, setz den Bereich auf Event und trag
search_sourceals Ereignisparameter ein. Speichern. - Öffne den Tab Custom metrics und klick auf Create custom metric. Gib ihm einen Namen, zum Beispiel „Suchtreffer“, setz den Bereich auf Event und trag
search_resultsals Ereignisparameter ein. Speichern.
GA4 listet einen Parameter erst, wenn er einmal angekommen ist. Steht er noch nicht in der Liste, tipp den Namen selbst ein. Berichte zeigen die Werte ab dem Moment der Registrierung.
Wie die Ereignisse zu GA4 kommen
bluebarry nutzt das Google-Tag, das bereits in deinem Shop läuft. Hat die Seite keins, etwa weil dein Shopify-Shop GA4 über die App von Google selbst betreibt, lädt bluebarry das Google-Tag selbst. Dabei wird kein Seitenaufruf gesendet, deine Seitenaufrufe werden also nicht doppelt gezählt.
Ohne Mess-ID landen dieselben Ereignisse nur im dataLayer. Ein eigenes Google-Tag-Manager-Setup kann sie dort aufgreifen.
Cookie-Einwilligung
bluebarry folgt der Cookie-Einwilligung deines Shops. Hat jemand Analyse-Cookies nicht erlaubt, wird nichts gesendet. bluebarry liest die Einwilligung aus den Datenschutzeinstellungen von Shopify, der WP Consent API bei WooCommerce oder deiner eigenen Einwilligungsprüfung im bluebarry-Skript.
Testen
- Öffne deinen Shop in einem normalen Browserfenster und erlaube Analyse-Cookies.
- Such nach einem Produkt, warte kurz und öffne dann eines der Ergebnisse.
- Öffne in GA4 den Bericht Realtime oder DebugView. Dort sollten search und select_item ankommen.
Die Vorschau der Suche im Studio sendet nichts. Teste also in deinem Live-Shop.
Gut zu wissen
- Es funktioniert überall, wo die bluebarry-Suche läuft: Shopify, WooCommerce, Magento, CCV Shop und andere Shops.
- Testest du die bluebarry-Suche gegen die eigene Suche deines Shops? Die Gruppe jedes Besuchers geht als Nutzereigenschaft bluebarry_search an dieselbe Property, siehe bluebarry-Suche gegen die Suche deines Shops testen.
- Quiz-Ereignisse kommen über einen Google-Tag-Manager-Container in GA4 an, siehe Quizdaten an Google Analytics 4 senden.
- Umsatz aus der Suche, Suchen ohne Treffer und Top-Suchen siehst du auch in bluebarry selbst, siehe Suchanalysen lesen.