Analyse des événements

Vous pouvez utiliser cette fonctionnalité si vous avez déjà intégré Pay Station et que vous avez créé au moins un compte :

Avis

Google Analytics et Facebook collectent des données si l’utilisateur a consenti à l’utilisation de tous les cookies ou des cookies analytiques et de performance sur la bannière RGPD.

Intégration des plateformes d'analyse

Pour suivre les événements se produisant dans l’interface de paiement lorsque les utilisateurs interagissent avec elle, connectez les plateformes d’analyse dans votre Compte éditeur :

Google Analytics

Pour connecter la plateforme d’analyse :

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Accédez à Pay Station > Settings.
  3. Dans la section Apps, sélectionnez Google Analytics.
  4. Cliquez sur Connect.

Lorsque vous connectez Google Analytics, les événements correspondants sont envoyés à votre compte Google Analytics. Pour accéder à ces événements, accédez au compte Google Analytics sous la section Behaviour > Events > Top Events.

Vous pouvez suivre les événements suivants :

ActionDescription
open-{state_name}Ouverture d’une page dans l’interface de paiement.
click-btn-payClic sur le bouton Payer Maintenant sur le formulaire de saisie des données de facturation.
returnClic sur le bouton Retourner au magasin/Recommencer.
create-invoiceCréation de transaction.
purchaseCréation d’une facture (attribution d’un ID de transaction). Les paramètres de l’événement contiennent des informations détaillées sur un achat, notamment le prix des articles et la taxe. Pour la description des paramètres, consultez la documentation Google Analytics.

L’événement est envoyé uniquement si vous avez configuré le catalogue dans le Compte éditeur dans la section Store.
open-payment-credit-cardOuverture de l’interface de paiement pour entrer les informations de la carte.
open-payment-saved-methodsOuverture de la page contenant les modes de paiement enregistrés.
open-payment-payment-methodsOuverture de la liste de tous les modes de paiement disponibles après un clic sur plus.
open-payment-{id}Ouverture de la page d’un mode de paiement spécifique, où id est l’ID du mode de paiement.
open-statusOuverture de la page d’état du paiement.
open-status-processingOuverture de la page d’état du paiement avec le statut processing. Une fois le traitement terminé, le statut peut passer à success ou error.
open-status-errorOuverture de la page d’état du paiement avec le statut error.
open-status-successOuverture de la page d’état du paiement avec le statut success.
choose-methodSélection d’un mode de paiement lors de l’ouverture de la liste plus.
Dimensions personnalisées pour Google Analytics
ID de dimensionNomDescription
1versionVersion de Pay Station.
2purchase_invoice_idID de facture de paiement dans le système de Xsolla.
3external_idID de facture de paiement dans le système du partenaire.
5total_sumMontant total de l’achat. Tous frais inclus.
6total_sum_currencyDevise du montant total de l’achat.
7pidID de système de paiement.
8projectIdID de projet.
9countryPays de paiement.
10projectNameNom du projet.

Facebook Analytics

Pour connecter la plateforme d’analyse :

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Accédez à Pay Station > Settings.
  3. Dans la section Apps, sélectionnez Facebook Pixel.
  4. Cliquez sur Connect.

Lorsque vous connectez Facebook Pixel, les événements correspondants seront envoyés à votre compte Facebook Analytics. Pour accéder à ces événements, accédez au compte Facebook Analytics sous la section Business Settings > Measure & Report > Analytics > Pixels > Overview.

Vous pouvez suivre les événements suivants :

ÉvénementDescription
open-{state_name}Ouverture d’une page dans l’interface de paiement. Le nom du statut est passé dans parameters.
click-btn-payClic sur le bouton Payer Maintenant sur le formulaire de saisie des données de facturation. Le nom du mode de paiement est passé dans parameters.
returnClic sur le bouton Retourner au magasin/Recommencer. Le nom du statut est passé dans parameters.
change-status-{status_name}Changement du statut du paiement.
Si l’utilisateur ferme l’interface de paiement ou quitte la page avant que le statut ne change, le message d’événement n’est pas envoyé.
create-invoiceCréation de transaction.
open-payment-credit-cardOuverture de l’interface de paiement pour entrer les informations de la carte.
open-payment-saved-methodsOuverture de la page contenant les modes de paiement enregistrés.
open-payment-payment-methodsOuverture de la liste de tous les modes de paiement disponibles après un clic sur plus.
open-payment-{id}Ouverture de la page d’un mode de paiement spécifique, où id est l’ID du mode de paiement.
open-statusOuverture de la page d’état du paiement.
open-status-processingOuverture de la page d’état du paiement avec le statut processing. Une fois le traitement terminé, le statut peut passer à success ou error.
open-status-errorOuverture de la page d’état du paiement avec le statut error.
open-status-successOuverture de la page d’état du paiement avec le statut success.
choose-methodSélection d’un mode de paiement lors de l’ouverture de la liste plus.

Pour intégrer la plateforme d’analyse :

  1. Accédez à Pay Station > Settings dans votre Compte éditeur.
  2. Sélectionnez Google Analytics/Facebook Pixel dans la section Apps.
  3. Entrez votre ID de suivi et cliquez sur Connect.

Lorsque vous intégrez Google Analytics et Facebook Pixel, les événements correspondants sont envoyés à vos comptes Google Analytics et Facebook Analytics.

GameAnalytics

Pour connecter la plateforme d’analyse :
  1. Ouvrez votre projet dans le Compte éditeur.
  2. Accédez à Pay Station > Settings.
  3. Dans la section Apps, sélectionnez GameAnalytics.
  4. Cliquez sur Connect.

  1. Dans le champ GameAnalytics game key, saisissez la clé de jeu. Pour trouver information, accédez à votre compte GameAnalytics :
    1. Dans le menu déroulant en haut du panneau, sélectionnez le jeu.
    2. Dans la section Keys, cliquez sur l'icône de copie à côté de la Game key.

Note
Si votre jeu est publié sur plusieurs plateformes et qu’il existe des projets dédiés à chacune d’entre elles dans GameAnalytics, vous pouvez saisir une clé de jeu pour chacune de ces plateformes dans le Compte éditeur.

  1. Cliquez sur Connect.

Actuellement, l’intégration avec la plateforme GameAnalytics vous permet de recevoir des informations sur les événements de paiement réussis. Ces données se trouvent dans votre compte GameAnalytics sur le tableau de bord dans la section Monetization.

Événements de l'interface de paiement

Les événements de l’interface de paiement sont traités via le mécanisme postMessage lors de l’ouverture de Pay Station dans un iframe, dans une nouvelle fenêtre ou avec Pay Station Embed.

Exemple de scénario de traitement de messages envoyés via postMessage :

  1. Abonnez-vous pour recevoir les messages envoyés via postMessage.
  2. Analysez les données de l’événement au format JSON.
  3. Implémentez une vérification de la présence de l’événement à traiter.
  4. Lorsque l’événement requis est reçu, implémentez la logique de son traitement. Dans l’exemple ci-dessous, le texte est affiché dans la console. Vous pouvez ajouter votre propre logique.

Exemple :
Copy
Full screen
Small screen
    window.addEventListener('message', (event) => {
      const eventData = JSON.parse(event.data);
    
      if (eventData.command === 'open-payment') {
        console.log('hello!')
      }
    });
    
    ÉvénementDescription
    add_saved_accountEnregistrement réussi du compte de paiement.
    add_saved_account_errorErreur lors de l’enregistrement du compte de paiement.
    cancel_save_accountAnnulation de l’enregistrement du compte de paiement par l’utilisateur.
    cart_displayAffichage de l’interface de paiement sous forme de colonnes. Le paramètre value peut prendre la valeur :
    • 1 — si l’interface de paiement s’ouvre sous forme de deux colonnes ;
    • 0 — si l’interface de paiement s’ouvre sous forme d’une colonne, par exemple, sur la page où vous gérez les modes de paiement enregistrés.
    Exemple : {“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}}.
    change-statusChangement du statut du paiement. Si l’utilisateur ferme l’interface de paiement ou quitte la page avant que le statut ne change, le message d’événement n’est pas envoyé.
    choose-methodSélection d’un mode de paiement lors de l’ouverture de la liste plus.
    click-custom-package-continueClic sur le bouton Continuer pour acheter une quantité arbitraire de monnaie virtuelle.
    click-commentClic sur le bouton pour publier un commentaire.
    click-buy-packageClic sur le bouton Acheter pour acheter un package de monnaie virtuelle.
    click-buy-gift-packageClic sur le bouton pour acheter un paquet de monnaie virtuelle en cadeau.
    click-buy-gift-custom-packageClic sur le bouton pour acheter une quantité arbitraire de monnaie virtuelle en cadeau.
    click-btn-payClic sur le bouton Payer Maintenant sur le formulaire de saisie des données de facturation.
    click-btn-continueClic sur le bouton pour acheter l’abonnement.
    click-btn-applyClic sur le bouton Apply pour utiliser un coupon.
    click-btn-activateClic sur le bouton Activate pour activer une clé de jeu.
    click-btn-acceptClic sur le bouton pour acheter du contenu numérique.
    create-invoiceCréation de transaction.
    dimensionsLorsque la Pay Station s’ouvre dans un iframe, la largeur et la hauteur de l’iframe sont passées dans les paramètres width et height.
    errorUne erreur est survenue au cours du processus de paiement. Le code d’erreur est passé dans le paramètre data.code, tandis que la description de l’erreur affichée dans l’interface de paiement est passée dans le paramètre data.message.
    external-link-openRedirection vers une ressource externe. L’adresse vers laquelle l’utilisateur est redirigé est passée dans le paramètre url.
    external-payment-openRedirection depuis l’interface de paiement vers un système de paiement externe ou la vérification 3-D Secure.
    focus-changeChangement de focus sur les éléments du widget Pay Station. Le statut du focus est passé dans le paramètre hasFocus et peut être true ou false.
    open-{state_name}Ouverture d’une page dans l’interface de paiement.
    open-payment-credit-cardOuverture de l’interface de paiement pour entrer les informations de la carte.
    open-payment-saved-methodsOuverture de la page contenant les modes de paiement enregistrés.
    open-payment-payment-methodsOuverture de la liste de tous les modes de paiement disponibles après un clic sur plus.
    open-payment-{id}Ouverture de la page d’un mode de paiement spécifique, où id est l’ID du mode de paiement.
    open-statusOuverture de la page d’état du paiement.
    open-status-processingOuverture de la page d’état du paiement avec le statut processing. Une fois le traitement terminé, le statut peut passer à success ou error.
    open-status-errorOuverture de la page d’état du paiement avec le statut error.
    open-status-successOuverture de la page d’état du paiement avec le statut success.
    order-statusChangement du statut de la commande sur done. L’événement est envoyé depuis la page d’état du paiement si la commande a été créée via l’un des appels API suivants :
    Les données sur l’utilisateur, la transaction et la commande sont passées dans l’objet data.

    Exemple : {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}}.
    resizeModification de la taille de l’interface de paiement. La largeur et la hauteur de l’interface de paiement ouverte sont passées dans l’objet data.
    Exemple : {“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}}.
    show-error-pageOuverture d’une page avec une erreur. Le code d’erreur est passé dans le paramètre value.
    statusAccès à la page d’état du paiement. Les paramètres suivants peuvent être passés :
    • status — statut du paiement ;
    • email — adresse e-mail de l’utilisateur ;
    • invoice — ID de transaction ;
    • virtualCurrencyAmount — quantité de la monnaie virtuelle achetée ;
    • userId — ID utilisateur ;
    • discount — réduction appliquée au paiement.
    status-redeemUtilisation de coupon dans un formulaire de paiement.
    closeFermeture de l’interface de paiement.
    Les paramètres de l’événement sont passés dans chaque message de postMessage. Si les informations du paramètre n’ont pas encore été collectées, une chaîne vide s’affiche.
    ParamètreTypeDescription
    actionstringNom de l’événement.
    valuestringParamètre supplémentaire. Contient les paramètres spécifiques de l’événement qui varient en fonction du choix de l’utilisateur.
    statestringPage de l’interface de paiement sur laquelle l’action a été effectuée.
    datestringDate et heure au format GMT.
    millisecondsnumberDate et heure au format d’heure Unix.
    timezonestringFuseau horaire de l’utilisateur.
    session_idstringID de session. La session inclut l’ensemble des actions effectuées par l’utilisateur dans les 30 minutes ou jusqu’à la fermeture de l’interface de paiement. La session débute dès l’ouverture de l’interface de paiement et elle est enregistrée lors de l’actualisation de la page contenant l’interface de paiement.
    payment_countrystringPays de paiement.
    purchase_invoice_idnumberID de facture de paiement dans le système de Xsolla.
    purchase_external_idstringID de facture de paiement dans le système du partenaire.
    purchase_typestringType d’achat. Valeurs possibles : virtual item, virtual currency, pay2play, subscription.
    purchase_sumnumberMontant nominal de l’achat.
    purchase_currencystringDevise d’achat.
    purchase_skustringSKU de l’objet acheté.
    purchase_digital_content_skustringSKU du package de clés de jeu acheté.
    purchase_descriptionstringDescription de l’achat.
    virtual_currency_amountnumberQuantité de la monnaie virtuelle.
    coupon_codestringCode de coupon.
    subscription_package_external_idnumberID d’abonnement.
    subscription_package_namestringNom de l’abonnement.
    subscription_package_descriptionstringDescription de l’abonnement.
    total_sumnumberMontant total de l’achat. Tous frais inclus.
    total_sum_currencystringDevise du montant total de l’achat.
    user_idstringID utilisateur (v1).
    user_countrystringPays de l’utilisateur.
    payment_instance_namestringNom du mode de paiement.
    Les événements sont liés aux pages sur lesquelles l’utilisateur effectue toutes les actions lors de l’achat d’un objet.
    PhaseDescription
    cartPage avec l’objet sélectionné et une confirmation de l’achat effectué en monnaie virtuelle.
    couponFormulaire d’entrée de coupon.
    giftcardPage avec la liste des cartes-cadeaux (wigget Carte cadeau).
    giftrecipientPage d’achat de cadeaux.
    historyPage d’historique des achats.
    indexPage de service vers laquelle l’utilisateur est redirigé après l’ouverture de l’application. Elle n’est pas visible à l’utilisateur.
    legalVersion mobile de la page avec des liens vers des documents juridiques.
    listListe des modes de paiement.
    paybycashPage avec la liste des modes de paiement pour les achats via les kiosques de paiements (widget Payer en liquide).
    paymentFormulaire de paiement.
    paymentaccountPage avec les comptes de paiement enregistrés.
    paymentreturnPage de service vers laquelle l’utilisateur est redirigé après le paiement, et à partir de laquelle l’utilisateur est redirigé vers la page d’état. Elle n’est pas visible à l’utilisateur.
    pincartPage avec la liste des plateformes de contenu numérique.
    pricepointMagasin de monnaie virtuelle.
    savedmethodListe des modes de paiement enregistrés.
    shippingaddressFormulaire d’adresse de livraison.
    statusPage d’état.
    subscriptionMagasin de plans d’abonnement.
    subscriptionchangeChangement de plan d’abonnement.
    useraccountPage d’informations sur le compte (nom d’utilisateur, solde) avec le paramètre Désactiver l’écran de confirmation pour les futurs achats d’objets.
    userinventoryInventaire utilisateur.
    usermenuVersion mobile de la page du menu utilisateur.
    usersubscriptionGestion des abonnements de l’utilisateur.
    usersubscriptioninfoPage des détails de l’abonnement.
    virtualitemMagasin d’objets virtuels.

    Pour envoyer des événements à vos comptes Google Analytics et Facebook Analytics, vous devez intégrer ces plateformes d’analyse.
    Cet article vous a été utile ?
    Merci !
    Que pouvons-nous améliorer ? Message
    Nous sommes désolés de l'apprendre
    Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
    Merci pour votre commentaire !
    Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
    Dernière mise à jour: 11 Septembre 2024

    Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

    Signaler un problème
    Nous améliorons continuellement notre contenu grâce à vos commentaires.
    Indiquez votre adresse e-mail pour un suivi
    Merci pour votre commentaire !