Günlük Etkinlikleri

Platform seçin: iOS+ Android Web Flutter Unity C++


Analytics, bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder. Bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa uygulamanızda 500'e kadar farklı Analytics etkinlik türü kaydedebilirsiniz. Uygulamanızın kaydettiği toplam etkinlik hacmiyle ilgili bir 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ı etkinlikle sonuçlanacağını unutmayın.

Başlamadan önce

Projenizi ayarladığınızdan ve Analytics'i kullanmaya başlama bölümünde açıklandığı şekilde Analytics'e erişebildiğinizden emin olun.

Apple platformu uygulamaları için kampanya ilişkilendirme verileri toplamak istiyorsanız projenize AdSupport çerçevesini eklediğinizden emin olun.

Günlük etkinlikleri

FirebaseAnalytics örneği oluşturduktan sonra, kitaplığın log yöntemlerini kullanarak etkinlikleri günlüğe kaydedebilirsiniz.

Önceden tanımlanmış etkinlikler

Analytics SDK'sı, başlamanıza yardımcı olmak için perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türleri arasında yaygın olan bir dizi önerilen etkinlik tanımlar. Bu etkinlikler ve ne zaman kullanılacakları hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleyi inceleyin.

Önerilen etkinlik türleri için günlük yöntemlerini API referansında bulabilirsiniz.

Aşağıdaki örnekte, select_content etkinliğinin nasıl günlüğe kaydedileceği gösterilmektedir:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Alternatif olarak, aynı etkinliği logEvent() kullanarak da kaydedebilirsiniz:

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Bu, öngörülen (gerekli) parametreler dışında ek parametreler belirtmek istediğinizde yararlı olabilir. Herhangi bir etkinliğe aşağıdaki parametreleri ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler, Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan etkinlik parametresi verileri için özel boyutları, sayısal olarak daha iyi temsil edilen parametre verileri için ise özel metrikleri kullanabilirsiniz. SDK'yı kullanarak özel bir parametre kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bunu yapmak için Analytics > Etkinlikler > Özel Tanımları Yönet > Özel Boyut Oluştur'u kullanın.

    Özel parametreler, her rapora uygulanabilecek kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler BigQuery'ye aktarılan verilere de dahil edilir. Örnek sorguları ve daha fazlasını Google Analytics 4 BigQuery Export sayfasında bulabilirsiniz.

  • value parametresi: Bir etkinlikle ilgili önemli bir metriği toplamak için kullanışlı olan genel amaçlı bir parametredir. Gelir, mesafe, zaman ve puanlar buna örnek olarak verilebilir.

  • Parametre adları en fazla 40 karakter uzunluğunda olabilir, alfabetik karakterle başlamalı ve yalnızca alfanümerik karakterler ile alt çizgi içermelidir. Dize ve sayı türleri desteklenir. Dize parametresi değerleri en fazla 100 karakter uzunluğunda olabilir. "firebase", "google" ve "ga_" ön ekleri ayrılmıştır ve parametre adları için kullanılmamalıdır.

Özel etkinlikler

Uygulamanızın, önerilen etkinlik türleri tarafından karşılanmayan özel ihtiyaçları varsa aşağıdaki örnekte gösterildiği gibi kendi özel etkinliklerinizi kaydedebilirsiniz:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters() kullanarak etkinlikler genelinde parametreleri günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen gelecekteki tüm etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, varsayılan etkinlik parametrelerini de Analytics raporlarında görünmeleri için kaydedin.

Geçerli parametre değerleri dize ve sayıdır. Bir anahtarın değerini null olarak ayarlamak, ilgili parametreyi temizler. Boş bir değer iletildiğinde tüm parametreler temizlenir.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

logEvent() veya log yönteminde bir parametre belirtilirse varsayılan değer yerine bu değer kullanılır.

Varsayılan bir parametreyi temizlemek için parametre null olarak ayarlanmış şekilde setDefaultEventParameters() yöntemini çağırın.