Analytics Veri API'sına Genel Bakış

Google Analytics Data API v1, Google Analytics 4 (GA4) rapor verilerine programatik erişim imkanı sunar. Google Analytics 4, kullanıcıların web, iOS veya Android uygulamanızı nasıl kullandığını anlamanıza yardımcı olur. Google Analytics 4 mülkleri hakkında daha fazla bilgi edinin.

Google Analytics Veri API'si v1 ile aşağıdakiler gibi soruları cevaplayacak raporlar oluşturabilirsiniz:

  • Geçen hafta Android uygulamamın günlük etkin kullanıcı sayısı kaç?
  • Son 28 gün içinde sitem için en çok görüntülenen 10 sayfa URL'sinin her biri kaç sayfa görüntüleme aldı?
  • Son 30 dakika içinde her ülkemde iOS uygulamasının kaç etkin kullanıcısı vardı?

Google Analytics Data API v1, şu amaçlarla da kullanılabilir:

  • Google Analytics verilerini görüntülemek için özel gösterge tabloları oluşturun.
  • Zaman kazanmak için karmaşık raporlama görevlerini otomatikleştirin.
  • Google Analytics verilerinizi diğer iş uygulamalarıyla entegre edin.

Hızlı başlangıç kılavuzu

İlk raporunuzu oluşturmak için API'yi çağırmanız yeterlidir. Başlamak için istemci kitaplıkları kullanmaya hızlı bir başlangıç yapın. Uygulamanızı basitleştirmek için Java, Python, Node.js ve diğer dillerde istemci kitaplıkları mevcuttur.

Kullanılabilir yöntemler

  • runReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir raporunu döndürür ve basit rapor sorguları için tercih edilen yöntemdir.
  • batchRunreports Bu, tek bir API çağrısı kullanarak birden fazla rapor oluşturmaya olanak tanıyan RunReport yönteminin toplu bir sürümüdür.
  • runPivotReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlardan daha gelişmiş ve anlamlı biçimlerdir. Her bir pivot tablo, rapor yanıtındaki görünür boyut sütunlarını ve satırları açıklar.
  • batchRunPivotreports Bu, RunPivotReport yönteminin tek bir API çağrısı kullanarak birden çok rapor oluşturmaya olanak tanıyan bir toplu sürümüdür.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyutlara ve metriklere ait meta verileri döndürür. Boyut ve metrikleri keşfetmek için kullanılır. Bu yöntemin yanıtı, belirtilen GA4 mülkü için kullanılabilen Özel boyutları ve metrikleri de içerir.
  • runRealtimeReport Bu yöntem, mülkünüz için gerçek zamanlı etkinlik verilerinin özelleştirilmiş bir raporunu döndürür. Etkinlikler, Google Analytics'e gönderilmelerinden saniyeler sonra gerçek zamanlı raporlarda görünür. Gerçek zamanlı raporlar geçerli zaman aralığından 30 dakika öncesine kadar (Google Analytics 360 mülkleri için en fazla 60 dakika) etkinlik ve kullanım verilerini gösterir.
  • runFunnelReport (Erken önizleme) Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir dönüşüm hunisi raporu döndürür. Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlamak için izlediği adımları görselleştirmenize ve her adımda ne kadar başarılı ya da başarısız olduklarını hızlı bir şekilde görmenize olanak tanır.

Desteklenen boyutlar ve metrikler

API şeması dokümanları, Analytics Data API tarafından şu anda desteklenen boyutları ve metrikleri listeler.