De zoekfunctie van bluebarry kan zoekopdrachten en productklikken naar je eigen Google Analytics 4-property sturen. Ze gebruikt daarvoor de eventnamen van Google zelf, zodat ze in de standaardrapporten van GA4 verschijnen naast de rest van je webshopdata. Je vult alleen je meet-ID in bij bluebarry. In Google Tag Manager verandert niets.
Voordat je begint
- De zoekfunctie van bluebarry staat live in je webshop, zie De zoekfunctie live zetten in je webshop.
- Je hebt je GA4-meet-ID bij de hand. Die begint met G- en staat in GA4 onder Admin → Data streams, in je webstream.
Vul je meet-ID in
- Ga in bluebarry naar Store data → Integrations en zoek de kaart Google Analytics 4 onder Marketing & analytics.
- Vul je ID in bij Measurement ID, bijvoorbeeld
G-AB12CD34EF. - Klik op Save.
Vanaf dat moment gaan zoekopdrachten en productklikken in de zoekfunctie van bluebarry naar die property. Wil je stoppen, maak het veld dan leeg en klik op Save.
Events die je in GA4 krijgt
| Event | Verstuurd wanneer |
|---|---|
| search | Een klant heeft gezocht. Een livezoekopdracht in de dropdown wordt verstuurd zodra de klant 1,5 seconde niet meer typt. Een zoekopdracht op de resultatenpagina wordt meteen verstuurd. |
| select_item | Een klant opende een product vanuit de zoekfunctie van bluebarry. |
| Parameter | Bij | Wat erin staat |
|---|---|---|
| search_term | search, select_item | Wat de klant typte. |
| search_results | search | Hoeveel producten in totaal bij de zoekopdracht passen. |
| search_source | search | live_search voor de dropdown tijdens het typen, results_page voor de volledige resultatenpagina. |
| item_list_name | select_item | Search suggestions voor de compacte dropdown, Search results voor het resultatenraster en de resultatenpagina. |
| index | select_item | De positie van het product in de resultaten, vanaf 1. |
| item_id | select_item | Het eigen product-ID van je webshop, hetzelfde als in je events add_to_cart en purchase. |
- ‘s’, ‘sc’, ‘schoen’ typen telt als één zoekopdracht. Filteren, sorteren of bladeren binnen dezelfde zoekopdracht wordt niet opnieuw verstuurd.
- bluebarry stuurt geen eigen add_to_cart. Je webshop stuurt die al, en GA4 koppelt die aan de select_item ervoor. Hetzelfde geldt voor aankopen.
- bluebarry stuurt ook geen view_search_results. De uitgebreide meting van GA4 stuurt die al op basis van het adres van de resultatenpagina, dus anders telt hij dubbel.
Registreer de zoekparameters in GA4
search_term kent GA4 al. Om search_source en search_results in je rapporten te gebruiken, registreer je ze één keer:
- Ga in GA4 naar Admin → Data display → Custom definitions.
- Klik op Create custom dimension. Geef hem een naam, bijvoorbeeld ‘Zoekbron’, zet het bereik op Event en vul
search_sourcein als eventparameter. Sla op. - Open het tabblad Custom metrics en klik op Create custom metric. Geef hem een naam, bijvoorbeeld ‘Zoekresultaten’, zet het bereik op Event en vul
search_resultsin als eventparameter. Sla op.
GA4 toont een parameter pas in de lijst als die een keer is binnengekomen. Staat hij er nog niet, typ de naam dan zelf in. Rapporten tonen de waarden vanaf het moment dat je ze registreert.
Hoe de events in GA4 komen
bluebarry gebruikt de Google-tag die al op je webshop draait. Heeft de pagina er geen, bijvoorbeeld omdat je Shopify-winkel GA4 via de app van Google zelf draait, dan laadt bluebarry de Google-tag zelf. Daarbij wordt geen paginaweergave verstuurd, dus je paginaweergaven tellen niet dubbel.
Zonder meet-ID komen dezelfde events alleen in de dataLayer terecht. Een eigen Google Tag Manager-opzet kan ze daar oppakken.
Cookietoestemming
bluebarry volgt de cookietoestemming van je webshop. Heeft een klant analytische cookies niet toegestaan, dan wordt er niets verstuurd. bluebarry leest de toestemming uit de privacy-instellingen van Shopify, de WP Consent API op WooCommerce of je eigen toestemmingscheck in het bluebarry-script.
Test het
- Open je webshop in een gewoon browservenster en sta analytische cookies toe.
- Zoek een product, wacht even en open dan een van de resultaten.
- Open in GA4 het rapport Realtime of DebugView. Daar zie je search en select_item binnenkomen.
De voorbeeldweergave van de zoekfunctie in Studio verstuurt niets. Test dus op je live webshop.
Goed om te weten
- Het werkt overal waar de zoekfunctie van bluebarry draait: Shopify, WooCommerce, Magento, CCV Shop en andere webshops.
- Test je de zoekfunctie van bluebarry tegen de eigen zoekfunctie van je webshop? De groep van elke bezoeker gaat als gebruikerseigenschap bluebarry_search naar dezelfde property, zie Test de zoekfunctie van bluebarry tegen die van je webshop.
- Quizevents gaan via een Google Tag Manager-container naar GA4, zie Quizdata naar Google Analytics 4 sturen.
- Omzet uit zoeken, zoekopdrachten zonder resultaat en populaire zoekopdrachten zie je ook in bluebarry zelf, zie Zoekanalyses lezen.