Plug-in Google Analytics pour Unity – Guide du développeur

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:

Installation et configuration

Choisissez une plate-forme pour les détails de la configuration:

Android
  1. 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/.
  2. 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" />
  3. 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>
iOS
  1. Ajoutez les bibliothèques suivantes à votre projet Xcode :
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 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.
  3. 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:

  1. 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.
  2. 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:

  1. 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.
  2. Créez une variable publique dans la classe pour contenir l'objet GoogleAnalyticsV4. Exemple : 
    public GoogleAnalyticsV4 googleAnalytics;
  3. Enregistrez le script et revenez à la fenêtre Unity.
  4. 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.
  5. 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

Ressources