Comment envoyer des données à Google Analytics 4

Comment ça marche

Lorsque vous recevez des données sur l’activité des utilisateurs et le comportement de Launcher de Google Analytics 4 en tant qu’événements, les données sont envoyées dans la charge utile comme indiqué dans le tableau ci-dessous.

DimensionDescription
Distrubution platformPlateforme utilisée pour ouvrir Launcher.
Valeurs possibles : Xsolla ou Steam.
LanguageLangue de Launcher.
Page titleÉcran du Launcher. Valeurs possibles :Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen ou Custom tab screen.
Platform game IDID du jeu sur la plateforme. Si la plateforme est Xsolla, l’ID de projet dans le Compte éditeur est passé.
Stream nameNom du Launcher.
Launcher project IDID de projet de Launcher issu du Compte éditeur.
Exemple : 147 est un ID de projet dans le Compte éditeur.https://publisher.xsolla.com/72209/projects/173640/new-launcher/147
Login project IDID de projet de connexion.
App versionVersion du Launcher.
Build numberNuméro de build.
Exemple : si la version de Launcher est 3.0.49-latest.1, le numéro de build est 1.
Window sizeTaille de la fenêtre de Launcher.
Exemple : 800x600.
Screen resolutionRésolution de l’écran.
Operating system, Operating system with version, OS version.Agent utilisateur pour la détection du système d’exploitation de l’utilisateur.
Publisher Account game IDID dans le Compte éditeur du jeu auquel le contenu est lié. Le champ sera vide si le contenu n’est pas lié au jeu.
City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent IDDonnées géographiques.
Les tableaux ci-dessous fournissent des détails sur les champs additionnels associés à certains événements. Les événements sortants sont regroupés en fonction de leur catégorie.

Événements généraux

ÉvénementDescription
launcher_startDémarrage de Launcher. Ce message n’est pas envoyé lorsque le lanceur est démarré après une mise à jour.
close_appFermeture de Launcher. Ce message n’est pas envoyé lorsque Launcher est fermé avant la mise à jour.

Événements d'interface

ÉvénementDescription
page_viewL’utilisateur a ouvert un écran de Launcher.
logoutL’utilisateur a cliqué sur Log out.

Événements de mise à jour de Launcher

ÉvénementDescription
launcher_update_check_startLauncher commence à vérifier les mises à jour.
launcher_update_check_completeLauncher a fini la vérification des mises à jour. Le champ supplémentaire value prend la valeur update_found si une version plus récente a été trouvée sur le CDN. Sinon, il prend la valeur no_updates.
launcher_update_check_skipL’utilisateur a ignoré la mise à jour de Launcher.
launcher_update_download_startLauncher a commencé le téléchargement de la mise à jour.
launcher_update_download_completeLauncher a terminé le téléchargement de la mise à jour.
launcher_update_startLauncher a terminé la mise à jour.
launcher_update_completeLauncher a été mis à jour avec succès.

Événements liés à la propriété du jeu

ÉvénementDescription
purchaseChangement de statut d’un achat. Champs supplémentaires :
  • currency — code de devise à trois lettres selon la norme ISO 4217.
  • value — montant nominal de l’achat.
  • transaction_id — ID de paiement dans le système Xsolla.
  • coupon — code de coupon.
  • itemsparamètres de l’objet.

Événements de contenu

ÉvénementDescription
content_viewPlus de 75 % du contenu a été affiché. L’événement n’est pas envoyé pour les contenus ayant le statut group. Champs supplémentaires :
  • content_name — ID de contenu.
  • content_name — nom de contenu.
  • content_type — type de contenu.
  • banner_type — type de bannière.
  • target_game_id — ID issu du Compte éditeur ou un AppID Steam auquel le lien mène.
  • content_link — adresse URL si le type de contenu est un lien ou une vidéo.
content_clickL’utilisateur a cliqué sur un élément du contenu.

Événements d'autorisation

ÉvénementDescription
loginL’utilisateur a été authentifié avec succès dans Launcher. Champs supplémentaires :
  • auth_type — option d’authentification.
  • method — réseau social utilisé pour l’authentification.

Comment configurer

  1. Inscrivez-vous à Google Analytics et connectez-vous à votre compte.
  2. Créez et modifiez les dimensions personnalisées dans Google Analytics comme indiqué dans le tableau ci-dessous.
ChampDimensionScopeDescription
analytics_target_game_idAnalytics Target Game IDEventID dans le Compte éditeur ou AppID Steam du jeu vers lequel le lien redirige
auth_typeAuth TypeEventOption d’authentification passée dans le JWT. Valeurs possibles :
  • social — connexion via les réseaux sociaux.
  • phone — connexion sans mot de passe à l’aide d’un code à usage unique envoyé à un numéro de téléphone.
  • email — connexion sans mot de passe à l’aide d’un code à usage unique envoyé par e-mail.
  • xsolla_login — connexion classique par nom d’utilisateur/adresse e-mail et mot de passe utilisant le stockage de données Xsolla Login.
  • firebase — connexion classique par nom d’utilisateur/adresse e-mail et mot de passe utilisant le stockage de données Firebase.
  • playfab — connexion classique par nom d’utilisateur/adresse e-mail et mot de passe utilisant le stockage de données Playfab.
  • proxy — connexion classique par nom d’utilisateur/adresse e-mail et mot de passe utilisant le stockage de données personnalisé.
  • device — connexion par ID d’appareil.
  • server_custom_id — connexion par custom ID (ID utilisateur généré du côté de votre serveur).
content_idContent IDEventID de la tuile de contenu.
content_linkContent LinkEventAdresse URL si le type de contenu est un lien ou une vidéo.
content_nameContent NameEventNom de la tuile de contenu en anglais.
content_typeContent TypeEventType de contenu. Valeurs possibles : news, link internal, link external ou video.
distribution_platformDistribution PlatformEventPlateforme utilisée pour ouvrir Launcher.
Valeurs possibles : Xsolla ou Steam.
game_nameGame NameEventNom du jeu en anglais.
game_platformGame PlatformEventPlateforme de jeu. Valeurs possibles : Xsolla ou Steam.
build_numberLauncher Build NumberEventNuméro de build.
Exemple : si la version de Launcher est 3.0.49-latest.1, le numéro de build est 1.
launcher_project_idLauncher Project IDEventID de projet de Launcher issu du Compte éditeur.
Exemple : 147 est un ID de projet dans le Compte éditeur.https://publisher.xsolla.com/72209/projects/173640/new-launcher/147
app_versionLauncher VersionEventVersion du code de Launcher.
Exemple : si la version de Launcher est 3.0.49-latest.1, la version du code est 3.0.49-latest.
login_project_idLogin Project IDEventID de projet de connexion.
platform_game_idPlatform Game IDEventID du jeu sur la plateforme. Si la plateforme est Xsolla, l’ID de projet dans le Compte éditeur est passé.
publisher_account_game_idPublisher Account Game IDEventID dans le Compte éditeur du jeu auquel le contenu est lié. Le champ sera vide si le contenu n’est pas lié au jeu.
target_game_idTarget Game IDEventID dans le Compte éditeur ou AppID Steam du jeu vers lequel le lien redirige
window_sizeWindow SizeEventTaille de la fenêtre de Launcher.
Exemple : 800x600.
  1. Dans le menu latéral, cliquez sur Admin.
  2. Créez une propriété Google Analytics 4.
  3. Ajoutez un flux de données :
    1. Sélectionnez le type Web ;
    2. Dans le champ URL, entrez une adresse URL quelconque.
  4. Copiez la valeur du champ Measurement ID dans les paramètres du flux de données.
  5. Ouvrez votre projet dans le Compte éditeur.
  6. Dans le menu latéral, cliquez sur Launcher.
  7. Trouvez le Launcher sur le dashboard et cliquez sur Edit launcher.
  8. Accédez à Settings > General information > Analytics.
  9. Collez le Measurement ID dans le champ Google Analytics 4 Measurement ID.
  10. Cliquez sur Save changes.
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: 22 Janvier 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 !