Events für Google Analytics

Wenn Sie auf Ihrer Website Google Analytics 4 (GA4) verwenden, senden der KI-Verkaufsagent und die KI-Suche automatisch Events dorthin. Sie werden nur für Besucher gesendet, die Analyse-Cookies zugestimmt haben (siehe Cookie-Einwilligung). Läuft GA4 über das Google-Tag (gtag.js), müssen Sie sonst nichts einrichten. Wenn Sie nur den Google Tag Manager verwenden, lesen Sie unten den Abschnitt Google Tag Manager. Alle Event-Namen beginnen mit yasan_, sodass Sie sie leicht finden.

Wenn Ihre Website kein Google Analytics hat, wird nichts gesendet und beide Widgets funktionieren wie gewohnt.

Google Tag Manager#

Wenn Ihre Website den Google Tag Manager, aber kein Google-Tag (gtag.js) hat, legen die Widgets die Events in der Datenschicht des Tag Managers (dataLayer) ab. An GA4 gibt der Tag Manager sie erst weiter, wenn Sie das einrichten:

Erstellen Sie einen Trigger vom Typ Benutzerdefiniertes Ereignis, tragen Sie bei Ereignisname ^yasan_ ein und aktivieren Sie Übereinstimmung mit regulärem Ausdruck verwenden.
Erstellen Sie ein Tag Google Analytics: GA4-Ereignis mit Ihrer Mess-ID, tragen Sie bei Ereignisname {{Event}} ein und lösen Sie es mit diesem Trigger aus.
Erstellen Sie für jeden Parameter, den Sie in GA4 sehen möchten (zum Beispiel product_id oder position), eine Datenschichtvariable mit demselben Namen und fügen Sie sie den Ereignisparametern des Tags hinzu.
Veröffentlichen Sie den Container.

Die Einwilligung wird zweimal geprüft:

Die Widgets senden Events nur für Besucher, die Analyse-Cookies zugestimmt haben. Das Widget muss die Wahl des Besuchers kennen: Bei Shoptet liest es sie automatisch aus dem Shoptet-Cookie-Banner, auf anderen Plattformen übergeben Sie sie mit window.Whisper.setConsent, wie im Artikel Cookie-Einwilligung einrichten beschrieben. Solange das Widget nicht weiß, dass der Besucher zugestimmt hat, wird nichts an Google Analytics gesendet.
Google Analytics wendet anschließend seinen eigenen Einwilligungsmodus (Consent Mode) an – genau wie für den Rest Ihrer Website: Im erweiterten Modus erfasst es ohne Einwilligung nur anonyme Signale ohne Cookies, im einfachen Modus wird nichts an Google gesendet, bis der Besucher zustimmt.

Was wir senden und was nicht#

Wir senden niemals den Text von Nachrichten, Suchbegriffe, E-Mail-Adressen oder andere personenbezogene Daten. Die Events sagen nur, was passiert ist, dazu Angaben wie die ID und den Namen des Produkts, seine Position in der Liste oder die Anzahl der angezeigten Produkte.

Jedes Event enthält den Parameter yasan_widget: chatbot für den KI-Verkaufsagenten, search für die KI-Suche.

Events des KI-Verkaufsagenten#

Event	Wann es gesendet wird	Parameter
`yasan_chatbot_loaded`	Der Chat wurde auf der Seite geladen	–
`yasan_chatbot_open`	Das Chatfenster wurde geöffnet	`open_trigger`: `manual` (vom Besucher), `auto` (öffnet sich von selbst), `operator` (ein Servicemitarbeiter ist beigetreten), `restored` (war bereits geöffnet)
`yasan_chatbot_close`	Das Chatfenster wurde geschlossen	–
`yasan_chatbot_invitation_shown`	Die Chat-Einladung wurde angezeigt	–
`yasan_chatbot_invitation_dismissed`	Der Besucher hat die Einladung geschlossen	–
`yasan_chatbot_message_sent`	Der Besucher hat eine Nachricht gesendet	`is_first_message`
`yasan_chatbot_reply_received`	Eine Antwort ist eingegangen	`reply_type` (`assistant` oder `operator`), `product_count`, `has_questions`, `handoff_offered`, `latency_ms`
`yasan_chatbot_product_view`	Im Chat wurde ein empfohlenes Produkt angezeigt	`product_id`, `product_name`
`yasan_chatbot_product_click`	Der Besucher hat auf ein empfohlenes Produkt geklickt	`product_id`, `product_name`, `position`
`yasan_chatbot_add_to_cart`	Ein Produkt wurde aus dem Chat in den Warenkorb gelegt	`product_id`
`yasan_chatbot_discount_copied`	Der Besucher hat einen Rabattcode kopiert	`product_id`
`yasan_chatbot_questions_answered`	Der Besucher hat die Rückfragen beantwortet	`question_count`
`yasan_chatbot_questions_skipped`	Der Besucher hat die Rückfragen übersprungen	–
`yasan_chatbot_contact_form_open`	Das Formular zur Kontaktaufnahme mit einem Menschen wurde geöffnet	`source` (`header` oder `message`)
`yasan_chatbot_contact_submitted`	Der Besucher hat seine Kontaktdaten hinterlassen	`live_chat_enabled`
`yasan_chatbot_email_verified`	Der Besucher hat seine E-Mail mit einem Code bestätigt	–
`yasan_chatbot_operator_joined`	Ein Servicemitarbeiter hat die Konversation übernommen	–
`yasan_chatbot_conversation_reset`	Der Besucher hat eine neue Konversation begonnen	–

Events der KI-Suche#

Event	Wann es gesendet wird	Parameter
`yasan_search_open`	Das Suchfenster wurde geöffnet	`open_source`: `focus`, `click`, `submit`, `input` oder `key` (wie der Besucher es geöffnet hat)
`yasan_search_close`	Das Suchfenster wurde geschlossen	–
`yasan_search_focus_shelf_shown`	Die Produkttipps vor dem Tippen wurden angezeigt	–
`yasan_search_submitted`	Eine Suche wurde ausgeführt	`trigger`: `submit` (Enter), `pause` (der Besucher hat aufgehört zu tippen), `handover` (aus Ihrem eigenen Suchfeld), `scope` (ein Filter hat sich geändert), `retry` (erneuter Versuch)
`yasan_search_no_results`	Die Suche hat nichts gefunden	–
`yasan_search_answer_received`	Die KI-Antwort auf eine Suche ist eingegangen	`product_count`, `has_questions`
`yasan_search_product_click`	Der Besucher hat auf ein Produkt geklickt	`product_id`, `surface`, `position`, `category_id`
`yasan_search_add_to_cart`	Ein Produkt wurde aus der Suche in den Warenkorb gelegt	`product_id`, `surface`, `position`
`yasan_search_shelf_open`	Der Besucher hat eine ganze Produktreihe geöffnet	`surface`, `category_id`, `position`
`yasan_search_load_more`	Der Besucher hat weitere Produkte geladen	–
`yasan_search_filter_add`	Der Besucher hat einen Filter hinzugefügt	`filter_type`, `filter_key`, `surface`
`yasan_search_filter_remove`	Der Besucher hat einen Filter entfernt	`filter_type`, `filter_key`, `surface`
`yasan_search_question_answered`	Der Besucher hat eine Rückfrage beantwortet	`surface`, `position`
`yasan_search_message_sent`	Der Besucher hat in der Chatansicht eine Nachricht gesendet	–
`yasan_search_reply_received`	In der Chatansicht ist eine Antwort eingegangen	`product_count`, `has_questions`, `latency_ms`

surface gibt an, wo auf dem Bildschirm das Produkt oder die Reihe war, zum Beispiel primary (Hauptergebnisse), recommended (Empfehlungen), category (Kategorie) oder chat.

Tipps für Google Analytics#

Die Events finden Sie unter Berichte → Engagement → Ereignisse. Neue Events können bis zu 48 Stunden brauchen, bis sie in den Berichten erscheinen; im Bericht Echtzeit sehen Sie sie sofort.
Wenn Sie das Hinzufügen zum Warenkorb aus dem KI-Verkaufsagenten und der KI-Suche als Conversion zählen möchten, markieren Sie yasan_chatbot_add_to_cart und yasan_search_add_to_cart unter Verwaltung → Datenanzeige → Ereignisse als Schlüsselereignisse.
Damit Parameter wie position oder surface in Berichten sichtbar sind, registrieren Sie sie unter Verwaltung → Datenanzeige → Benutzerdefinierte Definitionen als benutzerdefinierte Dimensionen.