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.
- Téléchargez le package Unity approprié à 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).
- Compatibilité avec les bitcodes:
GoogleAnalyticsV4_bitcode.unitypackage
- Non compatible avec le bitcode:
GoogleAnalyticsV4.unitypackage
- Compatibilité avec les bitcodes:
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.android.gms.analytics.CampaignTrackingService" /> <receiver android:name="com.google.android.gms.analytics.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 GAv4
Pour configurer le Prefab GAv4:
- Cliquez sur l'objet Prefab
GAv4.prefab
, disponible dans Assets/Plugins/GoogleAnalyticsV4, dans la vue du projet. Faites-le glisser dans la hiérarchie du jeu. - 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 Tracking Code: UA-XXXXXXX-1
iOS Tracking Code: UA-XXXXXXX-2
Other Tracking Code: UA-XXXXXXX-3
Product Name: MyGame
Bundle Identifier: com.example.games
Bundle Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Log Level: VERBOSE
Anonymize IP: false
Uncaught Exception Reporting: false
Send Launch Event: false
Session Timeout: 1800
Dry Run: false
Advertiser Id Support - Send IDFA/AdID: false
Suivre un objet
Après avoir configuré le Prefab GAv4, procédez comme suit pour suivre un objet avec Google Analytics:
- 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 GoogleAnalyticsV4. Exemple :
public GoogleAnalyticsV4 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 GAv4 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.