W tym dokumencie znajdziesz przegląd niektórych zaawansowanych funkcji konfiguracyjnych pakietu Google Analytics SDK na iOS w wersji 2.
Przegląd
Pakiet SDK Google Analytics na iOS używa 2 klas do zarządzania globalnym stanem wdrożenia i wysyłania danych na serwery Google Analytics.
GAI
– pojedynczy element, który obsługuje globalny stan Twojej implementacji, w tym pobieranie nowych obiektówGAITracker
, a także ustawienie rezygnacji na poziomie aplikacji i ustawienia wysyłania.GAITracker
– klasa, z której wysyłasz dane do Google Analytics. Można utworzyć wiele wystąpień skryptu, po jednym na każdy unikalny identyfikator usługi.
Korzystanie z wielu trackerów
Od wersji 2 pakietu SDK możesz używać wielu skryptów śledzenia w jednej implementacji, po jednym na każdy unikalny identyfikator śledzenia. Wszystkie trackery są przypisane do tego samego stanu globalnego, którym podlega Twój singleton GAI
.
W tym przykładzie wyświetlenie ekranu jest wysyłane do 2 osobnych usług za pomocą 2 tagów śledzenia, z których każda ma własny unikalny identyfikator usługi:
#import "RootViewController.h" #import "GAI.h" @interface RootViewController () @end @implementation RootViewController { - (void)viewDidLoad { [super viewDidLoad]; // Send a screen view to the first property. id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"]; [tracker1 sendView:@"/HomeScreen"]; // Send another screen view to the second property. id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"]; [tracker2 sendView:@"Home"]; } @end
Pamiętaj, że funkcje automatycznego pomiaru, takie jak automatyczne sprawdzanie danych i pomiar niewykrytych wyjątków, używają tylko jednego trackera do wysyłania danych do Google Analytics. Jeśli korzystasz z tych funkcji i chcesz wysyłać dane za pomocą innych trackerów, musisz to zrobić ręcznie.
W celach informacyjnych, automatyczny pomiar ekranu korzysta z lokalizatora określonego we właściwości tracker
danej wartości GAITrackedViewController
.
Pomiar niewykrytych wyjątków używa domyślnego trackera określonego w instancji GAI
.
Domyślny tracker
Implementacja może korzystać z kilku skryptów śledzenia, ale globalnie ma jeden domyślny. Pierwszy pobrany plik Tracker
stanie się domyślnym modułem do śledzenia.
Aby pobrać domyślny tracker, użyj:
// Get default tracker. idmyDefault = [GAI sharedInstance].defaultTracker;
Aby ustawić domyślny tracker, użyj:
// Get a new tracker. idnewTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID"); // Set the new tracker as the default tracker, globally. [GAI sharedInstance].defaultTracker = newTracker;
Próbkowanie
Możesz włączyć próbkowanie po stronie klienta, aby ograniczyć liczbę działań wysyłanych do Google Analytics. Jeśli Twoja aplikacja ma dużą liczbę użytkowników lub w inny sposób wysyła do Google Analytics dużą ilość danych, włączenie próbkowania pomoże zapewnić nieprzerwane raportowanie.
Aby np. wdrożyć próbkowanie po stronie klienta z częstotliwością 50%, użyj tego kodu:
// Set a sample rate of 50%. [tracker setSampleRate:50.0]; // Sample rate is a double.
Rezygnacja na poziomie aplikacji
Możesz włączyć flagę rezygnacji na poziomie aplikacji, która spowoduje wyłączenie Google Analytics w całej aplikacji. Po ustawieniu flaga będzie stosowana przez cały czas istnienia aplikacji lub do chwili jej zresetowania.
Aby uzyskać ustawienie rezygnacji na poziomie aplikacji:
// Get the app-level opt out preference. if ([GAI sharedInstance].optOut) { ... // Alert the user they have opted out. }
Aby ustawić flagę rezygnacji na poziomie aplikacji, wpisz:
// Set the app-level opt out preference. [[GAI sharedInstance].setOptOut = YES];
Testowanie i debugowanie
Pakiet Google Analytics SDK na iOS udostępnia tryb debugowania, w którym wyświetlane są przydatne informacje o tym, jakie dane w dziennikach są wysyłane do Google Analytics.
// Enable debug mode. [GAI sharedInstance].debug = YES;