Wymiary i dane niestandardowe – pakiet SDK na Androida w wersji 2 (starsza wersja)

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:

  1. 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
  2. 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.
HashMap params = 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)