Connecter les services d’analyse
Glossaire
Événement
Description
Comment ça marche
Connectez des services d’analyse pour suivre les événements liés aux actions des utilisateurs sur votre site et à l’interface de paiement. Xsolla prend en charge l’intégration automatique de Google Analytics, permettant de recevoir des analyses avancées des événements du site et de l’interface de paiement. Vous pouvez également connecter d’autres services d’analyse via Google Tag Manager pour obtenir une couverture étendue des événements. Vous pouvez configurer l’analyse avec :
- Google Analytics (intégration automatique)
- un autre service d’analyse (nécessite la configuration de Google Tag Manager)
Xsolla respecte les normes internationales de protection des données. Lors de l’intégration de services d’analyse tiers, certaines données utilisateur peuvent ne pas être collectées en raison des réglementations RGPD et CCPA.
Pour collecter des données de manière légale, le consentement de l’utilisateur doit être obtenu. L’utilisateur peut consulter les conditions de collecte de données via la bannière de cookies. Selon la région de l’utilisateur et les exigences légales, les données sont collectées dans l’un des cas suivants :
- L’utilisateur a accepté le suivi ainsi que tous les fichiers cookies.
- L’utilisateur n’a pas refusé le suivi.
La collecte d’analyses est également influencée par :
- Les bloqueurs de publicité pouvant bloquer les systèmes analytiques et entraver le suivi.
- Les navigateurs tels que Safari, Firefox et Brave qui peuvent bloquer les fichiers cookies tiers ou restreindre le suivi par défaut.
Connexion à Google Analytics
- Créez un compte Google Analytics avec le type de ressource Google Analytics 4.
- Obtenez l’ID de service :
- Dans la barre latérale, choisissez Admin.
- Dans l’onglet Admin, choisissez le compte et la ressource.
- Accédez à l’onglet Data Streams.
- Appuyez sur le flux de données.
- Copiez Measurement ID.
- Dans le projet dans le Compte éditeur, accédez à la section Storefronts > Websites.
- Sélectionnez votre site et appuyez sur Configure.
- Accédez à la section Apps, et dans le bloc Google Analytics, appuyez sur Connect.
- Dans la fenêtre modale, spécifiez l’ID du service d’analyse et appuyez sur Connect.
- Dans la fenêtre modale, appuyez sur Publish.
Si la publication du site n’est pas disponible, assurez-vous que toutes les conditions requises sont remplies :
- Aucune section du constructeur n’est vide (marquée d’un point rouge).
- Le contrat de licence avec Xsolla a été signé.
- Une section d’autorisation utilisateur a été ajoutée au site.
Enregistrement des paramètres d’événements personnalisés
Vous pouvez utiliser les paramètres personnalisés suivants pour affiner vos événements d’analyse :
event_category— identifie la section ou le bloc à partir duquel l’événement a été envoyé.event_label— contient des données spécifiques à l’événement, telles que l’UGS de l’objet, les modes de paiement, etc.
Les paramètres event_category et event_labelsont hérités d’Universal Analytics et conservés pour assurer la compatibilité avec les tableaux de bord existants. Dans Google Analytics 4, ils sont passés comme paramètres d’événements personnalisés et n’apparaissent pas par défaut dans les rapports standard. Pour les utiliser dans des entonnoirs et des rapports personnalisés, vous devez les enregistrer dans Google Analytics 4.
Pour enregistrer les paramètres d’événements :
Dans la barre latérale, choisissez Admin.
Dans l’onglet Admin, accédez à Custom definition.
Appuyez sur Create custom definition.
Dans le champ Definition name, entrez le nom du paramètre que vous souhaitez voir lors de la configuration de l’entonnoir d’événements.
Exemple :
Category.Dans la liste déroulante Scope, choisissez Event.
Dans le champ Description, entrez une description (facultatif).
Dans le champ Event parameter, entrez le nom du paramètre :
event_categoryouevent_label.Appuyez sur Save.
Connexion d’autres services d’analyse
- Créez un compte avec le service d’analyse de votre choix.
- Créez un compte Google Tag Manager (compte GTM).
- Configurez un compte GTM pour votre système d’analyse :
- Configurez les balises.
- Configurez les événements et les paramètres.
- Publiez les modifications sur GTM.
- Dans le projet dans le Compte éditeur, accédez à la section Storefronts > Websites.
- Dans la section Sites, sélectionnez votre site et appuyez sur Configure.
- Accédez à la section Apps et dans le bloc Google Tag Manager, appuyez sur Connect.
- Spécifiez le GTM container ID et appuyez sur Connect. Pour trouver l’ID du conteneur, utilisez l’instruction dans la boîte de saisie How to get your ID.
- Appuyez sur Connect.
- Dans la fenêtre modale, appuyez sur Publish.
Événements du site
Les événements du site reflètent les actions des utilisateurs sur les pages du site telles que les appuis sur les boutons, l’ouverture de widgets, le défilement de carrousels, etc. Ces événements se composent uniquement d’un nom d’événement et des paramètres personnalisés event_category et event_label.
Si vous avez besoin de données d’achat détaillées, consultez la section Ecommerce events. Ces événements fournissent un contexte complet, y compris les montants et devises des achats, l’UGS de l’objet, les modes de paiement, les ID de transaction, etc.
Événements de l’interface de paiement
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
open | Paystation_landing | Nom de la page. | Ouverture de la page de l’interface de paiement. |
close | Paystation_landing | Nom de la page. | Fermeture de la page de l’interface de paiement. |
share | Paystation_landing | Nom du réseau social. | Appui sur le bouton de partage. |
payment_method_name | Paystation_landing | Nom du mode de paiement sélectionné. | Appui sur le bouton Pay now sur le formulaire de saisie des données de paiement. |
choose-widget | Paystation_landing | Nom du widget de mode de paiement. | Appuie sur le widget de mode de paiement. |
choose-method | Paystation_landing | Nom du mode de paiement. | Sélection du mode de paiement. |
change-status | Paystation_landing | Statut du paiement. Valeurs possibles :
| Changement de statut du paiement. Si l’utilisateur ferme la page ou l’interface de paiement et que le statut change après la fermeture, aucun message d’événement n’est envoyé. |
purchase-success | Paystation_landing | done | Paiement réussi. Similaire à l’événement change-status, mais envoyé uniquement pour le statut done. |
Événements du bloc Header
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-login | Header_landing | – | Appui sur le bouton de connexion. |
open-login | Header_landing | – | Ouverture du widget d’autorisation lors de l’appui sur le bouton d’autorisation. |
open-uid-widget | Header_landing | – | Ouverture du widget de saisie de l’ID lors de l’appui sur le bouton d’autorisation. |
click-buy | Header_landing | UGS de l’objet. | Appui sur le bouton d’achat. |
click-googleplay | Header_landing | – | Appui sur un bouton avec un lien Google Play. |
click-appstore | Header_landing | – | Appui sur un bouton avec un lien App Store. |
click-user-account | Header_landing | – | Appui sur le bouton de profil pour un utilisateur autorisé. |
open-menu | Header_landing | – | Ouverture du menu dans la version mobile du site. |
logo-click | Header_landing | – | Appui sur le logo de l’en-tête. |
change_language | Header_landing | Code de la langue sélectionnée. | Changement de la langue de l’interface utilisateur (avec actualisation de la page). |
logout | Header_landing | – | Déconnexion du compte. |
Événements du widget de saisie de l’ID utilisateur
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
close | UID_widget_landing | – | Fermeture de la fenêtre modale de saisie de l’ID. |
input | UID_widget_landing | – | Début de la saisie d’une valeur dans le champ de saisie de l’ID. |
confirm | UID_widget_landing | – | Appui sur le bouton de confirmation de la saisie de l’ID. |
click-instruction | UID_widget_landing | – | Appui sur le lien ou l’icône pour afficher les instructions Where to find User ID. |
error | UID_widget_landing | – | Erreur d’identification (ID invalide saisi). |
success_id | UID_widget_landing | ID utilisateur saisi. | Identification réussie. |
method-validation-start | UID_widget_landing | – | Début de la validation de connexion côté serveur après identification de l’utilisateur. |
authorization-success | UID_widget_landing | – | Autorisation utilisateur réussie. |
authorization-by-social | UID_widget_landing | Nom du réseau social. | Autorisation via un réseau social. |
close-instruction | UID_widget_landing | – | Fermeture de la fenêtre modale avec les instructions Where to find User ID. |
deeplink-click | UID_widget_landing | – | Suivi d’un lien profond pour se connecter à l’application. |
qr-click | UID_widget_landing | – | Appui sur le code QR. |
eye-click | UID_widget_landing | – | Affichage/masquage de la valeur dans le champ de saisie de l’ID utilisateur. |
Événements du bloc Game packs
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-buy | Packs_landing | UGS de l’objet. | Appui sur le bouton d’achat. |
open-login | Packs_landing | – | Ouverture du widget d’autorisation lors de l’appui sur le bouton d’achat. |
open-uid-widget | Packs_landing | – | Ouverture du widget de saisie de l’ID utilisateur lors de l’appui sur le bouton d’achat. |
click-googleplay | Packs_landing | – | Appui sur un bouton avec un lien Google Play. |
click-appstore | Packs_landing | – | Appui sur un bouton avec un lien App Store. |
Événements du bloc Promo slider
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-buy | Promo_landing | UGS de l’objet. | Appui sur le bouton d’achat sur la diapositive. |
open-login | Promo_landing | – | Ouverture du widget d’autorisation lors e l’appui sur le bouton d’achat sur la diapositive. |
open-uid-widget | Promo_landing | – | Ouverture du widget de saisie de l’ID utilisateur lors de l’appui sur le bouton d’achat sur la diapositive. |
click-googleplay | Promo_landing | – | Appui sur un bouton avec un lien Google Play sur une diapositive. |
click-appstore | Promo_landing | – | Appui sur un bouton avec un lien App Store sur une diapositive. |
enter-email | Promo_landing | – | Appui sur le bouton de confirmation de l’adresse e-mail lors de l’abonnement à la newsletter. |
Événements du bloc Store
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
auth | Store_landing_buy_button | – | Ouverture de la fenêtre modale d’autorisation après qu’un utilisateur appuie sur le bouton d’achat. |
open-ps | Store_landing_buy_button | UGS de l’objet. | Initialisation de l’interface de paiement après qu’un utilisateur appuie sur le bouton d’achat dans une carte d’objet. |
auth | Store_landing_pop-up | – | Ouverture de la fenêtre modale d’autorisation après qu’un utilisateur non autorisé appuie sur le bouton d’achat dans une fenêtre modale d’objet. |
open | Store_landing_pop-up | UGS de l’objet. | Ouverture de la fenêtre modale de la carte d’objet. |
open-ps | Store_landing_pop-up | UGS de l’objet. | Initialisation de l’interface de paiement après qu’un utilisateur non autorisé appuie sur le bouton d’achat dans une fenêtre modale d’objet. |
Événements du bloc Call-to-action
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-buy | CTA_landing | UGS de l’objet. | Appui sur le bouton d’achat. |
open-login | CTA_landing | – | Ouverture du widget d’autorisation lors de l’appui sur le bouton d’achat. |
open-uid-widget | CTA_landing | – | Ouverture du widget de saisie de l’ID utilisateur lors de l’appui sur le bouton d’achat. |
enter-email | CTA_landing | – | Appui sur le bouton de confirmation de l’e-mail lors de l’abonnement à la newsletter. |
Événements du bloc Footer
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
social | Footer_landing | Le nom du réseau social. | Appui sur le bouton du réseau social. |
Événements du bloc Offer chain
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
open-auth | Offer_chain_buy_button | UGS de l’objet. | Ouverture de la fenêtre modale d’autorisation après que l’utilisateur appuie sur le bouton d’achat. |
open-ps | Offer_chain_buy_button | UGS de l’objet. | Initialisation de l’interface de paiement après que l’utilisateur appuie sur le bouton d’achat dans une carte d’objet. |
claim | Offer_chain_buy_button | UGS de l’objet. | Offre réclamée après que l’utilisateur appuie sur le bouton de réclamation dans une carte d’objet. |
open-auth | Offer_chain_pop-up | UGS de l’objet. | Ouverture de la fenêtre modale d’autorisation après qu’un utilisateur non autorisé appuie sur le bouton d’achat dans une fenêtre modale d’objet. |
open-ps | Offer_chain_pop-up | UGS de l’objet. | Initialisation de l’interface de paiement après que l’utilisateur appuie sur le bouton d’achat dans une fenêtre modale d’objet. |
claim | Offer_chain_pop-up | UGS de l’objet. | Offre réclamée après que l’utilisateur appuie sur le bouton de réclamation dans une fenêtre modale d’objet. |
open | Offer_chain_pop-up | UGS de l’objet. | Ouverture de la fenêtre modale de la carte d’objet après que l’utilisateur appuie sur la carte. |
scroll-right | Offer_chain_landing | – | Défilement vers la droite en appuyant sur une flèche droite dans le carrousel des cartes de la chaîne d’offres. |
scroll-left | Offer_chain_landing | – | Défilement vers la gauche en appuyant sur la flèche gauche dans le carrousel des cartes de la chaîne d’offres. |
Événements du bloc Daily rewards
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
open-auth | Daily_reward_landing | – | Ouverture du widget d’autorisation ou du widget de saisie de l’ID utilisateur lors de l’appui sur le bouton de réclamation sur la carte de l’étape. |
open-ps | Daily_reward_landing | UGS de l’objet. | Récompense quotidienne réclamée. |
expand | Daily_reward_landing | Action de la liste. Valeurs possibles :
| Appui sur le bouton pour développer ou réduire la liste des récompenses quotidiennes. |
Événements du bloc Rewards
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
load | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Chargement du système de récompenses pour un utilisateur autorisé. |
vp-added | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Les points de valeur sont crédités sur le solde de l’utilisateur. |
step-achieved | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | L’utilisateur a progressé vers une nouvelle étape dans le système de récompenses. |
step-collected | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Récompense réclamée avec succès. |
step-opened | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Ouverture de la fenêtre modale de l’étape après que l’utilisateur appuie sur la carte. |
reward-tab-click | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Changement entre les chaînes de récompenses en appuyant sur les onglets. |
reward-button-open-auth | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Ouverture du widget d’autorisation ou du widget de saisie de l’ID utilisateur lors de l’appui sur le bouton de réclamation sur la carte de l’étape. |
steps-scroll-right | Rewards_landing | Type de chaîne de récompenses vers laquelle l’utilisateur a basculé. Valeurs possibles : | Défilement vers la droite en appuyant sur la flèche droite dans le carrousel des cartes d’étapes. |
steps-scroll-left | Rewards_landing | Type de chaîne de récompenses. Valeurs possibles : | Défilement vers la gauche en appuyant sur la flèche gauche dans le carrousel des cartes d’étapes. |
Événements du panier
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-cart |
| – | Appui sur l’icône du panier dans l’en-tête. |
open-cart |
| – | Ouverture de la fenêtre modale du panier. |
close-cart | Cart_landing | – | Fermeture de la fenêtre modale du panier. |
change-item-quantity | Cart_landing | UGS de l’objet. | Changement de la quantité de l’objet dans le panier. |
input-code | Cart_landing | – | Application d’un code promo dans le panier. |
error_code | Cart_landing | Code d’erreur (par exemple, 9811). | Erreur lors de l’application d’un code promo. |
delete | Cart_landing | UGS de l’objet. | Suppression d’un objet du panier. |
checkout | Cart_landing | – | Création d’une commande et ouverture de l’interface de paiement. |
back-to-store | Cart_landing | – | Retour au magasin depuis un panier vide. |
clear | Cart_landing | – | Vidage du panier (appui sur le bouton Remove all). |
continue | Cart_landing | – | Retour au magasin depuis le panier (appui sur le bouton Keep shopping). |
click-checkout | Cart_landing | – | Appui sur le bouton de paiement. |
confirm_code | Cart_landing | – | Confirmation de la saisie du code promo. |
remove-code | Cart_landing | – | Suppression du code promo appliqué. |
discount-cart | Cart_landing | – | Application d’une remise à l’ensemble du panier. |
discount-item | Cart_landing | – | Application d’une remise à un seul objet. |
warning-delete | Cart_landing | – | Affichage d’un avertissement lors de la suppression d’un objet. |
close-warning | Cart_landing | – | Fermeture de l’avertissement de suppression d’objet. |
authorization-modal-open-in-cart | Cart_landing | – | Ouverture de la fenêtre d’autorisation lorsque l’utilisateur passe une commande ou applique un code promo. |
Événements d’action personnalisée et de navigation
| Nom de l’événement | Valeur du paramètre | Valeur du paramètre | Description |
|---|---|---|---|
click-link | Catégorie dynamique (dépend du bloc). | – | Suivi d’un lien ou appui sur un bouton avec un lien dans un bloc. |
click-page | Catégorie dynamique (dépend du bloc). | – | Navigation vers une autre page du site lors de l’appui sur un bouton. |
click-scroll | Catégorie dynamique (dépend du bloc). | – | Appui sur un bouton pour faire défiler vers un bloc spécifique. |
click-more-info | Catégorie dynamique (dépend du bloc). | – | Appui sur le bouton Learn more. |
open-video | Catégorie dynamique (dépend du bloc). | – | Ouverture d’une vidéo dans une lightbox. |
click-subscription | Catégorie dynamique (dépend du bloc). | – | Appui sur le bouton pour s’abonner aux actualités. |
input-email | Catégorie dynamique (dépend du bloc). | – | Saisie d’une adresse e-mail dans le formulaire d’abonnement à la newsletter. |
Événements e-commerce
L’interface de paiement Xsolla est chargée dans un iframe séparé avec son propre domaine et ses propres analyses. Seuls les événements d’initialisation et de finalisation du paiement sont envoyés depuis la page de destination. Les données détaillées du processus de paiement sont passées sous forme d’événements e-commerce.
| Événement | Description |
|---|---|
open-paystation | Ouverture de l’interface de paiement. Envoyé lors de l’initialisation. |
open-{state_name} | Ouverture de la page de l’interface de paiement. |
open-payment-credit-card | Ouverture de l’interface de paiement pour entrer les informations de la carte. |
open-payment-saved-methods | Ouverture de la page avec les modes de paiement enregistrés. |
open-payment-payment-methods | Ouverture de la liste de tous les modes de paiement disponibles en appuyant sur more. |
open-payment-{id} | Ouverture de la page pour un mode de paiement spécifique, où id est l’ID du mode de paiement. |
open-external-pages | Ouverture de pages externes depuis l’interface de paiement. |
open-status | Ouverture de la page de statut de paiement. |
open-status-processing | Ouverture de la page de statut de paiement lors du traitement du paiement (statut — processing). À la fin, le statut passe à success ou error. |
open-status-error | Ouverture de la page de statut en cas d’erreur de paiement (statut — error). |
open-status-success | Ouverture de la page de statut en cas de paiement réussi (statut — success). |
choose-payment-widget | Sélection d’un widget de mode de paiement. |
choose-method | Sélection d’un mode de paiement. |
click-btn-pay | Appui sur le bouton Pay now sur le formulaire de saisie des données de paiement. |
click-btn-return-url | Appui sur le bouton de retour au magasin (Back to the game). |
click-additional-btn-return-url | Appui sur un bouton de retour au magasin supplémentaire. |
create-invoice | Création d’une transaction. Se transforme en un événement purchase avec des paramètres d’achat supplémentaires (objets, montant, devise). |
purchase | Finalisation d’un achat. L’événement est envoyé lorsqu’une facture est créée et contient des informations d’achat détaillées, y compris les coûts des objets et les taxes. L’événement est envoyé uniquement si vous avez configuré le catalogue des objet dans le Compte éditeur. |
change-status | Changement du statut de paiement. Envoyé avec un paramètre status supplémentaire. |
Paramètres généraux de l’événement (envoyés avec chaque événement) :
| Paramètre | Description |
|---|---|
category | Toujours paystation. |
version | Version de l’interface de paiement. |
projectId | ID de projet. |
projectName | Nom du projet. |
user_id | ID utilisateur. |
v1 | ID utilisateur (duplique user_id). |
country | Code pays du paiement. |
external_id | ID externe (si disponible). |
purchase_invoice_id | ID de facture d’achat côté Xsolla. |
pid | ID du mode de paiement. |
total_sum | Montant total de l’achat, y compris tous les frais. |
total_sum_currency | Devise du montant total de l’achat. |
purchase_sku | UGS de l’objet. |
purchase_sku_digitalContent | UGS du contenu numérique. |
Paramètres supplémentaires pour l’événement d’achat :
| Paramètre | Description |
|---|---|
transaction_id | ID de transaction. |
currency | Devise. |
value | Montant hors taxes. |
items | Tableau des objets avec paramètres :
|
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.