Google Analytics-Plug-in für Unity – Entwicklerleitfaden

In diesem Dokument werden wichtige Konzepte zur Verwendung des Google Analytics-Plug-ins für Unity erläutert.

Hinweis

Bevor Sie beginnen, sollten Sie die folgenden Schritte ausführen:

• Sie benötigen mindestens eine Google Analytics-Property und eine Datenansicht (Profil), an die Daten von Ihrem Spiel gesendet werden.
• Laden Sie das entsprechende Unity-Paket aus dem Repository für das Google Analytics-Plug-in für Unity herunter und importieren Sie es in Ihr Unity-Projekt. Klicken Sie dazu doppelt auf die Datei.
  • Mit Bitcode-Unterstützung: GoogleAnalyticsV4_bitcode.unitypackage
  • Keine Bitcode-Unterstützung: GoogleAnalyticsV4.unitypackage

Einrichtung und Konfiguration

Wählen Sie eine Plattform für Konfigurationsdetails aus:

Android

1. Falls Ihr Projekt noch keine Datei namens AndroidManifest.xml im Verzeichnis <YOUR PROJECT ROOT>/Assets/Plugins/Android/ hat, erstellen Sie das Projekt für Android und kopieren Sie dann die Datei AndroidManifest.xml aus dem Verzeichnis Temp/StagingArea/. Sie befindet sich in dem Verzeichnis, in dem Sie die App erstellen möchten. Fügen Sie ihn in <YOUR PROJECT ROOT>/Assets/Plugins/Android/ ein.
2. Fügen Sie der Datei AndroidManifest.xml in <YOUR PROJECT ROOT> /Assets/Plugins/Android/ über dem <application>-Tag die folgenden Berechtigungen hinzu:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
         

3. Wenn Sie das Kampagnen-Tracking aktivieren möchten, fügen Sie den Dienst so hinzu:

   <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. Fügen Sie Ihrem Xcode-Projekt die folgenden Bibliotheken hinzu:
   • AdSupport.framework
   • CoreData.framework
   • SystemConfiguration.framework
   • libz.dylib
   • libsqlite3.dylib
2. Wenn die Bibliotheken beim Erstellen für iOS automatisch hinzugefügt werden sollen, kopieren Sie die Datei PostProcessBuildPlayer_GA aus dem Verzeichnis iOS Extras und speichern Sie sie im Verzeichnis <YOUR PROJECT ROOT>/Assets/Editor.
3. Laden Sie das Skript mod_pbxproj.py herunter und kopieren Sie es in das Verzeichnis Editor. Die Bibliotheken werden jetzt während des Builds automatisch hinzugefügt.

Hinweis: libsqlite3.dylib ist nur erforderlich, wenn in Xcode das Verknüpfungs-Flag -ObjC verwendet wird. Wenn Sie dieses Flag nicht verwenden, kann es problemlos aus der Datei PostProcessBuildPlayer_GA entfernt werden.

GAv4-Voreinstellungen konfigurieren

So konfigurieren Sie die GAv4-Voreinstellung:

1. Klicken Sie auf das Prefab-Objekt GAv4.prefab, das Sie in der Projektansicht unter Assets/Plugins/GoogleAnalyticsV4 finden. Ziehen Sie dies in die Spielhierarchie.
2. In der Inspector-Ansicht wird eine Skriptkomponente angezeigt, die an die Voreinstellung angehängt ist und mehrere Eigenschaften enthält. Geben Sie in diese Attribute die richtigen Werte für Ihr Projekt ein. Dadurch wird das Objekt automatisch ausgefüllt, sodass es überall im Projekt verwendet werden kann. Beispiel:
   • 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

Hinweis: Sie können für alle Plattformen dieselbe Property-ID verwenden. Weitere Informationen finden Sie unter Best Practices zur Einrichtung von Analytics für mobile Apps.

Objekte verfolgen

Nachdem Sie die Voreinstellung GAv4 konfiguriert haben, können Sie ein Objekt mit Google Analytics erfassen:

1. Wählen Sie ein GameObject aus, das Sie verfolgen möchten (z. B. ein Spielerobjekt), und klicken Sie in der Ansicht Objekthierarchie darauf. Wenn Sie dem Objekt, das Sie verfolgen möchten, noch kein Skript angehängt haben, erstellen Sie in der Inspector-Ansicht mit der Schaltfläche Komponente hinzufügen ein neues Skript.
2. Erstellen Sie eine öffentliche Variable in der Klasse, die das GoogleAnalyticsV4-Objekt enthält. Beispiel:

   public GoogleAnalyticsV4 googleAnalytics;

3. Speichern Sie das Skript und kehren Sie zum Unity-Fenster zurück.
4. In der Inspector-Ansicht des GameObject, das Sie erfassen möchten, sehen Sie das von Ihnen erstellte Skript und ein Feld namens Google Analytics (oder den von Ihnen ausgewählten Variablennamen). Ziehen Sie das GAv4-Objekt aus der Ansicht Objekthierarchie auf das Feld.
   Wenn das Feld zum Hinzufügen der GAv4-Vorabversion nicht angezeigt wird, prüfen Sie, ob Ihr Script keine Kompilierungsfehler enthält. Der Inspector wird nicht aktualisiert, wenn Fehler vorliegen.
5. Sie können jetzt mit dem Tracking dieses GameObject beginnen. Wiederholen Sie den Vorgang für andere Objekte, die Sie mit derselben Fertigung verfolgen möchten.

Nächste Schritte

• In der API-Referenz erfahren Sie, welche Arten von Treffern an Google Analytics gesendet werden können.
• Im Implementierungsleitfaden für mobile Apps erfahren Sie, wie Sie mit Google Analytics Nutzerinteraktionen messen und Fragen zur Nutzung von Spielen beantworten können.

Ressourcen

• Problembehebung
• Problem melden
• Hilfe
• Änderungsprotokoll