Google Analytics Data API'ye genel bakış

Google Analytics (Google Analytics) raporlama 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ını (ör. Karışık, Gözlemlenen veya Cihaza dayalı) tam olarak dikkate alır.

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ı kaçtı?
  • Sitenizdeki en popüler 10 sayfanın son 28 gün içindeki 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ı raporlama 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 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 anlık 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ı raporlar, etkinlikleri ve kullanım verilerini şu andan 30 dakika öncesine kadar olan zaman aralıkları için gösterir (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öntemler grubu.
  • properties.recurringAudienceLists (Erken erişim) Yinelenen kitle dışa aktarma işlemlerini yönetmenize olanak tanıyan bir yöntem grubu. Tekrarlanan kitle dışa aktarma işlemiyle her gün yeni kitle listeleri oluşturulur.
  • 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ştirmenizi ve her adımın tamamlanma durumunu hızlıca görebilmenizi sağlar.
  • properties.chat (Erken erişim) Bu yöntem, Google Analytics'teki Ask Advisor'a programatik olarak sohbet erişimi sağlar. Etkinlik verilerinizle ilgili doğal dil soruları sorabilir, performans değişikliklerini teşhis edebilir ve yapılandırılmış anlatı ile tablo biçiminde ayrıntılı bilgiler alabilirsiniz.

Desteklenen boyutlar ve metrikler

Data API tarafından desteklenen tüm boyut ve metriklerin listesi için API şema belgelerine bakın.