Konfigurasi Lanjutan - iOS SDK

Dokumen ini menyajikan ringkasan beberapa fitur konfigurasi lanjutan Google Analytics SDK untuk iOS v2.

Ringkasan

Google Analytics SDK untuk iOS menggunakan dua class untuk mengelola status global penerapan dan mengirim data ke server Google Analytics.

  • GAI – singleton yang menangani status global penerapan Anda, termasuk mendapatkan objek GAITracker baru, serta setelan pilihan tidak ikut dan setelan pengiriman tingkat aplikasi.
  • GAITracker – class tempat Anda mengirim data ke Google Analytics. Beberapa pelacak dapat dibuat instance-nya, satu per ID properti unik.

Menggunakan Beberapa Pelacak

Mulai SDK versi 2, Anda dapat menggunakan beberapa pelacak dalam satu penerapan, satu per ID pelacakan unik. Semua pelacak memiliki status global yang sama yang dipegang oleh singleton GAI Anda.

Pada contoh berikut, tampilan layar dikirim ke dua properti terpisah dengan menggunakan dua pelacak, masing-masing dengan ID properti uniknya sendiri:

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

Perhatikan bahwa fitur pengukuran otomatis, seperti pengukuran otomatis dan pengukuran pengecualian yang tidak tertangkap, hanya akan menggunakan satu pelacak untuk mengirim data ke Google Analytics. Jika Anda menggunakan fitur ini dan ingin mengirim data menggunakan pelacak lain, Anda harus melakukannya secara manual.

Untuk referensi, pengukuran layar otomatis menggunakan pelacak yang ditentukan dalam properti tracker dari GAITrackedViewController tertentu. Pengukuran pengecualian yang tidak tertangkap menggunakan pelacak default yang ditentukan dalam instance GAI Anda.

Pelacak Default

Meskipun suatu implementasi dapat menggunakan beberapa pelacak, implementasi tersebut memiliki satu pelacak default secara global. Tracker pertama yang diambil akan menjadi pelacak default.

Untuk mendapatkan pelacak default, gunakan:

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

Untuk menetapkan pelacak default, gunakan:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

Pengambilan Sampel

Anda dapat mengaktifkan pengambilan sampel sisi klien untuk membatasi jumlah hit yang dikirim ke Google Analytics. Jika aplikasi Anda memiliki pengguna dalam jumlah besar atau akan mengirimkan volume data yang besar ke Google Analytics, mengaktifkan pengambilan sampel akan membantu memastikan pelaporan yang tidak terganggu.

Misalnya, untuk menerapkan pengambilan sampel sisi klien pada rasio 50%, gunakan kode berikut:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

Pilihan Tidak Ikut Tingkat Aplikasi

Anda dapat mengaktifkan tanda pilihan tidak ikut tingkat aplikasi yang akan menonaktifkan Google Analytics di seluruh aplikasi. Setelah ditetapkan, tanda akan tetap ada selama masa pakai aplikasi atau hingga direset.

Untuk mendapatkan setelan pilihan tidak ikut tingkat aplikasi, gunakan:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

Untuk menetapkan tanda tidak ikut tingkat aplikasi, gunakan:


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

Pengujian dan Proses Debug

Google Analytics SDK untuk iOS menyediakan mode debug yang akan mencetak informasi berguna tentang data yang dikirim ke Google Analytics di log Anda.

// Enable debug mode.
[GAI sharedInstance].debug = YES;