Google Analytics-Plug-in für Unity v3 (alte Version) – 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:

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.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>
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.

GAv3-Voreinstellungen konfigurieren

Führen Sie die folgenden Schritte aus, um die GAv3-Voreinstellung zu konfigurieren:

  1. Klicken Sie auf das Prefab-Objekt GAv3.prefab, das Sie in der Projektansicht unter Assets/Plugins/GoogleAnalyticsV3 finden.
  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 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
  3. Ziehen Sie das ausgefüllte GAv3 aus der Projektansicht nach oben in die Objekthierarchie.

Objekte verfolgen

Nachdem Sie die GAv3-Voreinstellung konfiguriert haben, können Sie mit dem Tracking eines Objekts mit Google Analytics beginnen. Gehen Sie dazu so vor:

  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 GoogleAnalyticsV3-Objekt enthält. Beispiel: 
    public GoogleAnalyticsV3 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 GAv3-Objekt aus der Ansicht Objekthierarchie auf das Feld.
  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