Dimensi &Metrik Kustom - iOS SDK

Panduan developer ini menjelaskan cara menerapkan dimensi dan metrik kustom menggunakan Google Analytics SDK untuk iOS v3.

Ringkasan

Dimensi kustom memungkinkan pengaitan metadata dengan hit, pengguna, dan sesi di Google Analytics, sedangkan metrik kustom memungkinkan Anda membuat dan menambah metrik Anda sendiri di Google Analytics.

  1. Konfigurasikan dimensi atau metrik kustom menggunakan antarmuka web Google Analytics. Pelajari cara mengonfigurasi dimensi atau metrik kustom (Pusat Bantuan).
  2. Menetapkan dan mengirim nilai dimensi dan metrik kustom dari aplikasi.

Dimensi dan metrik kustom terdiri dari dua kolom:

  • NSNumber Indeks – indeks dimensi atau metrik kustom. Indeks ini berbasis 1.
  • NSString Nilai – nilai dimensi atau metrik kustom. Dalam hal metrik, akan diurai sebagai bilangan bulat, atau nilai desimal titik tetap, jika metrik dikonfigurasi ke jenis mata uang.

Menetapkan dan Mengirim Nilai

Untuk menetapkan dan mengirim nilai dimensi kustom:

// 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]];

Nilai dimensi kustom dapat dikirim dengan jenis hit Google Analytics apa pun, termasuk tampilan layar, peristiwa, transaksi e-commerce, waktu pengguna, dan interaksi sosial. Cakupan dimensi kustom yang ditentukan akan menentukan, pada waktu pemrosesan, hit yang akan dikaitkan dengan nilai dimensi.

Untuk menetapkan dan mengirim nilai metrik kustom:

// 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.

Pertimbangan Penerapan

Bagian ini menguraikan pertimbangan tambahan yang perlu diingat saat menerapkan dimensi atau metrik kustom.

Pertimbangan untuk Dimensi Kustom

Nilai dengan Cakupan Tingkat Pengguna dan Tingkat Sesi Berlaku untuk Hit Terdahulu

  • Nilai dimensi kustom dengan cakupan tingkat pengguna atau sesi akan berlaku untuk semua hit dalam sesi saat ini, termasuk hit sebelumnya. Jika Anda tidak ingin nilai dimensi kustom dengan cakupan tingkat sesi atau pengguna diterapkan ke hit terdahulu di sesi saat ini, mulai sesi baru sebelum menerapkan nilai ke hit.
  • Misalnya, jika Anda menggunakan jenis keanggotaan sebagai dimensi kustom tingkat pengguna, dan pengguna mengupgrade langganannya di tengah-tengah sesi, Anda mungkin ingin memulai sesi baru sebelum menetapkan nilai dimensi kustom baru. Hal ini memastikan bahwa hit sebelum upgrade akan dikaitkan dengan nilai keanggotaan lama, sedangkan hit baru akan dikaitkan dengan nilai baru.

Filter Dimensi dan Tampilan (Profil) Kustom

  • Nilai dimensi kustom tingkat sesi atau pengguna akan tetap diterapkan ke semua hit di sesi saat ini dan/atau sesi mendatang meskipun hit yang dikirimkan bersama filter difilter dari tampilan (profil) .
  • Saat memfilter nilai dimensi kustom, hit akan difilter sesuai dengan cakupan nilai dimensi kustom tersebut. Pelajari lebih lanjut cara filter dan nilai dimensi kustom berinteraksi saat data Anda diproses.

Pertimbangan untuk Metrik Kustom

Nilai Metrik Kustom Digabungkan dalam Laporan

  • Nilai metrik kustom digabungkan dalam laporan seperti metrik standar lainnya di Google Analytics. Akibatnya, Anda akan menetapkan nilai metrik kustom 1 untuk menambah total gabungan metrik dalam laporan Anda.

Metrik Kustom dan Filter Tampilan (Profil)

Menetapkan Nilai dengan Pengukuran Layar Otomatis

  • Untuk menerapkan nilai dimensi kustom ke tampilan layar yang dikirim melalui pengukuran layar otomatis, tetapkan nilai selama metode viewDidAppear: pengontrol tampilan. Misalnya, file .m pengontrol tampilan mungkin terlihat seperti ini:
#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.

Jangan mengirimkan informasi identitas pribadi (PII) sebagai nilai

  • Persyaratan Layanan Google Analytics melarang pengiriman informasi identitas pribadi (PII) apa pun ke server Google Analytics. Untuk mengetahui informasi selengkapnya, baca Persyaratan Layanan.