Ce document explique des concepts importants concernant l'utilisation du plug-in Google Analytics pour Unity.
Avant de commencer
Avant de commencer, assurez-vous d'avoir effectué les opérations suivantes:
- Vous devez disposer d'au moins une propriété Google Analytics et une vue (profil) à laquelle envoyer les données de votre jeu.
- Si vous souhaitez effectuer le suivi des transactions e-commerce, activez l'e-commerce dans vos rapports.
- Téléchargez googleanalyticsv3.unitypackage à partir du dépôt du plug-in Google Analytics pour Unity et importez-le dans votre projet Unity (vous devriez pouvoir le faire en double-cliquant sur le fichier).
Installation et configuration
Choisissez une plate-forme pour les détails de la configuration:
- Si votre projet ne contient pas encore de fichier nommé AndroidManifest.xml dans le répertoire <YOUR PROJECT ROOT>/Assets/Plugins/Android/, créez le projet pour Android, puis copiez le fichier AndroidManifest.xml à partir du répertoire Temp/StagingArea/ (il se trouve dans le répertoire que vous avez choisi de créer). Collez-le dans <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
- Ajoutez les autorisations suivantes au fichier AndroidManifest.xml dans <YOUR PROJECT ROOT> /Assets/Plugins/Android/ au-dessus de la balise
<application>
:<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- Si vous souhaitez activer le suivi des campagnes, ajoutez le service comme suit :
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" /> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
Ajoutez les bibliothèques suivantes à votre projet Xcode :
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- Si vous préférez que les bibliothèques soient ajoutées automatiquement lors de la compilation pour iOS, copiez le fichier PostProcessBuildPlayer_GA à partir du répertoire iOS Extras et placez-le dans le répertoire <YOUR PROJECT ROOT>/Assets/Editor.
- Téléchargez le mod_pbxproj.py script et copiez-le dans le répertoire Editor (Éditeur). Les bibliothèques seront désormais ajoutées automatiquement lors de la compilation.
Configurer le Prefab GAv3
Pour configurer le Prefab GAv3, procédez comme suit:
- Cliquez sur l'objet Prefab
GAv3.prefab
, disponible dans Assets/Plugins/GoogleAnalyticsV3, dans la vue du projet. - La vue de l'inspecteur affiche un composant de script associé au Prefab avec plusieurs propriétés répertoriées.
Renseignez ces propriétés avec les valeurs appropriées pour votre projet. Cette action renseignera l'objet afin qu'il puisse être utilisé partout dans votre projet. Exemple :
Android Property ID: UA-XXXXXXX-1
iOS Property ID: UA-XXXXXXX-2
Other Property ID: UA-XXXXXXX-3
App Name: MyGame
Bundle ID: com.example.games
App Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Debug Mode: VERBOSE
Anonymize IP: false
Dry Run: false
- Faites glisser le GAv3 renseigné de la vue du projet vers le haut, dans la hiérarchie des objets.
Suivre un objet
Après avoir configuré le Prefab GAv3, vous pouvez commencer à suivre un objet à l'aide de Google Analytics en procédant comme suit:
- Identifiez un objet GameObject à suivre (par exemple, un objet "Player") et cliquez dessus dans la vue Object Hierarchy (Hiérarchie des objets). Si aucun script n'est déjà associé à l'objet dont vous souhaitez effectuer le suivi, créez un script à l'aide du bouton Add Component (Ajouter un composant) dans la vue de l'inspecteur.
- Créez une variable publique dans la classe pour contenir l'objet GoogleAnalyticsV3. Exemple :
public GoogleAnalyticsV3 googleAnalytics;
- Enregistrez le script et revenez à la fenêtre Unity.
- Dans la vue de l'inspecteur du GameObject dont vous souhaitez effectuer le suivi, vous verrez le script que vous avez créé et un champ à renseigner intitulé "Google Analytics" (ou le nom de variable que vous avez choisi). Faites glisser l'objet GAv3 de la vue Hiérarchie des objets vers le champ.
- Vous êtes maintenant prêt à lancer le suivi de cet objet GameObject. Répétez le processus pour les autres objets que vous souhaitez suivre à l'aide du même Prefab.
Étapes suivantes
- Consultez la documentation de référence de l'API pour savoir quels types d'appels vous pouvez envoyer à Google Analytics.
- Consultez le Guide de mise en œuvre des applications mobiles pour découvrir comment mesurer les interactions des utilisateurs et répondre aux questions sur l'utilisation des jeux à l'aide de Google Analytics.