Gelişmiş Yapılandırma - iOS SDK'sı

Bu belgede, iOS için Google Analytics SDK'sının gelişmiş yapılandırma özelliklerinden bazılarıyla ilgili genel bir bakış sunulmaktadır.

Genel bakış

iOS için Google Analytics SDK'sı, uygulamanın genel durumunu yönetmek ve Google Analytics sunucularına veri göndermek için iki sınıf kullanır.

  • GAI: Yeni GAITracker nesnelerini edinmenin yanı sıra uygulama düzeyinde devre dışı bırakma ayarınız ve gönderme ayarlarınız da dahil olmak üzere uygulamanızın küresel durumunu ele alan tekli doküman.
  • GAITracker – Google Analytics'e veri gönderdiğiniz sınıf. Benzersiz mülk kimliği başına bir tane olacak şekilde birden fazla izleyici örneklenebilir.

Birden Çok İzleyici Kullanma

SDK'nın 2. sürümüyle birlikte, benzersiz izleme kimliği başına bir tane olmak üzere tek bir uygulamada birden fazla izleyici kullanabilirsiniz. Tüm izleyiciler, GAI tektonunuzun aynı küresel durumunu paylaşır.

Aşağıdaki örnekte, bir ekran görüntülenme özelliği, her birinin kendi benzersiz mülk kimliğine sahip iki izleyici kullanılarak iki ayrı mülke gönderilir:

#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

Otomatik ekran ve yakalanmamış istisna ölçümü gibi otomatik ölçüm özelliklerinin Google Analytics'e veri göndermek için yalnızca bir izleyici kullanacağını unutmayın. Bu özellikleri kullanıyor ve diğer izleyiciler aracılığıyla veri göndermek istiyorsanız bunu manuel olarak yapmanız gerekir.

Referans olarak, otomatik ekran ölçümü belirli bir GAITrackedViewController için tracker özelliğinde belirtilen izleyiciyi kullanır. Yakalanmamış istisna ölçümü, GAI örneğinizde belirtilen varsayılan izleyiciyi kullanır.

Varsayılan İzleyici

Bir uygulamada birden fazla izleyici kullanılabilse de genel olarak tek bir varsayılan izleyicisi bulunur. Alınan ilk Tracker varsayılan izleyici olur.

Varsayılan izleyiciyi almak için şunları kullanın:

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

Varsayılan izleyiciyi ayarlamak için şunları kullanın:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

Örnekleme

Google Analytics'e gönderilen isabet sayısını sınırlamak için istemci taraflı örneklemeyi etkinleştirebilirsiniz. Uygulamanız çok sayıda kullanıcıya sahipse veya Google Analytics'e büyük miktarda veri gönderiyorsa örneklemenin etkinleştirilmesi kesintiye uğramadan raporlama yapılmasına yardımcı olur.

Örneğin, istemci tarafı örneklemeyi %50 oranında uygulamak için aşağıdaki kodu kullanın:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

Uygulama Düzeyinde Kapsam Dışında Kalma

Google Analytics'i uygulamanın tamamında devre dışı bırakacak uygulama düzeyinde bir devre dışı bırakma bayrağını etkinleştirebilirsiniz. İşaretlendikten sonra, işaret uygulama ömrü boyunca veya sıfırlanana kadar görünmeye devam eder.

Uygulama düzeyinde kapsam dışında kalma ayarını almak için şunu kullanın:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

Uygulama düzeyinde kapsam dışında kalma işaretini ayarlamak için şunları kullanın:


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

Test ve Hata Ayıklama

iOS için Google Analytics SDK'sı, günlüklerinizde Google Analytics'e gönderilen verilerle ilgili yararlı bilgiler yazdıracak bir hata ayıklama modu sağlar.

// Enable debug mode.
[GAI sharedInstance].debug = YES;