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 nilani 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”.