Události pro Google Analytics

Pokud na svém webu používáte Google Analytics 4 (GA4), AI prodavač i AI vyhledávání do něj automaticky posílají události (eventy). Posílají je jen u návštěvníků, kteří souhlasili s analytickými cookies (viz Souhlas s cookies). Pokud GA4 běží přes Google tag (gtag.js), nic dalšího nastavovat nemusíte. Pokud používáte jen Google Tag Manager, podívejte se níže na Google Tag Manager. Názvy všech událostí začínají na yasan_, takže je snadno najdete.

Pokud na webu Google Analytics nemáte, nic se neposílá a oba widgety fungují jako obvykle.

Google Tag Manager#

Pokud máte na webu Google Tag Manager, ale ne Google tag (gtag.js), widgety vkládají události do datové vrstvy Tag Manageru (dataLayer). Do GA4 je Tag Manager předá, až když mu to nastavíte:

Vytvořte aktivátor typu Vlastní událost, do Název události zadejte ^yasan_ a zaškrtněte Použít shodu regulárního výrazu.
Vytvořte značku Google Analytics: Událost GA4 s vaším ID měření, do Název události zadejte {{Event}} a nastavte ji na tento aktivátor.
Pro každý parametr, který chcete mít v GA4 (například product_id nebo position), vytvořte proměnnou datové vrstvy se stejným názvem a přidejte ji mezi parametry události ve značce.
Kontejner publikujte.

Souhlas s cookies#

Souhlas se kontroluje dvakrát:

Widgety posílají události jen u návštěvníků, kteří souhlasili s analytickými cookies. Widget musí volbu návštěvníka znát: na Shoptetu si ji přečte z cookie lišty Shoptetu automaticky, na ostatních platformách mu ji předejte přes window.Whisper.setConsent, jak popisuje článek Nastavení souhlasu s cookies. Dokud widget neví, že návštěvník souhlasil, do Google Analytics se nic neposílá.
Google Analytics pak uplatní svůj vlastní režim souhlasu (Consent Mode), stejně jako u zbytku vašeho webu: v pokročilém režimu bez souhlasu zaznamená jen anonymní signály bez cookies, v základním režimu se do Googlu nic neposílá, dokud návštěvník nesouhlasí.

Co posíláme a co ne#

Nikdy neposíláme text zpráv, hledané výrazy, e‑mailové adresy ani jiné osobní údaje. Události říkají jen to, co se stalo, a k tomu údaje jako ID a název produktu, pozici produktu v seznamu nebo počet zobrazených produktů.

Každá událost nese parametr yasan_widget: chatbot pro AI prodavače, search pro AI vyhledávání.

Události AI prodavače#

Událost	Kdy se odešle	Parametry
`yasan_chatbot_loaded`	Chat se načetl na stránce	–
`yasan_chatbot_open`	Okno chatu se otevřelo	`open_trigger`: `manual` (návštěvník), `auto` (otevřelo se samo), `operator` (připojil se operátor), `restored` (už bylo otevřené)
`yasan_chatbot_close`	Okno chatu se zavřelo	–
`yasan_chatbot_invitation_shown`	Zobrazila se pozvánka do chatu	–
`yasan_chatbot_invitation_dismissed`	Návštěvník pozvánku zavřel	–
`yasan_chatbot_message_sent`	Návštěvník odeslal zprávu	`is_first_message`
`yasan_chatbot_reply_received`	Přišla odpověď	`reply_type` (`assistant` nebo `operator`), `product_count`, `has_questions`, `handoff_offered`, `latency_ms`
`yasan_chatbot_product_view`	V chatu se zobrazil doporučený produkt	`product_id`, `product_name`
`yasan_chatbot_product_click`	Návštěvník klikl na doporučený produkt	`product_id`, `product_name`, `position`
`yasan_chatbot_add_to_cart`	Produkt se z chatu přidal do košíku	`product_id`
`yasan_chatbot_discount_copied`	Návštěvník si zkopíroval slevový kód	`product_id`
`yasan_chatbot_questions_answered`	Návštěvník odpověděl na doplňující otázky	`question_count`
`yasan_chatbot_questions_skipped`	Návštěvník doplňující otázky přeskočil	–
`yasan_chatbot_contact_form_open`	Otevřel se formulář pro kontakt s člověkem	`source` (`header` nebo `message`)
`yasan_chatbot_contact_submitted`	Návštěvník zanechal kontakt	`live_chat_enabled`
`yasan_chatbot_email_verified`	Návštěvník potvrdil e‑mail kódem	–
`yasan_chatbot_operator_joined`	Konverzaci převzal operátor	–
`yasan_chatbot_conversation_reset`	Návštěvník začal novou konverzaci	–

Události AI vyhledávání#

Událost	Kdy se odešle	Parametry
`yasan_search_open`	Otevřelo se okno vyhledávání	`open_source`: `focus`, `click`, `submit`, `input` nebo `key` (jak ho návštěvník otevřel)
`yasan_search_close`	Okno vyhledávání se zavřelo	–
`yasan_search_focus_shelf_shown`	Zobrazily se tipy na produkty před začátkem psaní	–
`yasan_search_submitted`	Proběhlo hledání	`trigger`: `submit` (Enter), `pause` (návštěvník přestal psát), `handover` (z vašeho vlastního vyhledávacího pole), `scope` (změnil se filtr), `retry` (opakovaný pokus)
`yasan_search_no_results`	Hledání nic nenašlo	–
`yasan_search_answer_received`	Přišla AI odpověď na hledání	`product_count`, `has_questions`
`yasan_search_product_click`	Návštěvník klikl na produkt	`product_id`, `surface`, `position`, `category_id`
`yasan_search_add_to_cart`	Produkt se z vyhledávání přidal do košíku	`product_id`, `surface`, `position`
`yasan_search_shelf_open`	Návštěvník otevřel celou řadu produktů	`surface`, `category_id`, `position`
`yasan_search_load_more`	Návštěvník načetl další produkty	–
`yasan_search_filter_add`	Návštěvník přidal filtr	`filter_type`, `filter_key`, `surface`
`yasan_search_filter_remove`	Návštěvník odebral filtr	`filter_type`, `filter_key`, `surface`
`yasan_search_question_answered`	Návštěvník odpověděl na doplňující otázku	`surface`, `position`
`yasan_search_message_sent`	Návštěvník odeslal zprávu v zobrazení chatu	–
`yasan_search_reply_received`	V zobrazení chatu přišla odpověď	`product_count`, `has_questions`, `latency_ms`

surface říká, kde na obrazovce produkt nebo řada byla, například primary (hlavní výsledky), recommended (doporučené), category (kategorie) nebo chat.

Tipy pro Google Analytics#

Události najdete v Přehledy → Zapojení → Události. Nové události se v přehledech mohou objevit až za 48 hodin, v přehledu V reálném čase je uvidíte hned.
Pokud chcete přidání do košíku z AI prodavače a AI vyhledávání počítat jako konverze, označte yasan_chatbot_add_to_cart a yasan_search_add_to_cart jako klíčové události v Administrace → Zobrazení dat → Události.
Aby byly v přehledech vidět parametry jako position nebo surface, zaregistrujte je jako vlastní dimenze v Administrace → Zobrazení dat → Vlastní definice.