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.

Mengonfigurasi dimensi atau metrik kustom menggunakan antarmuka web Google Analytics. Pelajari cara mengonfigurasi dimensi atau metrik kustom (Pusat Bantuan).
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 kasus metrik, akan diuraikan 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 bersama jenis hit Google Analytics apa pun, termasuk tampilan layar, peristiwa, transaksi e-commerce, waktu pengguna, dan interaksi sosial. Cakupan dimensi kustom yang telah ditentukan akan menentukan, pada waktu pemrosesan, hit mana 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 Sesi dan Pengguna Berlaku untuk Hit Sebelumnya

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

Dimensi Kustom dan Filter Tampilan (Profil)

Nilai dimensi kustom tingkat pengguna atau sesi akan tetap diterapkan ke semua hit pada sesi saat ini dan/atau sesi mendatang meskipun hit yang dikirim bersamanya difilter dari tampilan (profil) .
Saat memfilter nilai dimensi kustom, hit 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 halnya metrik standar lainnya di Google Analytics. Oleh karena itu, Anda perlu menetapkan nilai metrik kustom 1 untuk meningkatkan total agregat metrik dalam laporan.

Metrik Kustom dan Filter Tampilan (Profil)

Meskipun nilai metrik kustom umumnya dapat ditetapkan kapan saja, jangan tetapkan nilai metrik kustom pada hit yang kemungkinan akan difilter dari tampilan (profil). Jika hit difilter menurut filter tampilan (profil), semua nilai metrik kustom terkait juga akan difilter. Pelajari dimensi dan metrik kustom serta filter tampilan (profil) lebih lanjut.

Menetapkan Nilai dengan Pengukuran Layar Otomatis

Untuk menerapkan nilai dimensi kustom ke tampilan layar yang dikirim melalui pengukuran layar otomatis, tetapkan nilai tersebut selama metode viewDidAppear: pengontrol tampilan. Misalnya, file .m pengontrol tampilan Anda 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 mengirim 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.