Connecter Novaco à Google Analytics

Transmettez les événements de votre assistant virtuel à Google Tag Manager ou Google Analytics 4 et générez des rapports sur les conversations, les leads et les rendez-vous.

Deux méthodes

Il existe deux façons de connecter les données Novaco à Google Analytics. Choisissez-en une — n'exécutez jamais les deux en parallèle.

1. Google Tag Manager

Recommandé si vous utilisez déjà GTM. Poussez les événements vers la couche de données et distribuez-les à n'importe quelle balise.

2. Google Analytics 4

Utilisez directement la balise Google (gtag.js) sur votre site web pour envoyer les événements directement à GA4.

Quels événements sont disponibles ? Consultez la référence des événements Google Analytics.

Se connecter avec Google Tag Manager

GTM distribue les événements à des tiers via des balises. Pour ce faire, vous fournissez les données dans ce qu'on appelle la « couche de données ». Ajoutez un écouteur pour chaque événement que vous souhaitez utiliser.

Exemple : un événement

<script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

Exemple : plusieurs événements

<script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

Le try-catch est une gestion d'erreurs facultative — vous pouvez la laisser telle quelle.

Créer les variables de la couche de données

En plus des événements, Novaco fournit des données d'événement supplémentaires telles que session_id, chat_type et appointment_type. Créez une variable pour chacune.

Accédez à votre conteneur GTM.
Accédez à Variables et cliquez sur « Nouvelle » sous « Variables définies par l'utilisateur ».
Choisissez « Variable de couche de données » comme type de variable.
Donnez-lui un nom clair, par exemple « Novaco – session_id ».
Comme nom de variable de couche de données, indiquez le nom de la variable Novaco.
Cliquez sur Enregistrer.

Relier les événements aux déclencheurs et aux balises

Créez un déclencheur pour chaque événement sur lequel vous souhaitez agir, puis combinez déclencheurs et variables dans une balise GA4.

Créer un déclencheur

Accédez à votre conteneur GTM.
Accédez à Déclencheurs et cliquez sur « Nouveau ».
Choisissez le type de déclencheur « Événement personnalisé ».
Donnez-lui un nom clair, par exemple « Novaco – Lead créé ».
Utilisez le nom de l'événement Novaco comme nom d'événement.
Cliquez sur Enregistrer.

Créer la balise GA4

Accédez à Balises et cliquez sur « Nouvelle ».
Choisissez le type de balise « Google Analytics : Événement GA4 ».
Donnez-lui un nom clair, par exemple « GA4 – Événements Novaco ».
Renseignez votre ID de mesure ou associez-la à votre configuration de balise Google.
Renseignez {{Event}} comme nom d'événement.
Sous « Paramètres d'événement », ajoutez les variables Novaco comme paramètres.
Cliquez sur Enregistrer.

Tout déclencheur d'événement Novaco que vous ajoutez maintenant envoie automatiquement ses données à GA4. Les mêmes composants peuvent être utilisés pour d'autres balises, comme une conversion de lead Google Ads.

Se connecter directement à Google Analytics 4

Pas de gestionnaire de balises ? Utilisez l'implémentation de la balise Google (gtag.js). N'exécutez jamais cette configuration en parallèle avec Google Tag Manager — si vous utilisez GTM, suivez plutôt le guide ci-dessus.

1. Configurez votre balise Google

<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-12345678');
</script>

Remplacez G-12345678 par votre propre ID de mesure.

2. Ajoutez le suivi des événements Novaco

Ajoutez cet extrait de code après votre appel gtag('config', ...).

<script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    gtag('event', e.type, {
      'session_id': e.detail.eventData.session_id,
      'appointment_type': e.detail.eventData.appointment_type
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
  try {
    gtag('event', e.type, {
      'session_id': e.detail.eventData.session_id,
      'chat_type': e.detail.eventData.chat_type
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

e.type se résout automatiquement au nom de l'événement, par exemple autochat_lead_created. C'est également le nom d'événement que vous verrez dans GA4. Tout ce qui suit constitue les paramètres de l'événement.

Dimensions personnalisées GA4

Pour générer des rapports sur les paramètres d'événement, enregistrez-les comme dimensions personnalisées dans GA4.

Accédez à l'administration de votre propriété GA4.
Accédez à « Définitions personnalisées ».
Accédez à « Dimensions personnalisées » et cliquez sur « Créer une dimension personnalisée ».
Utilisez un nom de dimension descriptif, par exemple « Novaco chat open type ».
Définissez la portée sur « Événement ».
Comme paramètre d'événement, utilisez le nom de variable que vous avez utilisé dans la balise GA4, par exemple chat_open_type.

analyticsSetup.dimensions.note

Vous cherchez la liste des événements ?

Chaque événement, son moment de déclenchement et les données qu'il transporte.

Voir la référence des événements