自訂維度和指標 - iOS SDK

本開發人員指南說明如何使用 iOS 專用的 Google Analytics (分析) SDK 導入自訂維度和指標。

總覽

使用 iOS 版 Google Analytics (分析) SDK 設定自訂維度或指標值後，系統會將該值做為參數，連同下一次分派的下一筆命中一起傳送。這些值可套用至任何 Google Analytics (分析) 命中類型，包括畫面瀏覽、事件、電子商務交易、使用者時間和社交互動。

導入自訂維度或指標主要有以下兩個步驟：

使用 Google Analytics (分析) 網頁介面定義自訂維度或指標。
在網頁介面的資源設定部分中，設定自訂維度或指標的索引、名稱和範圍。
瞭解如何定義自訂維度或指標。
導入程式碼來設定及收集自訂維度和指標值。
在應用程式中加入程式碼，以您在先前步驟中定義的索引，為 Google Analytics (分析) 命中設定自訂維度或指標值。

本文的其餘部分將說明如何導入程式碼，以設定自訂維度或指標值，並傳送至 Google Analytics (分析)。

自訂維度

所有 Google Analytics (分析) 命中類型都可以設定自訂維度值。請在要套用價值的傳送呼叫前，設定自訂維度值。

自訂維度的定義範圍會決定哪些其他命中在處理時可能與該值建立關聯。

您必須完成下列欄位，才能設定自訂維度值：

NSNumber 索引：自訂維度定義的索引。這項索引是從 1 開始。
NSString 值 – 自訂維度的值。

設定自訂維度值

如要設定自訂維度值，請先呼叫 setCustom:dimension: 再呼叫要與值建立關聯的呼叫：

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

作品注意事項

本節將說明導入自訂維度時需注意的其他事項。

使用者和工作階段層級範圍為 Greedy

使用者或工作階段層級的自訂維度值會套用至目前工作階段中的所有命中，包括過去的命中。如果您不希望將工作階段或使用者層級範圍的自訂維度值套用至目前工作階段中的過往命中，請先啟動新的工作階段，再將值套用至命中資料。

舉例來說，假設您使用會員類型做為使用者層級自訂維度，並在使用者在工作階段期間升級成員資格，不妨先開始新工作階段，再設定新的自訂維度值。這樣可確保升級前的命中連結了舊的會員資格值，而新的命中值則會連結至新的值。

自訂維度和資料檢視 (設定檔) 篩選器

使用者或工作階段層級的自訂維度值仍會套用至目前和/或未來工作階段中的所有命中，即使與這些命中搭配使用的命中是從資料檢視 (設定檔) 中篩除也一樣。

篩選自訂維度值時，系統會根據該自訂維度值的範圍篩選命中。

如要進一步瞭解篩選器和自訂維度值在資料處理時的互動方式，請參閱本文。

使用自動螢幕評估功能設定價值

如要將自訂維度值套用至透過自動螢幕測量功能傳送的畫面檢視畫面，請在檢視控制器的 viewDidAppear: 方法中設定值。例如，檢視控制器的 .m 檔案可能如下所示：

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

請勿傳送個人識別資訊 (PII) 做為值

Google Analytics (分析) 服務條款禁止將任何個人識別資訊 (PII) 傳送至 Google Analytics (分析) 伺服器。如需更多資訊，請參閱《服務條款》。

自訂指標

雖然自訂維度必須謹慎套用至特定命中，並由「範圍」管理，但套用自訂指標的命中一般不會影響報表，因此可在知道指標值時設定。

您必須填寫下列欄位，才能設定自訂指標值：

NSInteger索引 – 自訂指標定義的索引。
NSNumber 值 – 自訂指標的值。數值可以是負數。

設定自訂指標值

如要設定自訂指標值，請在再次傳送呼叫之前呼叫 setCustom:metric:：

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

或是設定貨幣自訂指標：

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

作品注意事項

下節將說明規劃自訂維度或指標導入作業時，需注意的其他事項。

報表中的自訂指標值匯總資料

自訂指標值會彙整在報表中，就像 Google Analytics (分析) 中的其他預先定義指標一樣。因此，您可以將自訂指標值設為 1，增加報表中的指標匯總總數。

自訂指標和資料檢視 (設定檔) 篩選器

雖然您通常可以在方便的情況下設定自訂指標值，但請避免為可能從資料檢視 (設定檔) 中篩除的命中設定自訂指標值。如果命中遭到資料檢視 (設定檔) 篩選器篩選，則任何相關聯的自訂指標值也會遭到篩除。進一步瞭解自訂維度和指標，以及資料檢視 (設定檔) 篩選器。