Özel Boyutlar ve Metrikler - iOS SDK'sı

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

Genel bakış

iOS için Google Analytics SDK'sını kullanarak bir özel boyut veya metrik değeri belirlediğinizde bu değer, gönderilen bir sonraki isabetle birlikte bir parametre olarak gönderilir. Bu değerler; 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ürlerine uygulanabilir.

Bir özel boyut veya metriği uygulamanın iki temel adımı vardır:

  1. Özel boyutu veya metriği Google Analytics web arayüzünü kullanarak tanımlayın.
    Web arayüzünün mülk ayarları bölümünde özel boyut veya metriğin dizinini, adını ve kapsamını ayarlayın.
    Özel boyutları veya metrikleri nasıl tanımlayacağınızı öğrenin.
  2. Özel boyut ve metrik değerlerini belirleyip toplamak için kod uygulayın.
    Bir önceki adımda tanımladığınız dizinlerde Google Analytics isabetleriniz için özel boyut veya metrik değerleri belirlemek üzere uygulamanıza kod ekleyin.

Bu makalenin geri kalanında, özel boyut veya metrik değerlerini ayarlamak ve Google Analytics'e göndermek için kodun nasıl uygulanacağı açıklanmaktadır.

Özel Boyutlar

Özel boyut değerleri tüm Google Analytics isabet türlerinde ayarlanabilir. Değerin uygulanmasını istediğiniz gönderme çağrısından hemen önce bir özel boyut değeri ayarlayın.

Özel boyutun tanımlanan kapsamı, işleme zamanında hangi ek isabetlerin bu değerle ilişkilendirilebileceğini belirler.

Özel boyut değeri ayarlamak için bu alanlar gereklidir:

  • NSNumber Dizin – özel boyut tanımının dizinidir. Bu dizin 1 tabanlıdır.
  • NSString Değer – Özel boyutun değeridir.

Özel Boyut Değeri Ayarlama

Bir özel boyut değeri ayarlamak için, değeri ilişkilendirmek istediğiniz gönderme çağrısından önce setCustom:dimension: değerini çağırın:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

Uygulamada Dikkat Edilmesi Gereken Hususlar

Bu bölümde, özel boyutları uygularken dikkat edilmesi gereken diğer hususlar özetlenmektedir.

Kullanıcı ve Oturum Düzeyi Kapsamları Açkan

Kullanıcı veya oturum düzeyinde kapsamlı özel boyut değerleri, geçmiş isabetler de 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, kullanıcı düzeyinde özel boyut olarak üyelik türünü 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 sayede, yeni sürüme geçişten önceki isabetler 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.

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 tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [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.

Özel Metrikler

Özel boyutların belirli isabetlere dikkatlice uygulanması ve kapsam ile yönetilmesi gerekse de, özel metriğin uygulandığı isabet genellikle raporlamayı etkilemez. Bu nedenle, metrik değeri bilindiğinde ayarlanabilir.

Özel metrik değeri ayarlamak için bu alanlar gereklidir:

  • NSInteger Dizin – özel metrik tanımının dizinidir.
  • NSNumber Değer – özel metriğin değeridir. Değerler negatif olabilir.

Özel Metrik Değeri Ayarlama

Özel metrik değeri belirlemek için başka bir gönderme çağrısından önce setCustom:metric: işlevini çağırın:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

Para birimi özel metriği ayarlamak için:

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

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

Uygulamada Dikkat Edilmesi Gereken Hususlar

Aşağıdaki bölümde, özel boyut veya metrik uygulaması planlarken göz önünde bulundurulması gereken ek hususlar açıklanmaktadır.

Ö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

Özel metrik değerleri genellikle uygun olduğunda ayarlanabilir. Ancak, görünümlerinizden (profillerinizden) filtrelenmesi muhtemel isabetler için özel metrik değerleri ayarlamaktan kaçının. İsabet bir görünüm (profil) filtresiyle filtrelenirse ilişkili tüm özel metrik değerleri de filtrelenir. Özel boyutlar ve metrikler ile görünüm (profil) filtreleri hakkında daha fazla bilgi edinin.