Google Analytics Data API'ye Genel Bakış

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

Google Analytics 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 haftaki günlük etkin kullanıcı sayısı.
  • Sitenizdeki en popüler 10 sayfanın son 28 günde kaç sayfa görüntülemesi aldığı.
  • 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şturun.
  • 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, tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanıyan runPivotReport yönteminin toplu işlem sürümüdü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 gerçek zamanlı etkinlik verileri raporu döndürür. Etkinlikler, Google Analytics'e gönderildikten saniyeler sonra anlık raporlarda görünür. Gerçek zamanlı raporlarda, etkinlikler ve kullanım verileri şu andan 30 dakika öncesine kadar olan zaman aralıkları için gösterilir (Google Analytics 360 mülkleri için 60 dakikaya kadar).
  • 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. Tekrarlanan 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 tamamlarken izlediği adımları görselleştirmenize ve her adımın tamamlanma durumunu hızlıca 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.