Dimensi & Metrik Kustom - iOS SDK

Penting: Dokumen ini menjelaskan SDK versi lama. Pengguna baru harus menggunakan SDK terbaru.

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

Ringkasan

Sebelum menerapkan, baca Panduan Fitur Dimensi dan Metrik Kustom untuk mendapatkan penjelasan mendetail tentang cara kerja dimensi dan metrik kustom.

Jika Anda menetapkan nilai dimensi atau metrik kustom menggunakan Google Analytics SDK untuk iOS, nilai tersebut akan dikirim sebagai parameter dengan hit berikutnya yang dikirim. Nilai tersebut dapat diterapkan ke jenis hit Google Analytics apa pun, termasuk tampilan layar, peristiwa, transaksi e-commerce, waktu pengguna, dan interaksi sosial.

Ada dua langkah utama untuk menerapkan dimensi atau metrik kustom:

1. Tentukan dimensi atau metrik kustom menggunakan antarmuka web Google Analytics.
   Tetapkan indeks, nama, dan cakupan dimensi atau metrik kustom di bagian setelan properti pada antarmuka web.
   Pelajari cara menentukan dimensi atau metrik kustom.
2. Terapkan kode untuk menetapkan dan mengumpulkan nilai dimensi dan metrik kustom.
   Tambahkan kode ke aplikasi Anda untuk menetapkan nilai dimensi atau metrik kustom untuk hit Google Analytics pada indeks yang Anda tentukan di langkah sebelumnya.

Bagian selanjutnya dari artikel ini akan menjelaskan cara menerapkan kode untuk menetapkan dan mengirim nilai dimensi atau metrik kustom ke Google Analytics.

Dimensi Kustom

Nilai dimensi kustom dapat ditetapkan pada semua jenis hit Google Analytics. Tetapkan nilai dimensi kustom tepat sebelum panggilan kirim tempat Anda ingin menerapkan nilai.

Cakupan dimensi kustom yang telah ditentukan akan menentukan pada waktu pemrosesan hit tambahan mana yang mungkin dikaitkan dengan nilai tersebut.

Kolom berikut diperlukan untuk menetapkan nilai dimensi kustom:

• NSNumber Indeks – indeks definisi dimensi kustom. Indeks ini berbasis 1.
• NSString Nilai – nilai dimensi kustom.

Menetapkan Nilai Dimensi Kustom

Untuk menetapkan nilai dimensi kustom, panggil setCustom:dimension: sebelum panggilan kirim yang ingin Anda kaitkan dengan nilai:

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

Pertimbangan Penerapan

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

Cakupan Tingkat Sesi dan Pengguna Bersifat Greedy

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 sebelumnya pada sesi saat ini, mulai sesi baru sebelum menerapkan nilai tersebut ke hit.

Misalnya, jika menggunakan jenis keanggotaan sebagai dimensi kustom tingkat pengguna, dan pengguna mengupgrade keanggotaannya di tengah sesi, Anda dapat 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.

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

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

Jangan mengirim informasi identitas pribadi (PII) sebagai nilai

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

Custom Metrics

Meskipun dimensi kustom harus diterapkan dengan cermat ke hit tertentu dan dikelola dengan cakupan, hit yang dengannya metrik kustom diterapkan umumnya tidak akan memengaruhi pelaporan, sehingga dapat ditetapkan setiap kali nilai metrik diketahui.

Kolom berikut diperlukan untuk menetapkan nilai metrik kustom:

• NSInteger Indeks – indeks definisi metrik kustom.
• NSNumber Nilai – nilai metrik kustom. Nilainya mungkin negatif.

Catatan: Anda dapat menggunakan nilai desimal tetap, bukan bilangan bulat untuk metrik kustom yang dikonfigurasi sebagai jenis Mata uang.

Menetapkan Nilai Metrik Kustom

Untuk menetapkan nilai metrik kustom, panggil setCustom:metric: sebelum panggilan kirim lainnya:

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

Atau, untuk menetapkan metrik kustom mata uang:

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

Pertimbangan Penerapan

Bagian berikut menguraikan pertimbangan tambahan yang perlu diingat saat merencanakan penerapan dimensi atau 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 khusus umumnya dapat ditetapkan kapan saja, hindari menetapkan nilai metrik khusus pada klik yang kemungkinan akan difilter dari tampilan (profil). Jika hit difilter menurut filter tampilan (profil), nilai metrik kustom terkait juga akan difilter. Pelajari dimensi dan metrik kustom serta filter tampilan (profil) lebih lanjut.