Etkinlikleri günlüğe kaydetme

Uygulamanızda neler olduğuna dair analizler sağlayan etkinlikler. Örnek olarak, kullanıcı işlemleri, sistem etkinlikleri veya hatalar gösterilebilir.

Google Analytics bazı etkinlikleri sizin için otomatik olarak kaydeder; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa uygulamanıza 500 farklı türde Analytics etkinliği kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam hacminin sınırı yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf kullanımı bakımından farklı iki etkinliğin kaydedilmesinin, iki farklı etkinliğin kaydedilmesine neden olacağını unutmayın.

Başlamadan önce

Projenizi oluşturduğunuzdan ve C++ için Analytics'ü kullanmaya başlama bölümünde açıklandığı gibi Analytics'e erişebildiğinizden emin olun.

Günlük etkinlikleri

firebase::analytics modülünü başlattıktan sonra LogEvent() yöntemiyle etkinlikleri günlüğe kaydetmek için kullanabilirsiniz.

Başlamanıza yardımcı olmak için Analytics SDK'sı, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türleri arasında yaygın olan çeşitli önerilen etkinlikler tanımlar. Bu etkinlikler ve ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için Firebase Yardım Merkezi'ndeki Etkinlikler ve mülkler makalelerine göz atın.

Not: Raporlarda maksimum düzeyde ayrıntı elde etmek için uygulamanız için anlamlı olan önerilen Analytics etkinlikleri ve bunların belirtilen parametrelerini günlüğe kaydedin. Bu sayede, kullanıma sunulan en yeni Google Analytics özelliklerinden de yararlanabilirsiniz.

Önerilen etkinliklerin uygulama ayrıntılarını aşağıdaki konumlarda bulabilirsiniz:

• Önerilen etkinlikler: Event sabitlerinin listesine bakın.
• Önerilen parametreler: Parameters sabitlerinin listesine bakın.

Aşağıdaki örnekte, önerilen bir SELECT_CONTENT etkinliğinin nasıl kaydedileceği gösterilmektedir:

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

Önerilen parametrelere ek olarak, tüm etkinliklere aşağıdaki parametreleri ekleyebilirsiniz:

• Özel parametreler: Özel parametreler doğrudan Analytics raporlarınızda temsil edilmez ancak her rapora uygulanabilen Kitle tanımlarında filtre olarak kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler, BigQuery'ye aktarılan verilere de dahil edilir.

• VALUE Parametresi: VALUE, Analytics Etkinliği ile ilgili önemli bir metriği toplamak için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

Uygulamanızda, önerilen bir Analytics etkinlik türü tarafından karşılanmayan belirli ihtiyaçlar varsa bu örnekte gösterildiği gibi kendi özel Analytics etkinliklerinizi günlüğe kaydedebilirsiniz:

// 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 hata ayıklama günlüğünde etkinlikleri görüntüleme

Etkinliklerin SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlük kaydını etkinleştirerek etkinliklerin doğru şekilde günlüğe kaydedildiğini doğrulayabilirsiniz. Hem otomatik olarak hem de manuel olarak kaydedilen etkinlikler buna dahildir.

Ayrıntılı günlük kaydını bir dizi adb komutuyla etkinleştirebilirsiniz:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

Bu komut, etkinliklerinizi Android Studio logcat'te gösterir ve etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Kontrol panelinde analiz etkinliklerini görüntüleme

Analytics etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görüntüleyebilirsiniz. Bu gösterge tabloları gün içinde düzenli aralıklarla güncellenir. Anında test etmek için, logcat çıkışlarını önceki bölümde açıklandığı şekilde kullanın.

Firebase konsolunda bu verilere erişmek için:

1. Firebase konsolunda projenizi açın.
2. Analytics raporlama kontrol panelini görüntülemek için menüden Analytics'i seçin.

Etkinlikler sekmesi, uygulamanız tarafından günlüğe kaydedilen her farklı Analytics etkinliği türü için otomatik olarak oluşturulan etkinlik raporlarını gösterir. Kontrol paneli hakkında daha fazla bilgi edinin.