本開發人員指南說明如何使用 Android 專用 Google Analytics (分析) SDK v4 導入自訂維度和指標。
總覽
你可以採取下列行動：
- 使用 Google Analytics (分析) 網頁介面設定自訂維度或指標。 瞭解如何設定自訂維度或指標 (說明中心)。
- 透過應用程式設定及傳送自訂維度和指標值。
自訂維度和指標由兩個欄位組成：
| 欄位名稱 | 類型 | 說明 |
|---|---|---|
| 索引 | Integer |
自訂維度或指標的索引。這項索引是從 1 開始。 |
| 值 | String |
自訂維度或指標的值。 在這種情況下，如果指標是設為貨幣類型，則會剖析為整數或固定小數點小數。 |
設定和傳送值
如何設定並傳送自訂維度值：
// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");
// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
.setCustomDimension(1, "premiumUser")
.build()
);
您可以使用任何 Google Analytics (分析) 命中類型傳送自訂維度值，包括畫面瀏覽、事件、電子商務交易、使用者時間和社交互動。自訂維度的定義範圍 會決定處理時間時，哪些命中與維度值相關聯。
如要設定並傳送自訂指標值，請按照下列步驟操作：
// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");
// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
.setCustomMetric(1, 5)
.build()
);
如要進一步瞭解 getTracker 方法，請參閱「
進階設定」。
作品注意事項
本節將說明導入自訂維度或指標時，需注意的其他事項。
自訂維度的注意事項
含使用者和工作階段層級範圍的值會套用至過往命中
- 使用者或工作階段層級的自訂維度值會套用至目前工作階段中的所有命中，包括過去的命中。如果您不希望將工作階段或使用者層級範圍的自訂維度值套用至目前工作階段中的過往命中，請先啟動新的工作階段，再將值套用至命中資料。
- 舉例來說，假設您使用會員類型做為使用者層級自訂維度，並在使用者在工作階段期間進行升級，建議您在設定新的自訂維度值之前，先開始新的工作階段。這樣可確保升級前的命中連結至舊的會籍值，同時新的命中資料則會連結至新值。
自訂維度和資料檢視 (設定檔) 篩選器
- 使用者或工作階段層級的自訂維度值仍會套用至目前和/或日後工作階段中的所有命中，即使這些命中從資料檢視 (設定檔) 中篩除也一樣。
- 篩選自訂維度值時，系統會根據該自訂維度值的範圍篩選命中。進一步瞭解篩選器和自訂維度值在資料處理時如何互動。
自訂指標的注意事項
報表中的自訂指標值匯總資料
- 系統會在報表中匯總自訂指標值，就像 Google Analytics (分析) 中的其他預先定義指標一樣。因此，您可以將自訂指標值設為
1，增加報表中的指標匯總總數。
自訂指標和資料檢視 (設定檔) 篩選器
- 雖然您通常可以在方便的情況下設定自訂指標值，但請避免為可能從資料檢視 (設定檔) 中篩除的命中設定自訂指標值。如果命中遭到資料檢視 (設定檔) 篩選器篩選，則任何相關聯的自訂指標值也會遭到篩除。進一步瞭解自訂維度和指標，以及資料檢視 (設定檔) 篩選器。
使用自動螢幕評估功能設定價值
- 如要將自訂維度值套用至透過自動螢幕測量功能傳送的畫面檢視畫面，請在
onStart()期間呼叫activityStart()之前的值。請注意，如果在onStart()執行時不知道該值，建議您改為手動評估螢幕。
請勿傳送個人識別資訊 (PII) 做為值