本開發人員指南說明如何使用 iOS 3 版 Google Analytics (分析) SDK 導入自訂維度和指標。
總覽
自訂維度可讓您在 Google Analytics (分析) 中連結中繼資料與命中、使用者和工作階段，自訂指標則可讓您在 Google Analytics (分析) 中建立並遞增自己的指標。
- 使用 Google Analytics (分析) 網頁介面設定自訂維度或指標。 瞭解如何設定自訂維度或指標 (說明中心)。
- 透過應用程式設定及傳送自訂維度和指標值。
自訂維度和指標由兩個欄位組成：
-
NSNumber索引：自訂維度或指標的索引。這項索引是從 1 開始。 -
NSString值 – 自訂維度或指標的值。在這種情況下，如果指標是設為貨幣類型，則會剖析為整數或固定小數點小數。
設定和傳送值
如何設定並傳送自訂維度值：
// 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]];
您可以使用任何 Google Analytics (分析) 命中類型傳送自訂維度值，包括畫面瀏覽、事件、電子商務交易、使用者時間和社交互動。自訂維度的定義範圍 會決定處理時間時，哪些命中與維度值相關聯。
如要設定並傳送自訂指標值，請按照下列步驟操作：
// 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.
作品注意事項
本節將說明導入自訂維度或指標時，需注意的其他事項。
自訂維度的注意事項
含使用者和工作階段層級範圍的值會套用至過往命中
- 使用者或工作階段層級的自訂維度值會套用至目前工作階段中的所有命中，包括過去的命中。如果您不希望將工作階段或使用者層級範圍的自訂維度值套用至目前工作階段中的過往命中，請先啟動新的工作階段，再將值套用至命中資料。
- 舉例來說，假設您使用會員類型做為使用者層級自訂維度，並在使用者在工作階段期間進行升級，建議您在設定新的自訂維度值之前，先開始新的工作階段。這樣可確保升級前的命中連結至舊的會籍值，同時新的命中資料則會連結至新值。
自訂維度和資料檢視 (設定檔) 篩選器
- 使用者或工作階段層級的自訂維度值仍會套用至目前和/或日後工作階段中的所有命中，即使這些命中從資料檢視 (設定檔) 中篩除也一樣。
- 篩選自訂維度值時，系統會根據該自訂維度值的範圍篩選命中。進一步瞭解篩選器和自訂維度值在資料處理時如何互動。
自訂指標的注意事項
報表中的自訂指標值匯總資料
- 系統會在報表中匯總自訂指標值，就像 Google Analytics (分析) 中的其他預先定義指標一樣。因此，您可以將自訂指標值設為
1，增加報表中的指標匯總總數。
自訂指標和資料檢視 (設定檔) 篩選器
- 雖然您通常可以在方便的情況下設定自訂指標值，但請避免為可能從資料檢視 (設定檔) 中篩除的命中設定自訂指標值。如果命中遭到資料檢視 (設定檔) 篩選器篩選，則任何相關聯的自訂指標值也會遭到篩除。進一步瞭解自訂維度和指標，以及資料檢視 (設定檔) 篩選器。
使用自動螢幕評估功能設定價值
- 如要將自訂維度值套用至透過自動螢幕測量傳送的畫面檢視畫面，請在檢視控制器的
viewDidAppear:方法中設定值。例如，檢視控制器的.m檔案可能如下所示：
#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.
請勿傳送個人識別資訊 (PII) 做為值