Les événements dans votre GTM/GA4
Refléter l'activité de la recherche vers l'analytics de la boutique elle-même, avec le tableau des événements et le conteneur prêt à importer.
À partir du forfait Pro, le panneau de recherche peut refléter l'activité de la recherche vers l'analytics de la boutique elle-même. Cela s'active à deux endroits, et les deux sont nécessaires : le forfait avec la fonctionnalité, et l'interrupteur « Envoyer les événements vers l'analytics de la boutique (GTM / GA4) » sur la fiche de la boutique. Si l'un des deux est désactivé, le dataLayer de la boutique reste exactement comme il était.
Chaque événement est livré deux fois à la page elle-même, comme CustomEvent du navigateur (buskara:search) et comme push vers le dataLayer (buskara_search), et rien ne sort de la page de soi-même : ce chemin n'écrit pas de cookies et ne charge pas de scripts. C'est votre Tag Manager qui décide ce qui part vers GA4, et avec quel consentement.
Les événements
| Événement | Quand il se déclenche | Paramètres |
|---|---|---|
buskara_open |
le panneau de recherche s'ouvre | aucun |
buskara_search |
une recherche aboutit (pas à chaque frappe) | search_term, results, search_id |
buskara_result_click |
clic sur un résultat | item_id, item_name, price, brand, index, search_term, search_id |
buskara_add_to_cart |
un ajout au panier dans une session qui a cherché : le bouton de la recherche, l'assistant, ou le bouton de la boutique elle-même après une recherche | item_id, item_name, price, brand, quantity, search_term, search_id |
buskara_similar_open |
le panneau des produits similaires s'ouvre | item_id, item_name, search_term, search_id |
buskara_quiz_* |
chaque étape de l'assistant (start, answer, back, product_click, handoff, chat_message, checkout, …) |
type, slug, step + les extras de l'étape |
À propos de buskara_search : le panneau de recherche attend que la saisie aboutisse avant d'émettre. Écrire « écouteurs » produit une douzaine de recherches intermédiaires et seule la dernière est celle que la personne voulait ; GA n'a aucun moyen de rétracter un événement déjà envoyé.
Brancher en trois étapes
- Téléchargez le conteneur GTM prêt à l'emploi dans le panneau et importez-le dans Tag Manager : il apporte les variables, les déclencheurs et les tags GA4 déjà montés. Si vous préférez, suivez le pas à pas ici : La recherche de la boutique dans Google Analytics.
- Ouvrez la variable « Buskara - GA4 Measurement ID » et remplacez le placeholder par votre Measurement ID (GA4 : Admin → Data Streams).
- Dans Preview, faites une recherche sur la boutique et vérifiez que les événements arrivent ; ensuite Submit.
Sans Tag Manager, les CustomEvent remplissent le même rôle en quelques lignes :
document.addEventListener('buskara:search', function (e) {
gtag('event', 'buskara_search', e.detail);
});
Trois notes importantes
- Le zéro est une valeur. Un rapport de
buskara_searchavecresults = 0est la liste de ce que les visiteurs cherchent et ne trouvent pas. Il alimente les décisions d'achat, les synonymes et les règles. search_idrelie les deux mondes. C'est le même identifiant que celui utilisé par le panneau, ce qui permet de confronter les chiffres de GA à ceux du panneau.- Le consentement est le vôtre. Les tags importés arrivent sans état de consentement défini ; le gating se fait dans les règles de votre propre conteneur, comme pour n'importe quel autre tag.
Et Microsoft Clarity
Si la boutique utilise déjà Microsoft Clarity, il y a un second interrupteur sur la fiche de la boutique, « Envoyer les événements vers Microsoft Clarity », avec sa propre fonctionnalité de forfait (également à partir du Pro).
Une fois activé, le panneau de recherche livre les mêmes événements buskara_* au Clarity qu'il trouve sur la page, et marque chaque session avec deux tags, buskara_search_term et buskara_item_name, ce qui sert là-bas à filtrer les enregistrements et les cartes de chaleur par ce que les gens ont cherché. Voir une demi-douzaine d'enregistrements de sessions qui ont cherché un terme et sont reparties sans cliquer vaut bien des rapports.
Deux notes : Clarity ne reçoit pas de paramètres dans les événements (cela vient de l'outil, pas de nous), d'où les tags ; et le panneau de recherche ne charge jamais le script de Clarity, donc sans lui sur la page l'interrupteur ne fait rien.
Les deux interrupteurs sont indépendants : vous pouvez refléter seulement vers GTM, seulement vers Clarity, ou vers les deux.