Quelle version d'Analytics utiliser

L'intégration avec Google Analytics fonctionne uniquement pour la version Universal Analytics.

Les nouvelles propriétés sont créées par défaut dans la version GA4. Nos requêtes seront ignorées.

Vous devez créer un analytics avec l'interrupteur activé (comme indiqué dans la capture d'écran ci-dessous)

Comment créer et configurer une propriété sur une mini-landing

Créez une propriété sur https://analytics.google.com/

Accédez à Informations de suivi -> Code de suivi

Copiez le code et collez-le dans l'en-tête de la mini-landing

Pour faciliter le travail ultérieur, il est recommandé d'ajouter des propriétés aux mini-landings à l'aide de Google Tag Manager, mais ce n'est pas obligatoire.

Ensuite, vous devez trouver l'ID de suivi dans les paramètres de la propriété

Copiez l'ID de suivi, puis ouvrez les paramètres du projet sur Mavibot et enregistrez l'ID dans les constantes du projet sous le nom google_tracking_id :

Comment partager l'ID client Google (_ga) depuis la mini-landing avec des variables

Pour partager l'ID client, vous devez cocher Google Client ID(_ga) dans les paramètres de la mini-landing. Après le lancement du bot, la variable _ga apparaîtra.

Comment transférer les données GA depuis Mavibot

Lors de l'appel de la fonction de transfert de données vers Google Analytics, certains paramètres sont partagés automatiquement. Les informations ci-dessous sont fournies pour donner une idée générale du fonctionnement de la fonction.

Pour les fonctions ga_pageview et ga_transaction_pageview, le paramètre "t" : "pageview" est transféré

Pour les fonctions ga_event et ga_transaction_event, le paramètre "t" : "event" est transféré

Pour les fonctions ga_transaction_pageview et ga_transaction_event, le paramètre "pa" avec la valeur "purchase" est également transféré.

De plus, lors de l'appel de toutes les fonctions, le paramètre cid est transféré automatiquement - il s'agit de l'ID client pour analytics. Si l'utilisateur est arrivé dans le bot depuis la mini-landing, comme indiqué ci-dessus, alors l'ID est automatiquement enregistré dans les variables du projet, dans la variable _ga

Si la fiche client ne possède pas cette variable, elle est générée automatiquement comme une ligne aléatoire de chiffres, mais dans ce cas, il est recommandé de transférer la source de trafic dans les paramètres avancés (indiqué ci-dessous - Comment redéfinir la source)

Comment redéfinir la source

Si vous devez définir manuellement la source de trafic pour votre événement, vous pouvez ajouter n'importe quel type de requête avec les paramètres suivants. Le dictionnaire ci-dessous n'est pas indépendant - il est utilisé uniquement lors de l'appel des fonctions mentionnées dans le champ Paramètres avancés.

'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'

Documentation sur les paramètres :

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#trafficsources

Comment utiliser les requêtes de type Événements (t:events)

Elles sont utilisées dans Google Analytics pour certains événements. Vous pouvez configurer des objectifs dans GA, ils sont fixés lorsque certains événements se produisent (c'est-à-dire que tous les événements partagés ne doivent pas nécessairement être un objectif).

Vous pouvez trouver les événements dans la section Comportement -> Événements -> Événements principaux

Comment configurer des objectifs d'événement

Vous pouvez configurer des objectifs pour les étapes importantes du flux de travail et les utiliser pour suivre les conversions entre les étapes. Les objectifs sont configurés dans la section Conversions -> Objectifs

Comment transférer des événements

Pour transférer un événement dans GA, vous devez, lors du passage à une étape différente, appeler la fonction ga_event() avec les paramètres nécessaires dans le champ de calcul.

ga_event ('catégorie', 'action événement', 'étiquette', 'valeur événement', '{"nom paramètre": "valeur", "nom paramètre 2": "valeur 2"}')

Clarification sur les paramètres de l'exemple ci-dessus :

catégorie - catégorie de l'événement (paramètre obligatoire)
action événement - paramètre obligatoire
étiquette - étiquette de l'événement ; la valeur de l'événement est transférée sous forme d'entiers et est enregistrée dans la devise définie dans les paramètres d'acquisition
le dictionnaire avec des paramètres supplémentaires ; exemple : '{"ti":"#{order_id}", "tr":"25", "tcc":"#{promocode}"}'

Exemple d'appel de fonction :

ga_event('vente', 'visualisation de liste')
ga_event('Mavibot', 'Entrer dans le bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}')
ga_event('Mavibot', 'Entrer dans le bot', '#{tag}', '100')
ga_event('Mavibot', 'Entrer dans le bot', "", '20')

Comment utiliser les requêtes de type Page View (t:pageview)

En transférant des données sur le nombre de vues de page, vous imitez une visite de l'utilisateur sur la page web. Pour voir un rapport standard des pages, allez dans Comportement -> Contenu du site

Si vous configurez un objectif pour la visite de pages, vous pouvez obtenir un flux de travail virtuel de suivi de la branche du bot sans quitter Google Analytics.

Un exemple de configuration :

L'avantage de cette méthode est la représentation visuelle du mouvement du flux de travail sans avoir à quitter Analytics.

L'inconvénient, cependant, est le fait que vous ne transférez essentiellement qu'un seul paramètre - la visite d'un bloc. Des données supplémentaires telles que l'étiquette ou la valeur, comme dans les requêtes d'événement, ne peuvent pas être transférées de cette manière.

Pour transférer des données sur la visualisation de la page dans GA lors du passage à un bloc, il est essentiel d'appeler la fonction ga_pageview() avec les paramètres nécessaires dans le champ de calcul.

ga_pageview('chemin URL de la page', 'titre', '{"nom paramètre": "valeur", "nom paramètre 2": "valeur 3"}')

Clarification sur les paramètres de l'exemple ci-dessus :

chemin URL de la page - la partie de l'URL qui contient son chemin
titre - le titre de la page/document
un dictionnaire avec des paramètres supplémentaires de cette structure : '{"nom paramètre": "valeur", "nom paramètre 2": "valeur 2"}'

Exemple d'appel de fonction :

ga_pageview('/start, 'Point d'entrée')
ga_pageview('/pay', 'Vente', '{"cd1": "High Scores"}')

Pour le transfert de paramètres supplémentaires, reportez-vous à la documentation liée ci-dessous. Vous y trouverez tous les paramètres possibles avec des descriptions détaillées :

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#content

Comment utiliser le commerce

La configuration du commerce dans l'onglet Toutes les données du site Web

Les paramètres du commerce doivent être envoyés en tant que requêtes existantes (pageview, event)

Il existe deux fonctions à cet effet : ga_transaction_pageview et ga_transaction_event. Plus d'informations ci-dessous.

La fonction ga_transaction_pageview

Les paramètres obligatoires sont en gras :

ga_transaction_pageview('id transaction', 'revenu total', 'chemin URL de la page', 'titre', 'liste de produits', 'dictionnaire de paramètres supplémentaires')

Clarification sur les paramètres de l'exemple ci-dessus :

id transaction - l'identifiant unique de la transaction
revenu total - le revenu total lié à la transaction
chemin URL de la page - la partie de l'URL qui contient son chemin
titre - le titre de la page/document
liste de produits - le tableau de produits de cette structure : '[["id", "nom", "prix", "quantité"], ["id", "nom", "prix", "quantité"]]'
un dictionnaire avec des paramètres supplémentaires de cette structure : '{"nom paramètre": "valeur", "nom paramètre 2": "valeur 2"}'

Exemple d'appel de fonction :

ga_transaction_pageview('#{order_id}', '2200', '/send', 'Reçu', '[["222", "Tarif1", "1200", "1"], ["223", "TarifSupplémentaire", "1000", "1"]]')

ga_transaction_pageview('123', '100', '/pay', 'Payé', '', '{"cd": "High Scores", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

Le tableau de produits est le suivant : tableau de tableaux :

'[["product_id", "nom du produit", "prix du produit", "quantité de produits"], ["product_id", "nom du produit", "prix du produit", "quantité de produits"]]'

Chaque produit doit avoir 4 paramètres, le tableau entier entre guillemets simples (‘), les paramètres à l'intérieur entre guillemets doubles (“)

La fonction ga_transaction_event

Les paramètres obligatoires sont en gras :

ga_transaction_event('id transaction', 'revenu transaction', 'catégorie événement', 'action événement', 'étiquette événement', 'importance événement', 'liste de produits', 'paramètres supplémentaires')

Clarification sur les paramètres de l'exemple ci-dessus :

id transaction - l'identifiant unique de la transaction
revenu total - le revenu total lié à la transaction
catégorie événement, action événement, étiquette événement - paramètres obligatoires
importance événement - transféré en nombres entiers et enregistré dans la même devise que celle définie dans les paramètres de visualisation
liste de produits - le tableau de produits de cette structure : '[["id", "nom", "prix", "quantité"], ["id", "nom", "prix", "quantité"]]'
un dictionnaire avec des paramètres supplémentaires de cette structure : '{"nom paramètre": "valeur", "nom paramètre 2": "valeur 2"}'

Exemple d'appel de fonction :

ga_transaction_event('1244', '121.2', 'catégorie1', 'action', 'étiquette', '10', '[["11", "Produit1", "1.2", "1"], ["22", "Produit2", "120", "1"]]')

ga_transaction_event('1244', '1.2', 'catégorie1', 'action', '', '', '[["11", "Produit1", "1.20", "1"]]')

ga_transaction_event('1244', '121.2', 'catégorie1', 'action', 'étiquette', '10', '[["11", "Produit1", "1.2", "1"], ["22", "Produit2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

Le tableau de produits est le suivant : tableau de tableaux :

'[["product_id", "nom du produit", "prix du produit", "quantité de produits"], ["product_id", "nom du produit", "prix du produit", "quantité de produits"]]'

Chaque produit doit avoir 4 paramètres, le tableau entier entre guillemets simples (‘), les paramètres à l'intérieur entre guillemets doubles (“)

Tutoriel vidéo