Ten przewodnik po migracji zawiera opis nowości w wersji 2 pakietu SDK oraz wskazówki dla deweloperów dotyczące przejścia z implementacji 1.x. Deweloperzy, którzy nie muszą przeprowadzać migracji z implementacji w wersji 1.x, mogą już teraz rozpocząć korzystanie z wersji 2.
Wstęp
Niedawno udostępniliśmy zaktualizowany pakiet SDK Google Analytics na Androida w wersji 2. Wersja 2 tego pakietu SDK zawiera obsługę nowych funkcji i nowy interfejs raportowania zaprojektowany specjalnie z myślą o programistach aplikacji.
Wszystkim obecnym deweloperom Google Analytics zalecamy przejście na wersję 2 pakietu SDK Google Analytics na Androida, aby korzystać z nowych funkcji i raportów.
Nowości w wersji 2
Pakiet SDK Google Analytics na Androida w wersji 2 udostępnia nowe funkcje raportowania, nowe, zaawansowane wymiary i dane oraz wiele innych funkcji. Oto co deweloperzy zyskują w wersji 2:
- Bardziej przydatne raporty dla deweloperów aplikacji
- Raporty standardowe zostały zaprojektowane od nowa z myślą o deweloperach aplikacji – dodaliśmy nowe raporty, np. Przepływ zaangażowania i Źródła Google Play, dzięki którym deweloperzy zyskają więcej informacji o pozyskiwaniu użytkowników i ich doświadczeniach. Zapoznaj się ze sprawdzonymi metodami konfigurowania konta, aby dowiedzieć się, jak najlepiej skonfigurować usługę pod kątem wersji 2.
- Nowe wymiary i dane związane z aplikacjami
- W wersji 2 pakietu SDK wprowadziliśmy nowe wymiary i dane związane z aplikacjami, w tym nazwa ekranu, widoki ekranu, nazwa aplikacji, wersja aplikacji i wiele innych.
- Pomiar liczby awarii i wyjątków
- Pakiet SDK Google Analytics na Androida wprowadza pomiar wyjątków i rodzaj działania wyjątku. Korzystając z pomiaru wyjątków, możesz mierzyć liczbę i rodzaje awarii oraz niekrytyczne wyjątki. Aby dowiedzieć się, jak wdrożyć pomiar wyjątków, zapoznaj się z przewodnikiem dla programistów dotyczącym wyjątków.
- Wymiary i dane niestandardowe
- Twórz wymiary niestandardowe, aby segmentować dane na nowe sposoby. Więcej informacji o wymiarach i danych niestandardowych
- Pomiar interakcji społecznościowych
- Uzyskaj lepszy wgląd w wartość mediów społecznościowych w Twojej aplikacji dzięki pomiarowi interakcji użytkowników z osadzonymi wtyczkami i widżetami społecznościowymi. Więcej informacji o mierzeniu interakcji społecznościowych
Zanim zaczniesz
Przed rozpoczęciem migracji deweloperzy powinni wykonać te 2 kroki:
- Pobierz Google Analytics SDK na Androida w wersji 2
- Utwórz widok (profil) aplikacji, którego będziesz używać do uzyskiwania dostępu do nowych raportów i danych dotyczących aplikacji.
Po wykonaniu powyższych czynności wykonaj podane niżej kroki odpowiadającej Ci ścieżce migracji.
Migracja z EasyTracker
Aby przenieść aplikację z biblioteki EasyTracker z wersji 1 do 2, należy wykonać trzy czynności:
- Aktualizowanie parametrów w pliku zasobów GoogleAnalytics.xml
- Nazwy metod aktualizacji
- Aktualizowanie odbiornika (śledzenie kampanii w Google Play)
1. Aktualizuj parametry w pliku GoogleAnalytics.xml
Podczas migracji do wersji 2 zaktualizuj parametry w pliku zasobów GoogleAnalytics.xml, ponieważ niektóre z nich uległy zmianie od wersji 1.x i od wersji 2 zostały dodane nowe parametry.
W tabeli poniżej znajdziesz parametry zaktualizowane w wersji 2:
| Nazwa parametru v1.x | Nazwa parametru wersja 2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | wycofano |
Aby dowiedzieć się więcej, zobacz nowe i zaktualizowane parametry EasyTracker.
2. Nazwy metod aktualizacji
Chociaż w większości części składni nic się nie zmienia w wersji 2 rozwiązania EasyTracker, występują pewne istotne różnice w nazwach metod i składni, które wymagają aktualizacji implementacji:
trackPageView():sendView()w wersji 2. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym śledzenia ekranu.- Implementacja e-commerce została uproszczona. Dowiedz się, jak wdrożyć pomiar e-commerce w wersji 2
- Zmienne niestandardowe zostały zastąpione przez wymiary i dane niestandardowe. Trzeba zaktualizować wszystkie wywołania funkcji
setCustomVar(), by korzystały z tej nowej funkcji. Więcej informacji o implementowaniu niestandardowych wymiarów i danych
3. Aktualizowanie odbiornika transmisji (śledzenie kampanii w Google Play)
Deweloperzy, którzy wdrożyli śledzenie kampanii w Google Play za pomocą wersji 1.x, powinni zwrócić uwagę, że zmieniła się ścieżka klasy odbiorcy. Więcej informacji znajdziesz w Przewodniku po śledzeniu kampanii w Google Play.
Migracja z implementacji niestandardowej
Jeśli nie używasz biblioteki EasyTracker w wersji 1.x pakietu Analytics SDK na Androida, zalecamy rozpoczęcie korzystania z EasyTracker w wersji 2.
Biblioteka EasyTracker jest teraz częścią pakietu SDK i jest zalecana dla wszystkich deweloperów. Zacznij korzystać z EasyTracker w pakiecie SDK Google Analytics w wersji 2.
Jeśli masz zaawansowane potrzeby w zakresie zbierania danych, np. używasz kilku identyfikatorów usługi w ramach jednej implementacji, przeczytaj Przewodnik po konfiguracji zaawansowanej, aby dowiedzieć się więcej o korzystaniu z zaawansowanych funkcji pakietu SDK w wersji 2.x.