Suivre les événements du widget dans GA4 / GTM

Le widget de chat peut refléter ses événements d'interaction dans le window.dataLayer de votre site, où Google Tag Manager (ou tout TMS lisant le dataLayer) les récupère. De là, transmettez-les à GA4, Meta ou n'importe quelle destination déjà gérée dans votre TMS : ouvertures du chat, messages envoyés, produits ajoutés au panier depuis le chat, escalades vers un humain, CSAT, rendez-vous.

Cette fonctionnalité est activée par défaut, sans changement d'intégration ni script d'écoute : le widget pousse directement dans le dataLayer. Vous pouvez la désactiver à tout moment dans votre dashboard, sous Settings → Company → Tracking.

Pousser dans le dataLayer n'a aucun effet en soi : rien n'atteint GA4 (ni aucun autre outil) tant que vous n'avez pas créé les déclencheurs et balises correspondants dans votre TMS. Les sites sans TMS ne sont pas affectés.

Chaque événement ci-dessous est poussé au fil de l'eau :

// À quoi ressemble un push
{
  event: 'humind_message_sent',
  humind: {
    source: 'typed',
    has_product_context: false,
    has_attachments: false,
    is_first_message: true
  }
}

• Les noms d'événements sont préfixés humind_ : ils n'entrent jamais en collision avec vos propres conventions dataLayer et se filtrent trivialement.
• Les paramètres vivent sous la clé humind. Avant chaque push, le widget la réinitialise ({ humind: null }), le même pattern que GA4 documente pour ecommerce : les paramètres d'un événement précédent ne fuient jamais dans le suivant.

Configuration GTM → GA4

1. Variables : créez des variables de couche de données pour les paramètres qui vous intéressent, par ex. humind.product_id, humind.source, humind.sentiment.
2. Déclencheur : créez un déclencheur Événement personnalisé. Soit un par événement (humind_message_sent), soit un fourre-tout unique avec « correspondance par regex » et le motif humind_.*.
3. Balise : créez une balise Événement GA4 déclenchée par ce trigger. Utilisez la variable intégrée comme nom d'événement pour transmettre le nom humind_* tel quel, et mappez vos variables de couche de données comme paramètres d'événement.

Pour les événements panier, vous pouvez plutôt mapper vers les événements e-commerce recommandés de GA4 (add_to_cart / remove_from_cart) dans votre balise : humind_product_added_to_cart transporte product_id, product_variant_id et price.

Référence des événements

Engagement

Événement	Paramètres	Déclenché quand
humind_launcher_shown	-	Le bouton flottant du chat est affiché pour la première fois (une fois par page vue).
humind_nudge_shown	type	Une bulle de message proactif apparaît au-dessus du bouton.
humind_nudge_clicked	type	Le visiteur clique sur la bulle proactive.
humind_nudge_dismissed	type	Le visiteur ferme la bulle proactive.
humind_widget_opened	-	Le panneau de chat s'ouvre (tout chemin : bouton, bulle, déclencheur custom).
humind_widget_closed	-	Le panneau de chat se ferme.

Conversation

Événement	Paramètres	Déclenché quand
humind_message_sent	source, has_product_context, has_attachments, is_first_message	Le visiteur envoie un message. source indique l'origine (typed, quiz, une question suggérée…).
humind_assistant_responded	answer_type, had_products	L'IA a terminé une réponse. had_products vaut true quand des recommandations produit ont été affichées.
humind_new_conversation_started	-	Le visiteur démarre une nouvelle conversation.
humind_conversation_resumed	-	Le visiteur rouvre une conversation passée depuis l'historique.
humind_message_feedback_submitted	sentiment	Le visiteur a noté une réponse de l'IA (pouce haut/bas + détails optionnels).

Produits & panier

Événement	Paramètres	Déclenché quand
humind_product_card_shown	product_id, position	Une carte produit recommandée est affichée (une fois par produit et par message).
humind_product_page_opened	product_id	Le visiteur ouvre la page d'un produit depuis le chat.
humind_product_url_opened	product_id	Le visiteur suit un lien produit depuis le chat.
humind_product_added_to_cart	product_id, product_variant_id, price	Le visiteur ajoute un produit au panier depuis le chat.
humind_product_removed_from_cart	product_id, product_variant_id, price	Le visiteur retire un produit du panier dans le chat.
humind_cart_opened	-	Le visiteur ouvre le panier depuis l'en-tête du chat.
humind_quiz_completed	quiz_id, collection_handle, answered, total_questions	Le visiteur termine un quiz produit qui bascule vers le chat.

Escalade humaine & satisfaction

Événement	Paramètres	Déclenché quand
humind_handoff_requested	-	La conversation est escaladée vers un opérateur humain.
humind_handoff_accepted	-	Un opérateur prend la conversation.
humind_handoff_resolved	-	L'opérateur clôt la conversation.
humind_csat_shown	source	L'enquête de satisfaction est affichée. source vaut ai (fin de conversation IA) ou human (fin de prise en main par un opérateur).
humind_csat_dismissed	source	Le visiteur ferme l'enquête sans noter.
humind_csat_submitted	rating, source	Le visiteur soumet une note de satisfaction (1 à 5).
humind_support_button_clicked	button, channel_type, channel_title	Le visiteur clique sur un canal de support. button est le preset du canal (phone, email, contact_us, whatsapp…) ou l'id du canal custom, channel_type son mécanisme (phone, email, link, js_script), channel_title son libellé tel que configuré dans votre dashboard.
humind_article_rated	article_id, rating	Le visiteur note un article du centre d'aide.

Leads & rendez-vous

Événement	Paramètres	Déclenché quand
humind_pre_chat_survey_submitted	-	Le visiteur soumet le formulaire de contact pré-chat.
humind_appointment_calendar_shown	type	Le calendrier de réservation est affiché dans le chat.
humind_appointment_slot_selected	-	Le visiteur choisit un créneau.
humind_appointment_lead_captured	-	Le visiteur soumet ses coordonnées pour une réservation.
humind_appointment_booked	duration_minutes	La réservation est confirmée.
humind_appointment_cancelled	-	Le visiteur annule une réservation depuis le chat.

Confidentialité & consentement

• Aucune donnée personnelle ne sort du widget. Les payloads ne contiennent jamais le texte des messages, de coordonnées ni d'identifiants visiteur : uniquement des faits d'interaction (nom d'événement, IDs produit, compteurs, notes).
• Poussé indépendamment du consentement cookies, par design. Un push dataLayer ne dépose aucun cookie, ne transporte aucun identifiant et ne fait aucun appel réseau : rien n'atteint GA4 (ni personne) tant qu'une de vos balises ne se déclenche pas. Appliquez le consentement là où il doit l'être, sur vos balises (par ex. GTM Consent Mode), exactement comme vous le faites déjà pour vos propres push page_view et ecommerce. Cela garde aussi les événements pré-consentement disponibles pour les pings cookieless de Consent Mode et vous permet de mesurer l'exposition au widget sur tous les visiteurs.
• Vous gardez le contrôle. Le widget ne fait qu'écrire dans le dataLayer ; ce qui devient un hit GA4 (ou autre) est entièrement décidé par les balises que vous configurez. Pour couper les pushes complètement, désactivez le réglage sous Settings → Company → Tracking.

Points d'attention

• Les événements sont poussés par le widget de chat (<humind-widget>). Les widgets autonomes sur des pages sans le chat ne poussent rien.
• Le flux d'événements humind_* est additif : de nouveaux événements ou paramètres peuvent s'ajouter avec le temps. Ne supposez jamais la liste fermée : un déclencheur fourre-tout humind_.* continue de fonctionner ; les balises liées à des événements précis ne sont pas affectées.
• Test en local : ouvrez la console du navigateur et inspectez window.dataLayer après avoir interagi avec le chat. Dans GTM, utilisez le mode Aperçu et regardez les événements humind_* arriver.