Çökmeler ve İstisnalar - iOS SDK'sı

Bu dokümanda, iOS v3 için Google Analytics SDK kullanılarak kilitlenme ve istisna ölçümüne üst düzey genel bakış sunulmaktadır.

Genel bakış

Kilitlenme ve istisna ölçümü, uygulamanızda meydana gelen kilitlenme ve istisna sayılarını ve türlerini ölçmenize olanak tanır. İstisnalar aşağıdaki alanlarda bulunur:

Alan adı	İzleyici Alanı	Tür	Zorunlu	Açıklama
Açıklama	kGAIExDescription	NSString	Hayır	İstisnayla ilgili açıklama (en fazla 100 karakter). nil kabul edilir.
Hayati	kGAIExFatal	BOOL	Evet	İstisnanın önemli olup olmadığını gösterir. YES önemli olduğunu gösterir.

Kilitlenme ve istisna verileri öncelikle Crash and Exceptions raporunda kilitlenir.

Yakalanan İstisnalar

Yakalanan istisnalar, veriler için bir istek sırasında ağ bağlantısının zaman zaman zaman aşımına uğraması gibi istisna işleme kodunu tanımladığınız uygulamanızda yapılan hatalardır.

İzleyicide istisna alanı değerlerini ayarlayıp isabeti göndererek, yakalanan bir istisnayı ölçün. Örnek:

/*
 * An app tries to load a list of high scores from the cloud. If the request
 * times out, an exception is sent to Google Analytics
 */
@try {

  // Request some scores from the network.
  NSArray *highScores = [self getHighScoresFromCloud];

}
@catch (NSException *exception) {

    // May return nil if a tracker has not already been initialized with a
    // property ID.
    id tracker = [[GAI sharedInstance] defaultTracker];

    [tracker send:[[GAIDictionaryBuilder
        createExceptionWithDescription:@"Connection timeout"  // Exception description. May be truncated to 100 chars.
                             withFatal:@NO] build]];  // isFatal (required). NO indicates non-fatal exception.
}

Yakalanmayan İstisna Ölçümü

Yakalanmamış istisnalar, uygulamanızın çalışma zamanında beklenmeyen koşullarla karşılaştığı ve genellikle önemli olduğu durumları temsil eder. Bu durum, uygulamanın kilitlenmesine neden olur. trackUncaughtExceptions özelliği YES değerine ayarlanarak, yakalanmamış istisnalar Google Analytics'e otomatik olarak gönderilebilir. Örneğin:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [[GAI sharedInstance] setTrackUncaughtExceptions:YES];
  return YES;
}

Otomatik istisna ölçümünü kullanırken aşağıdakileri göz önünde bulundurun:

• Otomatik istisna ölçümü kullanılarak gönderilen tüm istisnalar, Google Analytics'te önemli olarak raporlanır.
• Açıklama alanı varsayılan olarak istisna türü, sınıf adı, yöntem adı ve ileti dizisi adı kullanılarak otomatik olarak ayarlanır.