Genel bakış

Bu belgede Google Analytics Gerçek Zamanlı Raporlama API'si açıklanmaktadır. API'nin ayrıntılı referansı için API Referansı'nı okuyun.

Giriş

Real Time Reporting API, kimliği doğrulanmış bir kullanıcı için gerçek zamanlı verileri (ör. mülkünüzdeki gerçek zamanlı etkinlik) isteyebilmenizi sağlar.

Gerçek Zamanlı Raporlama API'sını aşağıdakileri yapmak için kullanabilirsiniz:

  • Bir sayfanın aktif izleyicilerini gösterin ve sınırlı envanteri olan bir öğeye göz atan kullanıcılarda aciliyet hissi uyandırın.
  • En popüler içeriği (ör. en popüler 10 etkin sayfa) görüntüleyin.
  • Gerçek zamanlı bir kontrol paneli oluşturun ve görüntüleyin.

Google Analytics süper proxy'si

Kimlik doğrulama, önbelleğe alma ve API yanıtlarını doğrudan görselleştirme ve grafik kitaplıklarıyla kullanılan biçimlere dönüştürme konularında Google Analytics API'leriyle çalışmaya ilişkin uygulama ayrıntılarının çoğunu yönetmek için Google Analytics superProxy'yi kullanın.

Kavrama Genel Bakış

Gerçek Zamanlı Raporlama API'sının altında yatan temel kavramlar şunlardır:

  • Raporların kullanıcılar ve görünümlerle (profiller) ilişkisi.
  • Raporun yapısı ve sorguların nasıl oluşturulacağı.
  • API yanıtıyla çalışma.

Raporlar, Kullanıcılar ve Görünümler (Profiller)

Kullanıcıların bir görünümden (profilden) rapor verilerini istemek üzere uygulamanızı kullanabilmesi için:

  1. Google Analytics API'yi etkinleştirin.
  2. Uygulamanızın API'ye erişebilmesi için kimlik bilgileri oluşturun.
  3. Kimlik bilgilerini uygulamanıza ekleyin.

Kullanıcıların kendi rapor verilerini istemek için uygulamanızı kullanırken kendi adlarına verilere erişmesi için uygulamanızı yetkilendirmeleri gerekir.

Bir görünüm (profil) bir Görünüm (Profil) kimliğiyle tanımlanır. Görünümler (profiller) diğer varlıkların yanı sıra Google Analytics'in hesap, kullanıcı, mülk ve görünüm hiyerarşisinin bir parçasıdır. Uygulamanız, bu hiyerarşiyi geçip bir görünüm (profil) elde etmek için Management API'sini kullanabilir.

Boyutlar ve Metrikler için Sorgulama

Boyut ve metriklerden oluşan Google Analytics rapor verileri için API'yi sorgularsınız. Metrikler, o anda mülkteki etkin kullanıcıların sayısı gibi kullanıcı etkinliğinin ayrı ayrı ölçümleridir. Boyutlar, metrikleri trafik kaynakları, coğrafi konum, sayfa bilgileri gibi bazı yaygın ölçütlere göre ayırır.

API'de [gösterilen] tüm boyut ve metrikleri keşfetmek için Boyutlar ve Metrikler Referans Kılavuzu'nu kullanın. Ayrıca, API sorgusunda boyutları ve metrikleri nasıl belirteceğinizi öğrenmek için Gerçek Zamanlı Raporlama API'sı Başvuru Kılavuzu'nu okuyun.

Raporlarla Çalışma

API'den döndürülen veriler, başlığa ve bir dizi satıra sahip bir tablo olarak düşünülebilir. Her API yanıtı, her sütunun adını ve veri türünü açıklayan bir başlıktan oluşur. Yanıtta bir satır listesi de bulunur. Bu satırlarda her satır, başlıklarla aynı sırada veri içeren hücrelerin listesidir. API yanıtı hakkında daha fazla bilgi için Gerçek Zamanlı Reporting API Referans Kılavuzu'nu okuyun.

Kota Politikası

Gerçek Zamanlı Raporlama API'si milyonlarca veri sorgusu işlemini yönetir. Sistemin kaldırabileceğinden daha fazla işlem almasını engellemek ve sistem kaynaklarının adil bir şekilde dağıtılmasını sağlamak için bir kota sistemi kullanırız. Daha fazla bilgi için Sınırlar ve Kota rehberini okuyun.

Sonraki adımlar

Artık API'nin nasıl çalıştığını anladığınıza göre başlamak için: