W tym przewodniku dla programistów opisujemy, jak wdrażać niestandardowe wymiary i dane za pomocą pakietu SDK Google Analytics na Androida w wersji 3.
Przegląd
Wymiary niestandardowe umożliwiają powiązanie metadanych z działaniami, użytkownikami i sesjami w Google Analytics, a dane niestandardowe umożliwiają tworzenie i zwiększanie własnych danych w Google Analytics.
- Skonfiguruj niestandardowe wymiary lub dane w interfejsie internetowym Google Analytics. Więcej informacji o konfigurowaniu wymiarów lub danych niestandardowych (Centrum pomocy)
- Ustawiaj i wysyłaj wartości niestandardowych wymiarów i danych z aplikacji.
Niestandardowe wymiary i dane składają się z 2 pól:
-
Integer
Indeks – indeks niestandardowego wymiaru lub rodzaju danych. Ten indeks ma wartość 1. -
String
Wartość – wartość wymiaru niestandardowego lub danych niestandardowych. W tym przypadku wskaźniki będą analizowane jako liczba całkowita lub ułamek dziesiętny o stałej wartości, jeśli dane są skonfigurowane na potrzeby typu waluty.
Ustawianie i wysyłanie wartości
Aby ustawić i wysłać wartość wymiaru niestandardowego:
// May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once, so it is set on the Map, // not the tracker. easyTracker.send(MapBuilder .createAppView("Home screen") .set(Fields.customDimension(1), "premiumUser"); .build() );
Wartości wymiarów niestandardowych mogą być przesyłane z dowolnym typem działania Google Analytics, m.in. z wyświetleniami ekranu, zdarzeniami, transakcjami e-commerce, czasem działań użytkowników i interakcjami społecznościowymi. Zdefiniowany zakres wymiaru niestandardowego określi w trakcie przetwarzania, które działania będą powiązane z jego wartością.
Aby ustawić i przesłać wartość danych niestandardowych:
// May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(); // Set the custom metric to be incremented by 5 using its index. easyTracker.set(Fields.customMetric(1), 5); // Custom metric value sent is with this screen view. easyTracker.send(MapBuilder .createAppView("Home screen") .build() );
Uwagi o wdrażaniu
W tej sekcji znajdziesz dodatkowe informacje, o których należy pamiętać przy wdrażaniu niestandardowych wymiarów lub danych.
Uwagi dotyczące wymiarów niestandardowych
Wartości z zakresami na poziomie użytkownika i sesji mają zastosowanie do wcześniejszych działań
- Wartości wymiaru niestandardowego z zakresem na poziomie użytkownika lub sesji zostaną zastosowane do wszystkich działań w bieżącej sesji, w tym do wcześniejszych działań. Jeśli nie chcesz, aby wartość wymiaru niestandardowego z zakresem na poziomie sesji lub użytkownika była stosowana do wcześniejszych działań w bieżącej sesji, rozpocznij nową sesję przed zastosowaniem tej wartości do działania.
- Jeśli np. używasz typu członkostwa jako wymiaru niestandardowego na poziomie użytkownika, a użytkownik zmieni członkostwo w trakcie sesji, przed ustawieniem nowej wartości wymiaru niestandardowego możesz chcieć rozpocząć nową sesję. Dzięki temu działania sprzed uaktualnienia zostaną powiązane ze starą wartością członkostwa, a nowe działania – z nową wartością.
Wymiary niestandardowe i filtry widoków (profili)
- Wartości niestandardowego wymiaru na poziomie użytkownika lub sesji będą nadal stosowane do wszystkich działań w bieżącej i/lub przyszłych sesjach nawet wtedy, gdy działanie, z którym są wysyłane, zostało odfiltrowane z widoku (profilu) .
- Podczas filtrowania według wartości wymiaru niestandardowego działania są filtrowane według zakresu tej wartości. Więcej informacji o współdziałaniu filtrów i wartości wymiarów niestandardowych podczas przetwarzania danych.
Uwagi dotyczące danych niestandardowych
Wartości danych niestandardowych są agregowane w raportach
- Wartości niestandardowych danych są agregowane w raportach tak jak inne wstępnie zdefiniowane wskaźniki w Google Analytics. W związku z tym ustawisz wartość danych niestandardowych na
1
, aby zwiększyć łączną sumę tych danych w raportach.
Niestandardowe dane i filtry widoków (profili)
- Mimo że wartości danych niestandardowych można zwykle ustawić w dowolnym momencie, unikaj ustawiania niestandardowych wartości dla działań, które prawdopodobnie zostaną odfiltrowane z Twoich widoków (profili). Jeśli działanie zostanie odfiltrowane przez filtr widoku danych (profilu), wszelkie powiązane wartości danych niestandardowych też zostaną odfiltrowane. Więcej informacji o niestandardowych wymiarach i danych oraz filtrach widoków (profili).
Ustawianie wartości przy użyciu automatycznego pomiaru ekranu
- Aby zastosować wartość wymiaru niestandardowego do wyświetlenia ekranu przesłanego przez automatyczny pomiar ekranu przez EasyTracker, ustaw wartość przed wywołaniem funkcji
activityStart()
podczasonStart()
. Jeśli w momencie wykonywania funkcjionStart()
wartość nie jest znana, zalecamy ręczny pomiar ekranu.
Nie wysyłaj jako wartości informacji umożliwiających identyfikację osób
- Warunki korzystania z usługi Google Analytics zabraniają wysyłania do serwerów Google Analytics żadnych informacji umożliwiających identyfikację osób. Więcej informacji znajdziesz w Warunkach korzystania z usługi.