分派 - Android SDK

本文說明如何使用 Google Analytics (分析) SDK v3 管理將資料分派至 Google Analytics (分析)。

總覽

使用 Android 專用 Google Analytics (分析) SDK 收集到的資料會先儲存在本機,再分派至個別的執行緒給 Google Analytics (分析)。

必須在每個資料檢視的當地時區隔天上午 4 點前分派及接收資料。凡是之後收到的資料都不會顯示在報表中。舉例來說,如果命中在本機中午 11:59 加入佇列,則命中必須在 4 小時內 (上午 3:59) 分派在報表中。另一方面,在上午 12:00 時排入佇列的命中必須在 28 小時內分派,例如則要在報表中顯示。

定期派遣

根據預設,系統每 30 分鐘就會從 Android 專用 Google Analytics (分析) SDK 分派資料。

如何透過程式輔助方式設定分派週期:

// Set the dispatch period in seconds.
GAServiceManager.getInstance().setLocalDispatchPeriod(15);

如何使用 EasyTracker 設定 XML 中的分派期:

<integer name="ga_dispatchPeriod">30</integer>

設定負值後,系統會停用定期調度功能;如果您要將任何資料傳送至 Google Analytics (分析),就必須使用手動調度

// Disable periodic dispatch by setting dispatch period to a value less than 1.
GoogleAnalytics.getInstance(this).setDispatchPeriod(0);

如果使用者在尚未分派的命中資料的情況下遺失網路存取權或關閉應用程式,則這些命中資料會保留在本機儲存空間中。系統會在您下次執行應用程式並呼叫調度器時,分派這些錯誤。

手動調度

如要手動分派命中,例如,如果您知道裝置無線電已用於傳送其他資料,請按照下列步驟操作:

GAServiceManager.getInstance().dispatchLocalHits();