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

Bu dokümanda, iOS v2 için Google Analytics SDK'sının gelişmiş yapılandırma özelliklerinden bazılarına genel bir bakış sunulmaktadır.

Genel bakış

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

  • GAI: Yeni GAITracker nesneleri almanın yanı sıra uygulama düzeyinde devre dışı bırakma ayarınız ve dağıtım ayarlarınızı da içeren uygulamanızın genel durumunu yöneten bir tekiltondur.
  • GAITracker – Google Analytics'e veri gönderdiğiniz sınıftır. 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ünden itibaren, tek bir uygulamada benzersiz izleme kimliği başına bir tane olmak üzere birden fazla izleyici kullanabilirsiniz. Tüm takip cihazları, GAI tektonunuzda bulunan aynı küresel durumu paylaşır.

Aşağıdaki örnekte ekran görünümü, her biri 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 takip cihazlarını kullanarak veri göndermek istiyorsanız bunu manuel olarak yapmanız gerekir.

Otomatik ekran ölçümü, belirli bir GAITrackedViewController öğesinin tracker özelliğinde belirtilen izleyiciyi referans amacıyla 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 dünya genelinde bir varsayılan izleyici vardır. Alınan ilk Tracker, varsayılan izleyici olur.

Varsayılan takip cihazını almak için şunu kullanın:

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

Varsayılan takip cihazını 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;

Örneklendirme

Google Analytics'e gönderilen isabetlerin sayısını sınırlamak için istemci tarafı örneklemeyi etkinleştirebilirsiniz. Uygulamanızın çok sayıda kullanıcısı varsa veya Google Analytics'e çok fazla veri gönderiyorsa örneklemeyi etkinleştirmek kesintisiz raporlamaya yardımcı olur.

Örneğin, %50 oranında istemci tarafı örnekleme 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 Devre Dışı Bırakma

Google Analytics'i uygulamanın tamamında devre dışı bırakacak uygulama düzeyinde bir devre dışı bırakma işaretini etkinleştirebilirsiniz. İşaret ayarlandıktan sonra uygulamanın ömrü boyunca veya sıfırlanana kadar varlığını sürdürür.

Uygulama düzeyinde devre dışı bırakma ayarını edinmek için şunları 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 hangi verilerin gönderildiği hakkında yararlı bilgileri yazdıran bir hata ayıklama modu sağlar.

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