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 Veri API'sı v1 ile aşağıdaki gibi soruları yanıtlamak için raporlar oluşturabilirsiniz:

  • Android uygulamam geçen hafta günlük etkin kullanıcı sayısı kaçtı?
  • Sitemin 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 yalnızca birkaç satır kod uzağınızdadır. Başlamak için istemci kitaplıklarını kullanmaya hızlı başlangıç bölümüne bakın. Uygulamanızı daha basit hale getirmek 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 tek bir API çağrısı kullanarak birden fazla rapor oluşturulmasına olanak tanıyan 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 pivot, rapor yanıtındaki görünür boyut sütunlarını ve satırlarını açıklar.
  • batchRunPivotReports Bu, runPivotReport yönteminin tek bir API çağrısı kullanarak birden çok rapor oluşturulmasına olanak tanıyan toplu bir sürümüdür.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyut ve metriklere ait meta verileri 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.
  • checkUyumluluk Bu yöntem, bir rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutları ve metrikleri listeler.
  • runGerçektimeReport Bu yöntem, mülkünüz için özelleştirilmiş bir gerçek zamanlı etkinlik raporu döndürür. Etkinlikler, Google Analytics'e gönderildikten birkaç saniye 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) arasındaki zaman dilimlerine ait etkinlikleri ve kullanım verilerini gösterir.
  • 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 bir adımda ne kadar başarılı veya başarısız olduklarını hızlı bir şekilde görmenize olanak tanır.
  • properties.audienceLists (Erken önizleme) Bir kitledeki kullanıcıların anlık görüntüsünü içeren Kitle Listeleri oluşturmayı sağlayan bir yöntem grubudur.

Desteklenen boyutlar ve metrikler

API şeması dokümanlarında, şu anda Analytics Data API tarafından desteklenen boyutlar ve metrikler listelenmektedir.