In dieser Migrationsanleitung werden die Neuerungen in Version 2 des SDK beschrieben und Entwickler erhalten Tipps für die Migration von einer v1.x-Implementierung. Entwickler, die keine Migration von einer v1.x-Implementierung benötigen, können jetzt mit Version 2 starten.
Einleitung
Google Analytics hat vor Kurzem das aktualisierte Google Analytics SDK für Android Version 2 veröffentlicht. Version 2 des SDK unterstützt neue Funktionen und eine neue Oberfläche zur Berichterstellung, die speziell für App-Entwickler entwickelt wurde.
Wir empfehlen allen Google Analytics-Entwicklern, zu Version 2 des Google Analytics SDK for Android zu migrieren, damit sie von den neuen Funktionen und Berichten profitieren können.
Neu in Version 2
Mit Version 2 des Google Analytics SDK für Android stehen neue Berichtsfunktionen für App-Entwickler sowie leistungsstarke neue Dimensionen und Messwerte zur Verfügung. Version 2 bietet Entwicklern folgende Vorteile:
- Leistungsfähigere Berichte für App-Entwickler
- Die Standardberichte wurden für App-Entwickler neu gestaltet. Sie enthalten neue Berichte wie „Interaktionsfluss“ und „Google Play-Quellen“, um Entwicklern neue Einblicke in die Nutzerakquise und die Nutzerfreundlichkeit zu bieten. In unseren Best Practices für die Kontokonfiguration erfahren Sie, wie Sie Ihre Property am besten für Version 2 konfigurieren.
- Neue App-Dimensionen und -Messwerte
- Mit Version 2 des SDKs wurden neue app-spezifische Dimensionen und Messwerte eingeführt, darunter „Bildschirmname“ und „Bildschirmaufrufe“, „App-Name“ und „App-Version“.
- Abstürze und Ausnahmen messen
- Das Google Analytics SDK for Android führt die Ausnahmemessung und den Ausnahmetreffertyp ein. Mit der Ausnahmemessung können Sie die Anzahl und Art der Abstürze und nicht schwerwiegenden Ausnahmen messen. Informationen zum Implementieren der Ausnahmemessung finden Sie im Entwicklerleitfaden zu Ausnahmen.
- Benutzerdefinierte Dimensionen und Messwerte
- Benutzerdefinierte Dimensionen erstellen, um Ihre Daten auf neue Art und Weise zu segmentieren. Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten.
- Soziale Interaktionen messen
- Gewinnen Sie neue Erkenntnisse über den Wert sozialer Interaktionen in Ihrer App, indem Sie Nutzerinteraktionen mit eingebetteten Plug-ins und Widgets für soziale Netzwerke messen. Weitere Informationen zum Messen sozialer Interaktionen
Vorbereitung
Alle Entwickler sollten diese beiden Schritte unternehmen, bevor sie mit der Migration beginnen:
- Google Analytics SDK for Android (Version 2) herunterladen
- Erstellen Sie eine App-Datenansicht (Profil), mit der Sie auf Ihre neuen App-Berichte und -Daten zugreifen.
Nachdem Sie die oben genannten Schritte ausgeführt haben, führen Sie die folgenden Schritte für Ihren Migrationspfad aus.
Migration von EasyTracker
Führen Sie drei Schritte aus, um Ihre App von Version 1 zu Version 2 der EasyTracker-Bibliothek zu migrieren:
- Parameter in der Ressourcendatei „GoogleAnalytics.xml“ aktualisieren
- Methodennamen aktualisieren
- Broadcast-Empfänger aktualisieren (Google Play-Kampagnen-Tracking)
1. Parameter in GoogleAnalytics.xml aktualisieren
Aktualisieren Sie bei der Migration zu Version 2 die Parameter in Ihrer GoogleAnalytics.xml-Ressourcendatei, da sich einige seit Version 1.x geändert haben und in Version 2 neue Parameter hinzugefügt wurden.
Die folgende Tabelle zeigt die Parameter, die in Version 2 aktualisiert wurden:
| v1.x-Parametername | v2.x-Parametername |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | Verworfen |
Weitere Informationen zu den neuen und aktualisierten EasyTracker-Parametern
2. Methodennamen aktualisieren
Obwohl ein Großteil der Syntax in Version 2 von EasyTracker unverändert bleibt, gibt es einige erhebliche Unterschiede bei Methodennamen und Syntax, die eine Aktualisierung Ihrer Implementierung erforderlich machen:
trackPageView()ist in Version 2sendView(). Weitere Informationen finden Sie im Entwicklerleitfaden für Bildschirm-Tracking.- Die E-Commerce-Implementierung wurde vereinfacht. Weitere Informationen zur Implementierung der E-Commerce-Messung in Version 2
- Benutzerdefinierte Variablen wurden durch benutzerdefinierte Dimensionen und Messwerte ersetzt. Alle Aufrufe von
setCustomVar()sollten aktualisiert werden, um die neue Funktion nutzen zu können. Informationen zum Implementieren benutzerdefinierter Dimensionen und Messwerte.
3. Broadcast-Empfänger aktualisieren (Google Play-Kampagnen-Tracking)
Entwickler, die das Google Play-Kampagnen-Tracking mit Version 1.x implementiert haben, sollten beachten, dass sich der Klassenpfad des Empfängers geändert hat. Weitere Informationen finden Sie im Leitfaden zum Kampagnen-Tracking bei Google Play.
Von einer benutzerdefinierten Implementierung migrieren
Wenn Sie die EasyTracker-Bibliothek in Version 1.x des Analytics SDK for Android nicht verwendet haben, empfehlen wir Ihnen, EasyTracker in Version 2 zu verwenden.
Die EasyTracker-Bibliothek ist jetzt im SDK enthalten und wird für alle Entwickler empfohlen. Erste Schritte mit EasyTracker im Google Analytics SDK Version 2.
Wenn Sie erweiterte Anforderungen an die Datenerhebung haben und beispielsweise mehrere Property-IDs in einer einzelnen Implementierung verwenden möchten, lesen Sie den Leitfaden für erweiterte Konfiguration, um mehr über die erweiterten Funktionen von Version 2.x des SDK zu erfahren.