App Center Analytics (iOS)

Usługa App Center Analytics pomaga zrozumieć zachowanie użytkowników i zaangażowanie klientów w celu ulepszenia aplikacji. Zestaw SDK automatycznie przechwytuje liczbę sesji i właściwości urządzenia, takie jak model, wersja systemu operacyjnego itp. Możesz zdefiniować własne zdarzenia niestandardowe, aby mierzyć istotne elementy. Wszystkie przechwycone informacje są dostępne w portalu App Center, aby umożliwić analizę danych.

Postępuj zgodnie z sekcją Wprowadzenie , jeśli zestaw SDK nie został jeszcze skonfigurowany w aplikacji.

Informacje o sesji i urządzeniu

Po dodaniu usługi App Center Analytics do aplikacji i uruchomieniu zestawu SDK będzie ona automatycznie śledzić sesje i właściwości urządzenia, w tym wersję systemu operacyjnego, model itd., bez dodatkowego kodu.

Zestaw SDK automatycznie zgłasza kod kraju użytkownika, jeśli urządzenie ma zainstalowany modem danych mobilnych i kartę SIM. Urządzenia tylko z siecią Wi-Fi nie będą domyślnie zgłaszać kodu kraju. Aby ustawić kod kraju tych użytkowników, musisz samodzielnie uzyskać lokalizację użytkownika i użyć metody setCountryCode: w SDK. Nasza rada polega na uważnym śledzeniu lokalizacji użytkowników i używaniu niskiej rozdzielczości lokalizacji. W poniższym przykładzie użyto metody kCLLocationAccuracyKilometer.

• Upewnij się, że na urządzeniu włączono usługi lokalizacji .
• Pobierz bieżącą lokalizację urządzenia przy użyciu polecenia CLLocationManager.
• Przekonwertuj lokalizację na kod kraju ISO przy użyciu polecenia CLGeocoder.
• Zastąpij kod kraju przewoźnika przy użyciu metody zestawu SDK setCountryCode .

Użyj następującego kodu, aby pobrać lokalizację urządzenia i zastąpić kod kraju przewoźnika w aplikacji:

Dodaj protokół CLLocationManagerDelegate do elementu AppDelegate i dodaj właściwość locationManager:

@interface AppDelegate () <CLLocationManagerDelegate>
@property(nonatomic) CLLocationManager *locationManager;
@end

class AppDelegate: CLLocationManagerDelegate {
  private var locationManager: CLLocationManager = CLLocationManager()
}

W metodzie didFinishLaunchingWithOptions: skonfiguruj menedżera lokalizacji.

  self.locationManager = [[CLLocationManager alloc] init];
  self.locationManager.delegate = self;
  self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer;
  [self.locationManager requestWhenInUseAuthorization];

  self.locationManager.delegate = self
  self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer
  self.locationManager.requestWhenInUseAuthorization()

Dodaj metody delegata:

- (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status {
  if (status == kCLAuthorizationStatusAuthorizedWhenInUse) {
    [manager requestLocation];
  }
}

- (void)locationManger:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations {
  CLLocation *location = [locations lastObject];
  CLGeocoder *geocoder = [[CLGeocoder alloc] init];
  [geocoder reverseGeocodeLocation:location
                 completionHandler:^(NSArray *placemarks, NSError *error) {
                   if (placemarks.count == 0 || error)
                     return;
                   CLPlacemark *pm = [placemarks firstObject];
                   [MSACAppCenter setCountryCode:pm.ISOcountryCode];
                 }]
}

- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error {
  NSLog(@"Failed to find user's location: \(error.localizedDescription)");
}

func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
  if (status == kCLAuthorizationStatusAuthorizedWhenInUse) {
    manager.requestLocation()
  }
}

func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
  let userLocation:CLLocation = locations[0] as CLLocation
  CLGeocoder().reverseGeocodeLocation(userLocation) { (placemarks, error) in
    if error == nil {
      AppCenter.countryCode = placemarks?.first?.isoCountryCode
    }
  }
}
  
func locationManager(_ Manager: CLLocationManager, didFailWithError error: Error) {
  print("Failed to find user's location: \(error.localizedDescription)")
}

Zdarzenia niestandardowe

Możesz śledzić własne zdarzenia niestandardowe z maksymalnie 20 atrybutami, aby wiedzieć, co dzieje się w aplikacji, zrozumieć akcje użytkownika i zobaczyć agregacje w portalu App Center.

Po uruchomieniu zestawu SDK użyj metody trackEvent:withProperties do śledzenia swoich zdarzeń wraz z właściwościami. Możesz wysłać do 200 odrębnych nazw zdarzeń. Ponadto istnieje maksymalny limit 256 znaków na nazwę zdarzenia i 125 znaków na nazwę właściwości zdarzenia i wartość właściwości zdarzenia.

NSDictionary *properties = @{@"Category" : @"Music", @"FileName" : @"favorite.avi"};
[MSACAnalytics trackEvent:@"Video clicked" withProperties: properties];

Analytics.trackEvent("Video clicked", withProperties: ["Category" : "Music", "FileName" : "favorite.avi"])

Właściwości zdarzeń są całkowicie opcjonalne — jeśli chcesz śledzić zdarzenie, użyj tego przykładu:

[MSACAnalytics trackEvent:@"Video clicked"];

Analytics.trackEvent("Video clicked")

Priorytet zdarzenia i trwałość

Możesz śledzić zdarzenia krytyczne dla działania firmy, które mają większe znaczenie niż inne zdarzenia.

• Deweloperzy mogą ustawiać priorytet zdarzeń jako Normalny (FlagsNormal w interfejsie API) lub Krytyczny (FlagsCritical w interfejsie API).
• Zdarzenia z priorytetem ustawionym jako Krytyczne zostaną pobrane z magazynu najpierw i wysłane przed zdarzeniami normalnymi .
• Gdy pamięć lokalna jest pełna i trzeba przechować nowe zdarzenia. Najstarsze zdarzenia o najniższym priorytetu są najpierw usuwane, aby zapewnić miejsce dla nowych.
• Jeśli pamięć jest pełna logów z priorytetem krytycznym, śledzenie zdarzenia z priorytetem normalnym zakończy się niepowodzeniem, ponieważ zestaw SDK nie może zrobić miejsca w tej sytuacji.
• Jeśli używasz również usługi Awarie , dzienniki awarii są ustawione jako Krytyczne i współużytkują ten sam magazyn co zdarzenia.
• Interwał transmisji jest stosowany tylko do zdarzeń normalnych . Zdarzenia krytyczne będą wysyłane po 3 sekundach.

Do śledzenia zdarzenia jako krytycznego można użyć następującego interfejsu API:

NSDictionary *properties = @{@"Category" : @"Music", @"FileName" : @"favorite.avi"};
[MSACAnalytics trackEvent:@"Video clicked" withProperties:properties flags:MSACFlagsCritical];

// If you're using name only, you can pass nil as properties.

let properties = ["Category" : "Music", "FileName" : "favorite.avi"];
Analytics.trackEvent("Video clicked", withProperties: properties, flags: .critical)

// If you're using name only, you can pass nil as properties.

Wstrzymywanie i wznawianie wysyłania dzienników

Wstrzymanie transmisji zdarzeń może być przydatne w scenariuszach, gdy aplikacja musi kontrolować przepustowość sieci w celu uzyskania bardziej krytycznych potrzeb biznesowych. Możesz wstrzymać wysyłanie dzienników do zaplecza Centrum aplikacji. Po wstrzymaniu zdarzenia mogą być nadal śledzone i zapisywane, ale nie są wysyłane od razu. Wszystkie zdarzenia śledzone przez aplikację podczas wstrzymania będą wysyłane tylko po wywołaniu metody resume.

[MSACAnalytics pause];
[MSACAnalytics resume];

Analytics.pause()
Analytics.resume()

Włączanie lub wyłączanie analizy usługi App Center w czasie wykonywania

Możesz włączyć i wyłączyć analizę usługi App Center w czasie wykonywania. Jeśli go wyłączysz, zestaw SDK nie będzie zbierał żadnych dodatkowych informacji analitycznych dla aplikacji.

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Aby ponownie włączyć usługę App Center Analytics, użyj tego samego interfejsu API, ale przekaż YES/true go jako parametr.

[MSACAnalytics setEnabled:YES];

Analytics.enabled = true

Stan jest utrwalany w magazynie urządzenia w ramach uruchamiania aplikacji.

Sprawdzanie, czy usługa App Center Analytics jest włączona

Możesz również sprawdzić, czy usługa App Center Analytics jest włączona, czy nie.

[MSACAnalytics isEnabled];

Analytics.enabled

Zarządzanie sesją początkową

Domyślnie identyfikator sesji zależy od cyklu życia aplikacji. Jeśli chcesz ręcznie kontrolować rozpoczęcie nowej sesji, wykonaj następujące kroki:

• Wywołaj następującą metodę przed uruchomieniem zestawu SDK:

[MSACAnalytics enableManualSessionTracker];

Analytics.enableManualSessionTracker()

• Następnie możesz użyć interfejsu API po wykonaniu startSession polecenia AppCenter.start:

[MSACAnalytics startSession];

Analytics.startSession()

Rozmiar magazynu lokalnego

Domyślnie zestaw SDK przechowuje wszystkie dzienniki do 10 MB. Deweloperzy mogą używać API do zwiększenia przestrzeni magazynowej, a zestaw SDK będzie przechowywać dzienniki aż do całkowitego zapełnienia.

Brak dostępu do Internetu

Jeśli nie ma łączności sieciowej, SDK zapisuje dzienniki do 10 MB w pamięci lokalnej. Po zapełnieniu magazynu zestaw SDK zacznie odrzucać stare dzienniki, aby zapewnić miejsce na nowe dzienniki. Po przywróceniu łączności sieciowej zestaw SDK wysyła dzienniki w partiach po 50 lub co 6 sekund (domyślnie).

Grupowanie logów zdarzeń

Zestaw SDK centrum aplikacji przekazuje dzienniki w partii 50, a jeśli zestaw SDK nie ma 50 dzienników do wysłania, nadal będzie wysyłać dzienniki po 6 sekundach (domyślnie). Można wysłać maksymalnie trzy partie równolegle. Interwał transmisji można zmienić:

// Change transmission interval to 10 seconds.
[MSACAnalytics setTransmissionInterval:10000];

// Change transmission interval to 10 seconds.
Analytics.transmissionInterval = 10000

Wartość interwału transmisji musi należeć do zakresu od 6 sekund do 86400 sekund (jeden dzień), a ta metoda musi być wywoływana przed uruchomieniem usługi.

Logika ponawiania i wycofywania

Zestaw SDK usługi App Center obsługuje ponawianie prób w przypadku możliwych do odzyskania błędów sieci. Poniżej znajduje się logika ponawiania prób:

• Maksymalnie trzy próby na żądanie.
• Każde żądanie ma własny mechanizm stanu ponawiania.
• Wszystkie kanały transmisji są wyłączone (do następnego procesu aplikacji) po wyczerpaniu wszystkich ponownych prób przez jedno żądanie.

Logika odwlekania

• 50% randomizacja, pierwsza ponowna próba między 5 a 10 sekund, druga ponowna próba między 2,5 a 5 minut, ostateczna próba między 10 a 20 minut.
• Jeśli sieć zmienia się z wyłączonej na włączoną (lub z wi-fi na mobilną), stany ponawiania są restartowane i żądania są ponawiane natychmiast.