本文件會概略介紹 iOS v2 專用的 Google Analytics (分析) SDK 部分進階設定。
總覽
iOS 版 Google Analytics (分析) SDK 使用兩個類別來管理導入的全域狀態,以及將資料傳送至 Google Analytics (分析) 伺服器。
GAI
:處理實作全域狀態的單例模式,包括取得新的GAITracker
物件,以及應用程式層級的退出設定和分派設定。GAITracker
- 用來將資料傳送至 Google Analytics (分析) 的類別。您可以將多個追蹤程式例項化,每個不重複屬性 ID 一個。
使用多個追蹤器
自第 2 版 SDK 起,您可以在單一實作中使用多個追蹤程式,每個專屬追蹤 ID 各有一個追蹤程式。所有追蹤器都會共用您的 GAI
單例模式所持有的全域狀態。
在以下範例中,使用兩個追蹤程式 (每個有專屬的資源 ID) 的追蹤程式,將畫面瀏覽傳送至兩個不同的資源:
#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
請注意,自動評估和未偵測到的例外狀況評估等自動評估功能只會使用一個追蹤器傳送資料至 Google Analytics (分析)。如果您正在使用這些功能,並希望使用其他追蹤器傳送資料,則必須手動進行。
為方便您參考,自動螢幕測量功能會使用指定 GAITrackedViewController
的 tracker
屬性中指定的追蹤器。未偵測到的例外狀況測量會使用 GAI
執行個體中指定的預設追蹤程式。
預設追蹤器
雖然實作可能會使用多個追蹤程式,但全域上只有一個預設追蹤器。第一個擷取的 Tracker
會成為預設追蹤程式。
如要取得預設追蹤器,請使用:
// Get default tracker. idmyDefault = [GAI sharedInstance].defaultTracker;
若要設定預設追蹤器,請使用:
// Get a new tracker. idnewTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID"); // Set the new tracker as the default tracker, globally. [GAI sharedInstance].defaultTracker = newTracker;
取樣
您可以啟用用戶端取樣功能,限制傳送至 Google Analytics (分析) 的命中次數。如果應用程式的使用者人數較多,或是以其他方式傳送大量資料至 Google Analytics (分析),啟用取樣功能可確保報表資料不會中斷。
舉例來說,如要以 50% 的速率實作用戶端取樣,請使用下列程式碼:
// Set a sample rate of 50%. [tracker setSampleRate:50.0]; // Sample rate is a double.
在應用程式層級選擇不採用
您可以啟用應用程式層級的選擇不採用標記,藉此停用整個應用程式的 Google Analytics (分析)。設定之後,該標記會在應用程式生命週期內持續有效,直到您重設為止。
如要取得應用程式層級的停用設定,請使用:
// Get the app-level opt out preference. if ([GAI sharedInstance].optOut) { ... // Alert the user they have opted out. }
如要設定應用程式層級的選擇不採用標記,請使用:
// Set the app-level opt out preference. [[GAI sharedInstance].setOptOut = YES];
測試和偵錯
iOS 版 Google Analytics (分析) SDK 提供偵錯模式,方便您查看記錄檔中已傳送哪些資料給 Google Analytics (分析) 的實用資訊。
// Enable debug mode. [GAI sharedInstance].debug = YES;