Los eventos en su GTM/GA4
Reflejar la actividad de la búsqueda en el analytics de la propia tienda, con la tabla de los eventos y el container listo para importar.
A partir del plan Pro, el panel de búsqueda puede reflejar la actividad de la búsqueda en el analytics de la propia tienda. Se activa en dos sitios, y hacen falta los dos: el plan con la funcionalidad, y el interruptor «Enviar eventos al analytics de la tienda (GTM / GA4)» en la ficha de la tienda. Con cualquiera de los dos apagado, el dataLayer de la tienda se queda exactamente como estaba.
Cada evento se entrega dos veces a la propia página, como CustomEvent del navegador (buskara:search) y como push al dataLayer (buskara_search), y nada sale de la página por sí solo: este camino no escribe cookies ni carga scripts. Quien decide lo que sigue hacia GA4, y con qué consentimiento, es su Tag Manager.
Los eventos
| Evento | Cuándo dispara | Parámetros |
|---|---|---|
buskara_open |
el panel de búsqueda abre | ninguno |
buskara_search |
una búsqueda se asienta (no en cada tecla) | search_term, results, search_id |
buskara_result_click |
clic en un resultado | item_id, item_name, price, brand, index, search_term, search_id |
buskara_add_to_cart |
una adición al carrito en una sesión que buscó: el botón de la búsqueda, el asistente, o el botón de la propia tienda después de una búsqueda | item_id, item_name, price, brand, quantity, search_term, search_id |
buskara_similar_open |
el panel de similares abre | item_id, item_name, search_term, search_id |
buskara_quiz_* |
cada paso del asistente (start, answer, back, product_click, handoff, chat_message, checkout, …) |
type, slug, step + extras del paso |
Sobre buskara_search: el panel de búsqueda espera a que la escritura se asiente antes de emitir. Escribir «auriculares» produce una docena de búsquedas intermedias y solo la última es la que la persona quiso; GA no tiene forma de retractarse de un evento ya enviado.
Conectar en tres pasos
- Descargue el container GTM listo en el panel e impórtelo en Tag Manager: trae las variables, los triggers y las tags GA4 ya montados. Si lo prefieres, sigue el paso a paso aquí: La búsqueda de la tienda en Google Analytics.
- Abra la variable «Buskara - GA4 Measurement ID» y cambie el placeholder por su Measurement ID (GA4: Admin → Data Streams).
- En Preview, busca en la tienda y confirma que los eventos llegan; después Submit.
Sin Tag Manager, los CustomEvent sirven al mismo propósito con pocas líneas:
document.addEventListener('buskara:search', function (e) {
gtag('event', 'buskara_search', e.detail);
});
Tres notas importantes
- El cero es un valor. Un informe de
buskara_searchconresults = 0es la lista de lo que los visitantes buscan y no encuentran. Alimenta decisiones de compra, sinónimos y reglas. search_idcruza los dos mundos. Es el mismo identificador que usa el panel, lo que permite confrontar los números de GA con los del panel.- El consentimiento es suyo. Las tags importadas vienen sin estado de consentimiento definido; el gating se hace en las reglas de su propio container, como con cualquier otra tag.
Y Microsoft Clarity
Si la tienda ya usa Microsoft Clarity, hay un segundo interruptor en la ficha de la tienda, «Enviar eventos a Microsoft Clarity», con funcionalidad de plan propia (también a partir del Pro).
Con él activado, el panel de búsqueda entrega los mismos eventos buskara_* al Clarity que encuentre en la página, y marca cada sesión con dos tags, buskara_search_term y buskara_item_name, que es lo que allí dentro sirve para filtrar grabaciones y mapas de calor por lo que la gente buscó. Ver media docena de grabaciones de sesiones que buscaron un término y salieron sin hacer clic vale por muchos informes.
Dos notas: Clarity no recibe parámetros en los eventos (es cosa de la herramienta, no nuestra), de ahí las tags; y el panel de búsqueda nunca carga el script de Clarity, así que sin él en la página el interruptor no hace nada.
Los dos interruptores son independientes: puede reflejar solo hacia GTM, solo hacia Clarity, o hacia los dos.