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. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veriler toplaması gerekiyorsa uygulamanızda 500'e kadar farklı Analytics etkinliği türü kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam 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 ayrı etkinliğin kaydedilmesine neden olacağı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 verilerini toplamak istiyorsanız AdSupport çerçevesini projenize eklediğinizden emin olun.

Günlük etkinlikleri

FirebaseAnalytics örneği oluşturduktan sonra, kitaplığın log yöntemleriyle etkinlikleri günlüğe kaydetmek için bu örneği kullanabilirsiniz.

Önceden tanımlanmış etkinlikler

Başlamanıza yardımcı olmak için Analytics SDK, 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ürleriyle ilgili günlük yöntemlerini API referansında bulabilirsiniz.

Aşağıdaki örnekte, bir 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, belirtilen (zorunlu) parametreler dışında ek parametreler belirtmek istediğinizde yararlı olabilir. Aşağıdaki parametreleri herhangi bir etkinliğe 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 parametreyi kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bu işlemi Analytics > Etkinlikler > Özel Tanımları Yönetin > Özel Boyutlar Oluşturun'u kullanarak yapın.

    Özel parametreler, her rapora uygulanabilen kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler de BigQuery'ye aktarılan verilere 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 biriktirmek için yararlı olan genel amaçlı bir parametre. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

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

Özel etkinlikler

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

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

Varsayılan etkinlik parametrelerini ayarlama

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

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

Geçerli parametre değerleri String ve num'dur. Bir anahtarın değerini null olarak ayarlamak ilgili parametreyi temizler. Boş değer iletmek tüm parametreleri temizler.

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

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

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