Przegląd
Najlepsza klasa Google Analytics na iOS.
Zapewnia urządzenia do śledzenia zachowań i ustawiania flag zachowań.
Dziedziczy NSObject.
Metody instancji | |
(id< GAITracker >) | – trackerWithName:trackingId: |
Tworzy lub pobiera implementację GAITracker o określonej nazwie i identyfikatorze śledzenia. Więcej... | |
(id< GAITracker >) | – trackerWithTrackingId: |
Tworzy lub pobiera implementację GAITracker o nazwie równej określonemu identyfikatorowi śledzenia. Więcej... | |
(void) | – removeTrackerByName: |
Usuń tracker ze słownika. Więcej... | |
(void) | – dispatch |
Wysyła wszelkie oczekujące informacje o śledzeniu. Więcej... | |
(void) | – dispatchWithCompleteHandler: |
Wysyła następny sygnał typu beacon w kolejce, wywołując parametr completeHandler, gdy zostanie wysłany sygnał śledzenia (zwrócony kGAIDispatchGood) lub wystąpi błąd (zwrócenie kGAIDispatchError). Więcej... | |
Metody klas | |
(GAI *) | + sharedInstance |
Pobierz udostępnioną instancję klasy Google Analytics dla iOS. Więcej... | |
Usługi | |
id< GAITracker > | defaultTracker |
Dla wygody ta klasa ujawnia domyślną instancję trackera. Więcej... | |
id< GAILogger > | logger |
GAILogger, którego chcesz użyć. Więcej... | |
BOOL | optOut |
W takim przypadku nie będą zbierane żadne informacje o śledzeniu. Więcej... | |
NSTimeInterval | dispatchInterval |
Jeśli ta wartość jest dodatnia, informacje o śledzeniu będą automatycznie wysyłane co dispatchInterval sekund. Więcej... | |
BOOL | trackUncaughtExceptions |
Gdy zasada ma wartość Prawda, pakiet SDK rejestruje aktualnie zarejestrowany niewykryty moduł obsługi wyjątków, a następnie rejestruje niewykryty moduł obsługi wyjątków, który śledzi wyjątki, które wystąpiły za pomocą parametru defaultTracker. Więcej... | |
BOOL | dryRun |
Gdy wybrano opcję TAK, informacje o śledzeniu nie zostaną wysłane. Więcej... | |
Dokumentacja metod
+ (GAI *) udostępniona instancja |
Pobierz udostępnioną instancję klasy Google Analytics dla iOS.
- (id<GAITracker>) trackerWithName: | (NSString *) | name | |
identyfikator śledzenia: | (NSString *) | trackingId | |
Tworzy lub pobiera implementację GAITracker o określonej nazwie i identyfikatorze śledzenia.
Jeśli element śledzący o określonej nazwie jeszcze nie istnieje, zostanie utworzony i zwrócony. W przeciwnym razie istniejący zostanie zwrócony. Jeśli istniejący element śledzący o danej nazwie ma inny identyfikator śledzenia, nie zostanie on zmieniony przez tę metodę. Jeśli domyślny tracker nie jest ustawiony, zostanie ustawiony na instancję trackera zwrócona w tym miejscu.
- Parametry
-
nazwa Nazwa tego trackera. Pole nie może mieć wartości nil
ani być puste.trackingID Identyfikator śledzenia używany przez ten tracker. Powinien mieć format UA-xxxxx-y
.
- Zwroty
- GAITracker powiązany z określoną nazwą. Tracker może służyć do wysyłania danych śledzenia do Google Analytics. Przy pierwszym wywołaniu tej metody z określoną nazwą zostanie zwrócony tag śledzenia dla tej nazwy, a kolejne wywołania o tej samej nazwie będą zwracać tę samą nazwę. Nie ma potrzeby przechowywania trackera, ponieważ jest on przechowywany w bibliotece.
Jeśli wystąpi błąd lub nazwa jest nieprawidłowa, metoda zwróci wartość nil
.
– (id<GAITracker>) trackerWithTrackingId: | (NSString *) | trackingId |
Tworzy lub pobiera implementację GAITracker o nazwie równej określonemu identyfikatorowi śledzenia.
Jeśli element śledzący o danej nazwie jeszcze nie istnieje, zostanie utworzony, a jego identyfikator śledzenia będzie ustawiony na |trackingId| i zostanie zwrócony. W przeciwnym razie istniejący element śledzący jest zwracany. Jeśli istniejący element śledzący o danej nazwie ma inny identyfikator śledzenia, nie zostanie on zmieniony przez tę metodę. Jeśli domyślny tracker nie jest ustawiony, ustawiany jest na zwróconą tutaj instancję trackera.
- Parametry
-
trackingID Identyfikator śledzenia używany przez ten tracker. Powinien mieć format UA-xxxxx-y
. Nazwa lokalizatora będzie taka sama jak nazwa śledzenia.
- Zwroty
- GAITracker powiązany z określonym identyfikatorem śledzenia. Tracker może służyć do wysyłania danych śledzenia do Google Analytics. Przy pierwszym wywołaniu tej metody z danym identyfikatorem śledzenia zostanie zwrócony tag śledzenia dla tej nazwy, a kolejne wywołania z tym samym identyfikatorem śledzenia zwrócą tę samą instancję. Nie ma potrzeby przechowywania trackera, ponieważ jest on przechowywany w bibliotece.
Jeśli wystąpi błąd lub identyfikator śledzenia jest nieprawidłowy, ta metoda zwróci wartość nil
.
- (void) removeTrackerByName: | (NSString *) | name |
Usuń tracker ze słownika.
Jeśli jest to domyślny tracker, usuwa również domyślny tracker.
- Parametry
-
nazwa Nazwa lokalizatora.
– (nieważna) wysyłka |
Wysyła wszelkie oczekujące informacje o śledzeniu.
Pamiętaj, że nie ma to żadnego wpływu na dispatchInterval i można go używać w połączeniu z okresowym wysyłką.
– (void) dispatchWithCompleteHandler: | (void(^)(wynik GAIDispatchResult)) | completionHandler |
Wysyła następny sygnał typu beacon w kolejce, wywołując parametr completeHandler, gdy zostanie wysłany sygnał śledzenia (zwrócony kGAIDispatchGood) lub wystąpi błąd (zwrócenie kGAIDispatchError).
W przypadku braku połączenia z siecią lub braku danych do wysłania, zwracany jest parametr kGAIDispatchNoData.
Pamiętaj, że wywołanie tej metody z wartością inną niż nil completeHandler wyłącza okresowe wysyłanie. Okresowe wysyłanie można ponownie włączyć, ustawiając wartość dispatchInterval na dodatnią liczbę, gdy aplikacja jest wznawiana w tle.
Wywołanie tej metody z wartością nil completeHandler jest takie samo jak wywołanie metody dispatch powyżej.
Tej metody można używać do pobierania danych w tle w systemie iOS 7.0 lub nowszym. Warto wywołać tę metodę przy zamykaniu aplikacji, aby rozpocząć przesyłanie nieprzesłanych informacji o śledzeniu.
- Parametry
-
completionHandler Blok, który ma być uruchamiany po pojedynczym żądaniu wysyłki. Parametr GAIDispatchResult wskazuje, czy wysyłanie zakończyło się powodzeniem, wystąpił błąd lub nie było żadnych działań do wysłania.
Dokumentacja usługi
|
(readwrite, nieatomic, przypisz) |
Dla wygody ta klasa ujawnia domyślną instancję trackera.
Ta inicjacja jest inicjowana nil
i zostanie ustawiona na pierwszy element śledzący utworzony w polu trackerWithTrackingId:. W razie potrzeby można ją zastąpić.
Klasa GAITrackedViewController będzie domyślnie używać tej instancji śledzenia.
|
(readwrite, nonatomic, keep) |
GAILogger, którego chcesz użyć.
|
(readwrite, nieatomic, przypisz) |
W takim przypadku nie będą zbierane żadne informacje o śledzeniu.
Jeśli ma wartość Prawda, wszystkie informacje oczekujące na przesłanie zostaną usunięte. Wartość tej flagi będzie automatycznie utrzymywana przez pakiet SDK. Deweloperzy mogą opcjonalnie użyć tej flagi, aby wdrożyć w aplikacji ustawienie rezygnacji, które umożliwia użytkownikom rezygnację ze śledzenia Google Analytics.
Ta wartość jest ustawiona na NO
przy pierwszym użyciu pakietu SDK Google Analytics na urządzeniu. Później jest zachowywana.
|
(readwrite, nieatomic, przypisz) |
Jeśli ta wartość jest dodatnia, informacje o śledzeniu będą automatycznie wysyłane co dispatchInterval sekund.
W przeciwnym razie informacje o śledzeniu należy przesłać ręcznie, kontaktując się z centrum dyspozycyjnym.
Domyślnie ma wartość 120
, co oznacza, że informacje o śledzeniu powinny być wysyłane automatycznie co 120 sekund.
|
(readwrite, nieatomic, przypisz) |
Gdy zasada ma wartość Prawda, pakiet SDK rejestruje aktualnie zarejestrowany niewykryty moduł obsługi wyjątków, a następnie rejestruje niewykryty moduł obsługi wyjątków, który śledzi wyjątki, które wystąpiły za pomocą parametru defaultTracker.
Jeśli defaultTracker nie ma wartości nil
, ta funkcja będzie śledzić wyjątek w śledzeniu i przez 5 sekund wysyłać wszelkie oczekujące informacje o śledzeniu. Spowoduje to wywołanie wcześniej zarejestrowanego modułu obsługi wyjątków (jeśli istnieje). Jeśli zasada ma wartość Fałsz, wcześniej zarejestrowany moduł obsługi niewykrytych wyjątków zostanie przywrócony.
|
(readwrite, nieatomic, przypisz) |
Gdy wybrano opcję TAK, informacje o śledzeniu nie zostaną wysłane.
Wartość domyślna to „NO”.