Genel bakış
Google Analytics iOS üst düzey sınıfı.
İzleyiciler oluşturmak ve davranış işaretleri belirlemek için olanaklar sağlar.
NSObject öğesini devralır.
Örnek Yöntemleri | |
(kimlik< GAITracker >) | - trackerWithName:trackingId: |
Belirtilen ad ve izleme kimliğiyle bir GAITracker uygulaması oluşturur veya getirir. Diğer... | |
(kimlik< GAITracker >) | - trackerWithTrackingId: |
Belirtilen izleme kimliğine eşit bir ada sahip bir GAITracker uygulaması oluşturur veya getirir. Diğer... | |
(void) | - removeTrackerByName: |
Bir takip cihazını takip cihazı sözlüğünden kaldırın. Diğer... | |
(void) | - dispatch |
Beklemedeki tüm takip bilgilerini gönderir. Diğer... | |
(void) | - dispatchWithCompleteHandler: |
İzleme işaretçisi gönderildiğinde (kGAIDispatchGood döndürdüğünde) veya bir hata oluştuğunda (kGAIDispatchError döndüren) sıradaki bir sonraki izleme işaretçisini çağırır. Diğer... | |
Sınıf Yöntemleri | |
(GAI *) | + sharedInstance |
iOS için Google Analytics sınıfının paylaşılan örneğini alın. Diğer... | |
Mülkler | |
id< GAITracker > | defaultTracker |
Kolaylık sağlamak için bu sınıf, bir varsayılan izleyici örneği sunar. Diğer... | |
kimlik< GAILogger > | logger |
Kullanılacak GAILogger. Diğer... | |
BOOL | optOut |
Böyle bir durum söz konusu olduğunda izleme bilgileri toplanmaz ve izleme çağrıları etkin bir şekilde işlemsiz hale gelir. Diğer... | |
NSTimeInterval | dispatchInterval |
Bu değer pozitifse izleme bilgileri her sevkInterval saniyede otomatik olarak gönderilir. Diğer... | |
BOOL | trackUncaughtExceptions |
Doğru değerine ayarlandığında SDK, geçerli olarak kayıtlı olan yakalanmamış istisna işleyiciyi kaydeder, ardından defaultTracker kullanarak oluşan istisnaları izleyen yakalanmamış bir istisna işleyici kaydeder. Diğer... | |
BOOL | dryRun |
Bu "EVET" olduğunda takip bilgisi gönderilmez. Diğer... | |
Yöntem Dokümanları
+ (GAI *) sharedInstance |
iOS için Google Analytics sınıfının paylaşılan örneğini alın.
- (kimlik<GAITracker>) trackerWithName: | (NSString *) | name | |
izleme kimliği: | (NSString *) | trackingId | |
Belirtilen ad ve izleme kimliğiyle bir GAITracker uygulaması oluşturur veya getirir.
Belirtilen ada ilişkin izleyici mevcut değilse oluşturulur ve iade edilir. Aksi takdirde, mevcut izleyici döndürülür. İlgili ada ait mevcut izleyicinin farklı bir izleme kimliği varsa söz konusu izleme kimliği bu yöntemle değiştirilmez. defaultTracker ayarlanmazsa burada döndürülen takip cihazı örneğine ayarlanır.
- Parametreler
-
ad Bu takip cihazının adı. nil
veya boş olmamalıdır.trackingID Bu takip cihazı için kullanılacak izleme kimliği. UA-xxxxx-y
biçiminde olmalıdır.
- İlerlemeler
- Belirtilen adla ilişkili bir GAITracker. İzleyici, izleme verilerini Google Analytics'e göndermek için kullanılabilir. Bu yöntem belirli bir adla ilk kez çağrıldığında, bu ada ilişkin izleyici döndürülür ve aynı ada sahip sonraki çağrılar aynı örneği döndürür. İzleyici, kitaplık tarafından dahili olarak saklanacağından izleyiciyi saklamanız gerekmez.
Bir hata oluşursa veya ad geçerli değilse bu yöntem nil
değerini döndürür.
- (kimlik<GAITracker>) trackerWithTrackingId: | (NSString *) | trackingId |
Belirtilen izleme kimliğine eşit bir ada sahip bir GAITracker uygulaması oluşturur veya getirir.
İlgili ada ilişkin izleyici mevcut değilse oluşturulur, izleme kimliği |trackingId| olarak ayarlanır ve döndürülür. Aksi takdirde, mevcut izleyici döndürülür. İlgili ada ait mevcut izleyicinin farklı bir izleme kimliği varsa söz konusu izleme kimliği bu yöntemle değiştirilmez. defaultTracker ayarlanmazsa burada döndürülen takip cihazı örneğine ayarlanır.
- Parametreler
-
trackingID Bu takip cihazı için kullanılacak izleme kimliği. UA-xxxxx-y
biçiminde olmalıdır. Takip cihazının adı, izleme kimliği ile aynı olacaktır.
- İlerlemeler
- Belirtilen izleme kimliğiyle ilişkili bir GAITracker. İzleyici, izleme verilerini Google Analytics'e göndermek için kullanılabilir. Bu yöntem belirli bir izleme kimliğiyle ilk kez çağrıldığında, ilgili ada ilişkin izleyici döndürülür ve aynı izleme kimliğine sahip sonraki çağrılar aynı örneği döndürür. İzleyici, kitaplık tarafından dahili olarak saklanacağından izleyiciyi saklamanız gerekmez.
Bir hata oluşursa veya trackingId geçerli değilse bu yöntem nil
değerini döndürür.
- (void) removeTrackerByName: | (NSString *) | name |
Bir takip cihazını takip cihazı sözlüğünden kaldırın.
Varsayılan takip cihazı kullanılıyorsa varsayılan izleyiciyi de siler.
- Parametreler
-
ad Takip cihazının adı.
- (geçersiz) gönderme |
Beklemedeki tüm takip bilgilerini gönderir.
Bu özelliğin sevkInterval üzerinde herhangi bir etkisinin olmadığını ve düzenli dağıtımla birlikte kullanılabileceğini unutmayın.
- (void) deployWithCompleteHandler: | (void(^)(GAIDispatchResult sonucu)) | completionHandler |
İzleme işaretçisi gönderildiğinde (kGAIDispatchGood döndürdüğünde) veya bir hata oluştuğunda (kGAIDispatchError döndüren) sıradaki bir sonraki izleme işaretçisini çağırır.
Ağ bağlantısı yoksa veya gönderilecek veri yoksa kGAIDispatchNoData döndürülür.
Bu yöntemin nil olmayan bir tamamlamaHandler ile çağrılmasının, periyodik dağıtımı devre dışı bırakacağını unutmayın. Periyodik dağıtım, uygulama arka plandan devam ettirildiğinde DKIMInterval'ı pozitif bir sayı olarak ayarlayarak yeniden etkinleştirilebilir.
Bu yöntemin nil completeHandler ile çağrılması, yukarıdaki gönderiyi çağırmakla aynıdır.
Bu yöntem, iOS 7.0 veya sonraki sürümlerde arka plan veri getirme işlemi için kullanılabilir. Uygulamadan çıkarken, gönderilmemiş takip bilgilerinin gönderilmesi işlemini başlatırken bu işlevi çağırmak mantıklı olacaktır.
- Parametreler
-
completionHandler Tek bir dağıtım isteğinden sonra çalıştırılacak blok. GAIDispatchResult parametresi, gönderme işleminin başarılı olup olmadığını, bir hata alıp almadığını veya gönderilecek hiçbir isabet olup olmadığını gösterir.
Mülkiyet Belgeleri
|
(okuma, yazma, atomik olmayan, atama) |
Kolaylık sağlamak için bu sınıf, bir varsayılan izleyici örneği sunar.
Bu işlev nil
olarak başlatılır ve trackerWithTrackingId: içinde örneklenen ilk izleyiciye ayarlanır. İstenildiği gibi geçersiz kılınabilir.
GAITrackedViewController sınıfı varsayılan olarak bu izleyici örneğini kullanır.
|
(okuma, yazma, atomik olmayan, atama) |
Böyle bir durum söz konusu olduğunda izleme bilgileri toplanmaz ve izleme çağrıları etkin bir şekilde işlemsiz hale gelir.
Politika true (doğru) değerine ayarlanırsa yüklenmeyi bekleyen tüm bilgiler silinir. Bu işaretin değeri SDK tarafından otomatik olarak korunur. Geliştiriciler, kullanıcıların Google Analytics izlemeyi devre dışı bırakmasına olanak tanımak amacıyla uygulamada bir kapsam dışında kalma ayarı uygulamak için isteğe bağlı olarak bu işareti kullanabilir.
Google Analytics SDK'sı bir cihazda ilk kez kullanıldığında bu süre NO
olarak ayarlanır ve sonrasında kalıcı olarak kalır.
|
(okuma, yazma, atomik olmayan, atama) |
Bu değer pozitifse izleme bilgileri her sevkInterval saniyede otomatik olarak gönderilir.
Aksi takdirde, takip bilgileri gönderme vasıtasıyla manuel olarak gönderilmelidir.
Varsayılan olarak bu, izleme bilgilerinin 120 saniyede bir otomatik olarak gönderilmesi gerektiğini belirten 120
değerine ayarlanır.
|
(okuma, yazma, atomik olmayan, atama) |
Doğru değerine ayarlandığında SDK, geçerli olarak kayıtlı olan yakalanmamış istisna işleyiciyi kaydeder, ardından defaultTracker kullanarak oluşan istisnaları izleyen yakalanmamış bir istisna işleyici kaydeder.
defaultTracker nil
değilse bu işlev, izleyicide istisnayı izler ve bekleyen takip bilgilerini 5 saniye boyunca dağıtmaya çalışır. Ardından, varsa daha önce kaydedilmiş istisna işleyiciyi çağırır. False (yanlış) değerine geri ayarlandığında, önceden kaydedilmiş olan yakalanmamış istisna işleyici geri yüklenir.
|
(okuma, yazma, atomik olmayan, atama) |
Bu "EVET" olduğunda takip bilgisi gönderilmez.
Varsayılan olarak "NO" değerine ayarlanır.