事件可讓您深入瞭解應用程式中的活動,例如使用者動作、系統事件或錯誤。
Google Analytics 會自動記錄部分事件,您不需要新增任何程式碼即可接收這些事件。如果應用程式需要收集其他資料,您可以在應用程式中記錄最多 500 種 Analytics 事件類型。應用程式記錄的事件總量沒有上限。請注意,事件名稱有區分大小寫,如果兩個事件的名稱只有大小寫不同,系統會將其視為兩個不同的事件。
事前準備
請確認您已設定專案,並能存取 Analytics,如C++ 版 Analytics 的開始使用說明所述。
記錄事件
初始化 firebase::analytics
模組後,您可以使用該模組搭配 LogEvent()
方法記錄事件。
為協助您開始使用,Analytics SDK 定義了多項建議事件,這些事件在不同類型的應用程式中都很常見,包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件以及何時使用這些事件,請瀏覽 Firebase 說明中心的「事件和資源」文章。
如要進一步瞭解建議事件的實作方式,請參閱下列資源:
- 建議事件:請參閱
Event
常數清單。 - 規定的參數:請參閱
Parameters
常數清單。
以下範例說明如何記錄建議的 SELECT_CONTENT
事件:
const analytics::Parameter kSelectContentParameters[] = { analytics::Parameter(analytics::kParameterItemID , id), analytics::Parameter(analytics::kParameterItemName, "name"), analytics::Parameter(analytics::kUserPropertySignUpMethod, "Google"), analytics::Parameter("favorite_food", mFavoriteFood), analytics::Parameter("user_id", mUserId), }; analytics::LogEvent( analytics::kEventSelectContent, kSelectContentParameters, sizeof(kSelectContentParameters) / sizeof(kSelectContentParameters[0]));
除了規定的參數外,您也可以在任何事件中加入下列參數:
自訂參數:自訂參數不會直接顯示在 Analytics 報表中,但可用於目標對象定義中的篩選器,並套用至每份報表。如果應用程式已連結至 BigQuery 專案,則匯出至 BigQuery 的資料也會包含自訂參數。
VALUE
參數:VALUE
是通用參數,可用於累積與 Analytics 事件相關的重要指標。例如收入、距離、時間和分數。
如果應用程式有特定需求,而建議的 Analytics 事件類型無法涵蓋這些需求,您可以記錄自訂 Analytics 事件,如以下範例所示:
// Copyright 2016 Google Inc. All rights reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #include "firebase/analytics.h" #include "firebase/analytics/event_names.h" #include "firebase/analytics/parameter_names.h" #include "firebase/analytics/user_property_names.h" #include "firebase/app.h" // Thin OS abstraction layer. #include "main.h" // NOLINT // Execute all methods of the C++ Analytics API. extern "C" int common_main(int argc, const char* argv[]) { namespace analytics = ::firebase::analytics; ::firebase::App* app; LogMessage("Initialize the Analytics library"); #if defined(__ANDROID__) app = ::firebase::App::Create(GetJniEnv(), GetActivity()); #else app = ::firebase::App::Create(); #endif // defined(__ANDROID__) LogMessage("Created the firebase app %x", static_cast<int>(reinterpret_cast<intptr_t>(app))); analytics::Initialize(*app); LogMessage("Initialized the firebase analytics API"); LogMessage("Enabling data collection."); analytics::SetAnalyticsCollectionEnabled(true); // App session times out after 30 minutes. // If the app is placed in the background and returns to the foreground after // the timeout is expired analytics will log a new session. analytics::SetSessionTimeoutDuration(1000 * 60 * 30); LogMessage("Get App Instance ID..."); auto future_result = analytics::GetAnalyticsInstanceId(); while (future_result.status() == firebase::kFutureStatusPending) { if (ProcessEvents(1000)) break; } if (future_result.status() == firebase::kFutureStatusComplete) { LogMessage("Analytics Instance ID %s", future_result.result()->c_str()); } else { LogMessage("ERROR: Failed to fetch Analytics Instance ID %s (%d)", future_result.error_message(), future_result.error()); } LogMessage("Set user properties."); // Set the user's sign up method. analytics::SetUserProperty(analytics::kUserPropertySignUpMethod, "Google"); // Set the user ID. analytics::SetUserId("uber_user_510"); LogMessage("Log current screen."); // Log the user's current screen. analytics::LogEvent(analytics::kEventScreenView, "Firebase Analytics C++ testapp", "testapp" ); // Log an event with no parameters. LogMessage("Log login event."); analytics::LogEvent(analytics::kEventLogin); // Log an event with a floating point parameter. LogMessage("Log progress event."); analytics::LogEvent("progress", "percent", 0.4f); // Log an event with an integer parameter. LogMessage("Log post score event."); analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42); // Log an event with a string parameter. LogMessage("Log group join event."); analytics::LogEvent(analytics::kEventJoinGroup, analytics::kParameterGroupID, "spoon_welders"); // Log an event with multiple parameters. LogMessage("Log level up event."); { const analytics::Parameter kLevelUpParameters[] = { analytics::Parameter(analytics::kParameterLevel, 5), analytics::Parameter(analytics::kParameterCharacter, "mrspoon"), analytics::Parameter("hit_accuracy", 3.14f), }; analytics::LogEvent( analytics::kEventLevelUp, kLevelUpParameters, sizeof(kLevelUpParameters) / sizeof(kLevelUpParameters[0])); } LogMessage("Complete"); // Wait until the user wants to quit the app. while (!ProcessEvents(1000)) { } analytics::Terminate(); delete app; LogMessage("Shutdown"); return 0; }
在 Android Studio 偵錯記錄中查看事件
您可以啟用詳細記錄功能,監控 SDK 記錄的事件,以便確認事件是否正確記錄。這包括自動記錄和手動記錄的事件。
您可以使用一系列 ADB 指令啟用詳細記錄功能:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
這個指令會在 Android Studio 的 Logcat 中顯示事件,協助您立即驗證事件是否已傳送。
在資訊主頁中查看數據分析事件
您可以在 Firebase 主控台資訊主頁中,查看 Analytics 事件的匯總統計資料。這些資訊主頁會在一天中定期更新。如要立即測試,請按照上一節所述使用 logcat 輸出內容。
如何在 Firebase 控制台中存取這項資料:
- 在 Firebase 主控台中開啟專案。
- 選取選單中的 Analytics,即可查看 Analytics 報表資訊主頁。
「Events」分頁會顯示系統為應用程式記錄的每種 Analytics 事件類型自動建立的事件報表。如要進一步瞭解資訊主頁,請參閱這篇文章。