W tym przewodniku dla programistów opisujemy, jak wdrażać niestandardowe wymiary i dane za pomocą pakietu SDK Google Analytics na Androida w wersji 2.
Przegląd
Gdy ustawisz wartość niestandardowych wymiarów lub danych za pomocą pakietu SDK Google Analytics na Androida, ta wartość jest wysyłana jako parametr z kolejnym wysyłanym działaniem. Wartości te można stosować do dowolnego typu działań Google Analytics, w tym do wyświetleń ekranu, zdarzeń, transakcji e-commerce, czasu działań użytkowników i interakcji społecznościowych.
Wymiary i dane niestandardowe trzeba wdrożyć w 2 etapach:
- Zdefiniuj niestandardowe wymiary lub dane w interfejsie internetowym Google Analytics.
Indeks, nazwę i zakres niestandardowych wymiarów lub danych możesz ustawić w ustawieniach usługi w interfejsie internetowym.
Dowiedz się, jak definiować wymiary lub dane niestandardowe - Zaimplementuj kod do ustawiania i zbierania wartości niestandardowych wymiarów i danych.
Dodaj kod do aplikacji, aby ustawić wartości niestandardowych wymiarów lub danych dla działań Google Analytics według indeksów zdefiniowanych w poprzednim kroku.
W pozostałej części tego artykułu opisujemy, jak wdrożyć kod, by ustawiać i wysyłać wartości niestandardowych wymiarów lub danych do Google Analytics.
Wymiary niestandardowe
Wartości wymiarów niestandardowych można ustawiać dla wszystkich typów działań Google Analytics. Ustaw wartość wymiaru niestandardowego tuż przed wywołaniem wysyłania, do którego chcesz ją zastosować.
Zdefiniowany zakres wymiaru niestandardowego będzie określać w momencie przetwarzania, które dodatkowe działania mogą zostać powiązane z tą wartością.
Te pola są niezbędne do ustawienia wartości wymiaru niestandardowego:
-
Integer
Indeks – indeks definicji wymiaru niestandardowego. Ten indeks ma wartość 1. -
String
Wartość – wartość wymiaru niestandardowego.
Ustawianie wartości wymiaru niestandardowego
Aby ustawić wartość wymiaru niestandardowego, wywołaj funkcję
setCustomDimension
przed wywołaniem wysyłania, z którym chcesz powiązać tę wartość:
// Get the tracker object. Tracker tracker = EasyTracker.getTracker(); // Set the dimension value for index 1. tracker.setCustomDimension(1, "myValue"); // Dimension value is associated and sent with this hit. tracker.sendView();
Uwagi o wdrażaniu
W tej sekcji znajdziesz dodatkowe informacje, o których należy pamiętać przy wdrażaniu wymiaru niestandardowego.
Zakresy na poziomie użytkownika i sesji mają kolor szary
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 swoje członkostwo w trakcie sesji, przed ustawieniem nowej wartości wymiaru niestandardowego możesz 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 obecnej i 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 wartości wymiaru niestandardowego.
Dowiedz się więcej o tym, jak filtry i wartości wymiarów niestandardowych współdziałają podczas przetwarzania danych.
Ustawianie wartości przy użyciu automatycznego pomiaru ekranu
Aby zastosować wartość wymiaru niestandardowego do wyświetlenia ekranu wysłanego przez automatyczny pomiar ekranu EasyTracker, ustaw wartość przed wywołaniem activityStart()
podczas onStart()
.
Jeśli wartość nie jest znana w momencie wykonywania onStart()
, zalecamy ręczne pomiary 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.
Wskaźniki niestandardowe
Wymiary niestandardowe należy stosować z rozwagą w odniesieniu do konkretnych działań i nimi zarządzać zgodnie z zakresem, jednak działanie, do którego mają być stosowane dane niestandardowe, zasadniczo nie wpływa na raportowanie, więc można je ustawiać za każdym razem, gdy stanie się znana wartość danych.
Te pola są niezbędne do ustawienia wartości danych niestandardowych:
Integer
Indeks – indeks definicji danych niestandardowych.Integer
Wartość – wartość danych niestandardowych. Wartości mogą być ujemne.
Ustawianie wartości danych niestandardowych
Aby ustawić wartość danych niestandardowych, wywołaj funkcję setCustomMetric
przed kolejnym wywołaniem wysyłania:
// Get the tracker object. Tracker tracker = EasyTracker.getTracker(); // Increment the metric at index 1. tracker.setCustomMetric(1, 1); // Metric value sent with this hit. tracker.sendView();
Aby ustawić niestandardowe dane waluty:
// Get the tracker. Tracker tracker = EasyTracker.getTracker(); // Create a map for hit params. HashMapparams = new HashMap (); params.put(ModelFields.APP_SCREEN, "Product Page"); // Set currency value to custom metric slot 1. // Currency values may be fixed decimal. params.put("&cm1", "24.99"); // Send the custom metric value with a screen view. tracker.send("appview", params);
Uwagi o wdrażaniu
W sekcji poniżej znajdziesz dodatkowe uwagi, o których należy pamiętać, planując implementację wymiarów lub danych niestandardowych.
Wartości danych niestandardowych są agregowane w raportach
Wartości niestandardowych danych są agregowane w raportach tak jak inne dane wstępnie zdefiniowane w Google Analytics. W związku z tym musisz ustawić niestandardową wartość danych na 1
, aby zwiększyć łączną sumę tych danych w raportach.
Niestandardowe dane i filtry widoków (profili)
Chociaż dane niestandardowe 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), wszystkie powiązane wartości danych niestandardowych również zostaną odfiltrowane. Więcej informacji o wymiarach i danych niestandardowych oraz o filtrach widoków (profili)