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
- Mit Bitcode-Unterstützung:
Einrichtung und Konfiguration
Wählen Sie eine Plattform für Konfigurationsdetails aus:
- 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.
- 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" />
- 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>
-
Fügen Sie Ihrem Xcode-Projekt die folgenden Bibliotheken hinzu:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- 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.
- 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.
GAv4-Voreinstellungen konfigurieren
So konfigurieren Sie die GAv4-Voreinstellung:
- Klicken Sie auf das Prefab-Objekt
GAv4.prefab
, das Sie in der Projektansicht unter Assets/Plugins/GoogleAnalyticsV4 finden. Ziehen Sie dies in die Spielhierarchie. - 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
Objekte verfolgen
Nachdem Sie die Voreinstellung GAv4 konfiguriert haben, können Sie ein Objekt mit Google Analytics erfassen:
- 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.
- Erstellen Sie eine öffentliche Variable in der Klasse, die das GoogleAnalyticsV4-Objekt enthält. Beispiel:
public GoogleAnalyticsV4 googleAnalytics;
- Speichern Sie das Skript und kehren Sie zum Unity-Fenster zurück.
- 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.
- 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.