Google Analytics Data API'ye Genel Bakış

Google Analytics (Google Analytics) rapor verilerine programatik olarak erişmek için Data API'yi kullanabilirsiniz.

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

API tarafından döndürülen veriler, Google Analytics kullanıcı arayüzünde gösterilen verilerle tutarlıdır ve Google Analytics mülkünüz için yapılandırılan raporlama kimliği ayarları (ör. Karışık, Gözlemlenen veya Cihaza dayalı) ile tam uyumludur.

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

  • Android uygulamanızın geçen haftaki günlük etkin kullanıcı sayısı.
  • Sitenizdeki en popüler 10 sayfanın son 28 gündeki sayfa görüntüleme sayısı.
  • iOS uygulamanızda son 30 dakika içinde ülke başına kaç etkin kullanıcı vardı?

Ayrıca Google Analytics Data API v1'i kullanarak şunları da yapabilirsiniz:

  • Google Analytics verilerini görüntülemek için özel kontrol panelleri oluşturabilirsiniz.
  • Raporlama ile ilgili karmaşık görevleri otomatikleştirerek zamandan tasarruf edebilirsiniz.
  • Google Analytics verilerinizi diğer iş uygulamalarıyla entegre edin.

Veri tutarlılığı ve raporlama kimliği

Google Analytics Data API v1, Google Analytics arayüzüyle aynı rapor verilerine erişir. API tarafından döndürülen veriler, Google Analytics mülkünüz için yapılandırılan Raporlama Kimliği ayarlarını tam olarak dikkate alır. Böylece kullanıcı sayıları, tekilleştirme ve veri modelleme, mülk ayarlarınızda seçilen kimlik alanıyla (ör. Karışık, Gözlemlenen veya Cihaza Dayalı) uyumlu olur.

Farklı kimlik alanlarının raporlarınızı nasıl etkileyebileceği hakkında daha fazla bilgi edinmek için Raporlama kimliği başlıklı makaleyi inceleyin.

Başlayın

Başlamak için istemci kitaplığı hızlı başlangıç kılavuzuna bakın. Uygulamanızı basitleştirmek için Java, Python, Node.js ve diğer dillerde istemci kitaplıkları mevcuttur.

Kullanılabilir yöntemler

Data API yöntemlerinin listesini burada bulabilirsiniz. Daha fazla bilgi için referans belgelerine 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, runReport yönteminin toplu sürümüdür ve tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanır.
  • runPivotReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Özet raporlar, normal raporlara kıyasla daha gelişmiş ve ifade edici 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 toplu işlem sürümüdür ve tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanır.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyutlar ve metriklerle ilgili meta verileri döndürür. Boyutları ve metrikleri keşfetmek için kullanılır. Bu yöntemin yanıtı, belirtilen Google Analytics 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 boyutlar ve metrikler listelenir.
  • runRealtimeReport Bu yöntem, mülkünüz için özelleştirilmiş bir anlık etkinlik verileri raporu döndürür. Etkinlikler, Google Analytics'e gönderildikten saniyeler sonra anlık raporlarda görünür. Anlık raporlar, şu andan 30 dakika öncesine kadar olan zaman aralıklarındaki (Google Analytics 360 mülkleri için 60 dakikaya kadar) etkinlikleri 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 aktarma işlemleri 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 yöntem grubu. Yinelenen kitle dışa aktarma işlemi her gün yeni kitle listeleri oluşturur.
  • runFunnelReport (Erken erişim) 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 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

Data API'nin desteklediği tüm boyut ve metriklerin listesi için API şema belgelerine bakın.