Google Analytics 4 Data API'ye Genel Bakış

Google Analytics 4 (GA4) rapor verilerine programatik olarak erişmek için Data API'yi kullanabilirsiniz. Bu API, eski Universal Analytics mülkleriyle uyumlu değildir.

Google Analytics 4 mülkleri hakkında daha fazla bilgi edinin.

Google Analytics Data API v1'i kullanarak raporlayabileceğiniz bazı örnekler:

  • Android uygulamanızın geçen hafta içindeki günlük etkin kullanıcı sayısı.
  • Sitenizdeki ilk 10 sayfanın son 28 günde aldığı sayfa görüntüleme sayısı.
  • iOS uygulamanızın son 30 dakika içinde ülke başına etkin kullanıcı sayısı.

Ayrıca, aşağıdakileri yapmak için Google Analytics Data API v1'i de kullanabilirsiniz:

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

Başlayın

Kullanmaya başlamak için istemci kitaplığı hızlı başlangıç kılavuzunu inceleyin. Uygulamanızı basitleştirmek için Java, Python, Node.js ve diğer dillerde istemci kitaplıkları vardır.

Kullanılabilir yöntemler

Aşağıda, Veri API'sı yöntemlerinin bir listesi verilmiştir. Daha fazla ayrıntı için referans belgelere bakın.

  • 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şturmanıza olanak tanıyan runReport yönteminin toplu 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 ifade gücü yüksek biçimlerdir. Her pivot, rapor yanıtındaki görünür boyut sütunlarını ve satırları açıklar.
  • batchRunPivotReports Bu, tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanıyan runPivotReport yönteminin toplu sürümüdür.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyut ve metriklerin meta verilerini döndürür. Boyutları 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.
  • checkCompatibility Bu yöntemde, rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyut ve metrikler listelenir.
  • runRealtimeReport Bu yöntem, mülkünüz için özelleştirilmiş bir gerçek zamanlı etkinlik verileri raporu döndürür. Etkinlikler Google Analytics'e gönderildikten saniyeler sonra gerçek zamanlı raporlarda görünür. Gerçek zamanlı raporlar, geçerli andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için 60 dakikaya kadar) zaman aralıklarına ait etkinlik ve kullanım verilerini gösterir.
  • properties.audienceExports Bir kitledeki kullanıcıların anlık görüntüsünü içeren Kitle Dışa Aktarmaları oluşturmanıza olanak tanıyan bir yöntem grubu.
  • properties.recurringAudienceLists (Erken önizleme) Yinelenen kitle dışa aktarma işlemlerini yönetmenize olanak tanıyan bir grup yöntem. Yinelenen bir kitle dışa aktarma işlemi, her gün yeni kitle listeleri üretir.
  • runFunnelReport (Erken önizleme) Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir dönüşüm hunisi raporunu döndürür. Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlamak için uyguladığı adımları görselleştirmenize ve her adımda ne kadar başarılı veya başarısız olduklarını hızlı bir şekilde görmenize olanak tanır.

Desteklenen boyutlar ve metrikler

Data API tarafından desteklenen tüm boyutların ve metriklerin listesi için API şeması dokümanlarına bakın.