Etkinlikleri günlüğe kaydetme

iOS+ Android Web Flutter

Bu kılavuzda, uygulamanızdaki etkinlikleri nasıl günlüğe kaydedeceğiniz gösterilmektedir.

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 kaydedebebilirsiniz. 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ı arasında büyük/küçük harf kullanımı dışında bir fark olmayan iki etkinliğin kaydedilmesinin iki ayrı etkinlikle sonuçlanacağını unutmayın.

Başlamadan önce

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

Günlük etkinlikleri

Bir 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'sı, 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 hakkında ve bunları ne zaman kullanacağınız hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleyi inceleyin.

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

Önerilen etkinlik türlerinin 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 günlüğe kaydedebilirsiniz:

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

Bu, zorunlu parametreler dışında ek parametreler belirtmek istiyorsanız yararlı olabilir. Aşağıdaki parametreleri tüm etkinliklere 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 tüm parametre verileri için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak bir özel parametreyi günlüğe 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ımlamaları 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'ta bulabilirsiniz.

• value parametresi: Bir etkinlikle ilgili önemli bir metriği toplamak için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

• Parametre adları en fazla 40 karakter uzunluğunda olabilir. Alfanümerik karakterle başlamalı, yalnızca alfanümerik karakterler ve alt çizgiler 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 bir etkinlik türü tarafından karşılanmayan belirli ihtiyaçları varsa bu örnekte gösterildiği gibi kendi özel etkinliklerinizi 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 parametreleri etkinliklere kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, varsayılan etkinlik parametrelerinin Analytics raporlarında görünmesini sağlamak için bunları kaydedin.

Geçerli parametre değerleri String ve num'dur. Bir anahtarın değeri null olarak ayarlandığında söz konusu parametre temizlenir. Boş bir değer iletilmesi tüm parametreleri temizler.

// 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.

Etkinlikleri kontrol panelinde görüntüleme

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.

Bu verilere Firebase konsolundaki Etkinlikler kontrol panelinden erişebilirsiniz. Bu kontrol paneli, uygulamanız tarafından günlüğe kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporlarını gösterir.