Analytics Data API'ye Genel Bakış

Google Analytics Data API v1, Google Analytics 4 (GA4) rapor verilerine programatik erişim 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 Data API v1 ile aşağıdaki gibi soruları yanıtlamak için raporlar oluşturabilirsiniz:

  • Android uygulamamın geçen hafta günlük etkin kullanıcı sayısı kaçtı?
  • Sitemdeki en iyi 10 sayfa URL'sinin her biri son 28 günde kaç sayfa görüntüleme aldı?
  • iOS uygulamamın son 30 dakika içinde ülke başına etkin kullanıcı sayısı nedir?

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

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

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

İlk raporunuzu oluşturmak için API'yi çağırmak sadece birkaç satır kod uzağınızdadır. Başlamak için istemci kitaplıklarını 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ı vardır.

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, runReport yönteminin toplu sürümüdür. Bu yöntem, tek bir API çağrısı kullanarak birden fazla rapor oluşturulmasına olanak tanır.
  • runPivotReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlara göre daha gelişmiş ve ifade odaklı biçimlerdir. Her pivot, rapor yanıtındaki görünür boyut sütunlarını ve satırları açıklar.
  • batchRunPivotReports Bu, runPivotReport yönteminin toplu sürümüdür. Bu yöntem, tek bir API çağrısı kullanarak birden fazla rapor oluşturulmasına olanak tanır.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyutlar ve metriklere ait meta verileri döndürür. Boyutları ve metrikleri incelemek 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öntem, bir rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutları ve metrikleri listeler.
  • 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, içinde bulunulan 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şturmaya olanak tanıyan bir yöntem grubu.
  • properties.recurringAudienceLists (Erken önizleme) Yinelenen Kitle Dışa Aktarma işlemlerini yönetmeye olanak tanıyan bir yöntem grubu. Yinelenen bir kitle dışa aktarımı, her gün yeni kitle listeleri üretir.
  • 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ı belgelerinde, Analytics Data API tarafından şu anda desteklenen boyut ve metrikler listelenmektedir.