Niestandardowe wymiary i dane – pakiet SDK na iOS

Ważne: w tym dokumencie opisano starszą wersję pakietu SDK. Nowi użytkownicy powinni używać najnowszego pakietu SDK.

W tym przewodniku dla programistów opisujemy, jak wdrażać niestandardowe wymiary i dane za pomocą pakietu SDK Google Analytics na iOS w wersji 2.

Przegląd

Zanim zaczniesz, przeczytaj Przewodnik po funkcjach niestandardowych wymiarów i danych, w których znajdziesz szczegółowe objaśnienie, jak działają niestandardowe wymiary i dane.

Gdy ustawisz wartość niestandardowego wymiaru lub danych za pomocą pakietu SDK Google Analytics na iOS, 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:

• NSNumber Indeks – indeks definicji wymiaru niestandardowego. Ten indeks ma wartość 1.
• NSString Wartość – wartość wymiaru niestandardowego.

Ustawianie wartości wymiaru niestandardowego

Aby ustawić wartość wymiaru niestandardowego, wywołaj funkcję setCustom:dimension: przed wywołaniem wysyłania, z którym chcesz powiązać tę wartość:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

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 wysyłanego przez automatyczny pomiar ekranu, ustaw tę wartość w metodzie viewDidAppear: kontrolera widoku danych. Na przykład plik .m kontrolera widoku może wyglądać tak:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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:

• NSInteger Indeks – indeks definicji danych niestandardowych.
• NSNumber Wartość – wartość danych niestandardowych. Wartości mogą być ujemne.

Uwaga: w przypadku danych niestandardowych skonfigurowanych jako typ waluty możesz użyć stałej wartości dziesiętnej zamiast liczby całkowitej.

Ustawianie wartości danych niestandardowych

Aby ustawić wartość danych niestandardowych, wywołaj setCustom:metric: przed kolejnym wywołaniem wysyłania:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

Aby ustawić niestandardowe dane waluty:

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params: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)