Özel Boyutlar ve Metrikler - iOS SDK'sı

Bu geliştirici kılavuzunda, iOS v3 için Google Analytics SDK'sı kullanılarak özel boyutların ve metriklerin nasıl uygulanacağı açıklanmaktadır.

Genel bakış

Özel boyutlar, Google Analytics'te meta verilerin isabetler, kullanıcılar ve oturumlarla ilişkilendirilebilmesini sağlar. Özel metrikler ise Google Analytics'te kendi metriklerinizi oluşturup artırmanıza olanak tanır.

  1. Özel boyutu veya metriği Google Analytics web arayüzünü kullanarak yapılandırın. Özel boyutları veya metrikleri nasıl yapılandıracağınızı öğrenin (Yardım Merkezi).
  2. Bir uygulamadan özel boyut ve metrik değerleri ayarlama ve gönderme.

Özel boyutlar ve metrikler iki alandan oluşur:

  • NSNumber Dizin – özel boyut veya metriğin dizinidir. Bu dizin 1 tabanlıdır.
  • NSString Değer – Özel boyut veya metriğin değeridir. Metrikler söz konusu olduğunda, metrik bir para birimi türüne yapılandırılmışsa tam sayı veya sabit ondalık sayı olarak ayrıştırılır.

Değerleri Ayarlama ve Gönderme

Özel boyut değeri belirlemek ve göndermek için:

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

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

Özel boyut değerleri; ekran görüntülemeleri, etkinlikler, e-ticaret işlemleri, kullanıcı zamanları ve sosyal etkileşimler dahil olmak üzere tüm Google Analytics isabet türleriyle gönderilebilir. Özel boyutun tanımlanan kapsamı, işleme sırasında hangi isabetlerin boyut değeriyle ilişkilendirildiğini belirler.

Özel metrik değeri belirlemek ve göndermek için:

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


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

Uygulamada Dikkat Edilmesi Gereken Hususlar

Bu bölümde, özel boyutları veya metrikleri uygularken göz önünde bulundurulması gereken ek hususlar açıklanmaktadır.

Özel Boyutlar konusunda dikkat edilmesi gereken noktalar

Kullanıcı ve Oturum Düzeyi Kapsamlarına Sahip Değerler Geçmiş İsabetlere Geçerlidir

  • Kullanıcı veya oturum düzeyinde kapsama sahip özel boyut değerleri, geçmiş isabetler dahil olmak üzere mevcut oturumdaki tüm isabetlere uygulanır. Oturum veya kullanıcı düzeyinde kapsama sahip bir özel boyut değerinin geçerli oturumdaki geçmiş isabetlere uygulanmasını istemiyorsanız değeri bir isabete uygulamadan önce yeni bir oturum başlatın.
  • Örneğin, üyelik türünü kullanıcı düzeyinde özel boyut olarak kullanıyorsanız ve bir kullanıcı oturumun ortasında üyeliğini yükseltiyorsa yeni özel boyut değerini ayarlamadan önce yeni bir oturum başlatmak isteyebilirsiniz. Bu, yükseltmeden önceki isabetlerin eski üyelik değeriyle, yeni isabetlerin ise yeni değerle ilişkilendirilir.

Özel Boyutlar ve Görünüm (Profil) Filtreleri

  • Kullanıcı veya oturum düzeyinde özel boyut değerleri, birlikte gönderildikleri isabet bir görünümden (profilden) filtrelenmiş olsa bile mevcut ve/veya gelecek oturumlardaki tüm isabetlere uygulanmaya devam eder.
  • Özel boyut değerine göre filtre uygularken, isabetler söz konusu özel boyut değerinin kapsamına göre filtrelenir. Verileriniz işlendiğinde filtrelerin ve özel boyut değerlerinin nasıl etkileşimde bulunduğu hakkında daha fazla bilgi edinin.

Özel Metriklerle ilgili dikkat edilmesi gereken noktalar

Özel Metrik Değerleri Raporlarda Toplanır

  • Özel metrik değerleri, Google Analytics'teki diğer önceden tanımlanmış metrikler gibi raporlarda toplanır. Bunun sonucunda, raporlarınızda metriğin toplamını artırmak için 1 değerinde bir özel metrik değeri ayarlarsınız.

Özel Metrikler ve Görünüm (Profil) Filtreleri

Otomatik Ekran Ölçümü ile Değer Belirleme

  • Otomatik ekran ölçümü aracılığıyla gönderilen bir ekran görünümüne özel boyut değeri uygulamak için değeri, görüntüleme denetleyicisinin viewDidAppear: yöntemi sırasında ayarlayın. Örneğin, görünüm denetleyicinizin .m dosyası aşağıdaki gibi görünebilir:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

Kimliği tanımlayabilecek bilgileri (PII) değer olarak göndermeyin

  • Google Analytics Hizmet Şartları, kimliği tanımlayabilecek bilgilerin (PII) Google Analytics sunucularına gönderilmesini yasaklamaktadır. Daha fazla bilgi için lütfen Hizmet Şartları'na başvurun.