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ş
Gerçek Zamanlı Reporting API, kimliği doğrulanmış bir kullanıcı için gerçek zamanlı veriler (ör. mülkünüzdeki gerçek zamanlı etkinlik) isteyebilmenize olanak tanır.
Gerçek Zamanlı Reporting API'yi kullanarak şunları yapabilirsiniz:
- Bir sayfanın aktif izleyicilerini gösterin ve sınırlı envantere sahip bir öğeyi inceleyen kullanıcılarda aciliyet hissi uyandırın.
- En popüler içerikler (ör. en popüler 10 etkin sayfa) gösterilir.
- Gerçek zamanlı bir kontrol paneli oluşturun ve görüntüleyin.
Google Analytics superProxy
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 birçoğunu kullanmak için Google Analytics superProxy'yi kullanın.
Kavrama Genel Bakış
Gerçek Zamanlı Reporting API'nin altında yatan temel kavramlar şunlardır:
- Raporların kullanıcılar ve görüntülemelerle (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 aşağıdakileri yapmanız gerekir:
- Google Analytics API'yi etkinleştirin.
- Uygulamanızın API'ye erişmesi için kimlik bilgileri oluşturun.
- Kimlik bilgilerini uygulamanıza ekleyin.
Kendi rapor verilerini istemek için uygulamanızı kullanan kullanıcıların, uygulamanızı kendi adlarına verilere erişmesi için yetkilendirmesi 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 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, kullanıcı etkinliğinin ayrı ayrı ölçümleridir (ör. o anda mülkteki etkin kullanıcı sayısı). Boyutlar, metrikleri trafik kaynakları, coğrafi konum, sayfa bilgileri gibi bazı yaygın ölçütlere göre ayırır.
API'de kullanılabilecek tüm boyut ve metrikleri keşfetmek için Boyutlar ve Metrikler Referans Kılavuzu'nu kullanın. Ayrıca bir API sorgusunda boyutları ve metrikleri nasıl belirteceğinizi öğrenmek için Gerçek Zamanlı Reporting API Referans Kılavuzu'nu okuyun.
Raporlarla Çalışma
API'den döndürülen veriler, başlığı ve satır listesi olan bir tablo gibi 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 aynı zamanda bir satır listesi de bulunur. Bu listede her satır, başlıklarla aynı sırada veri içeren bir hücre 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ı Reporting API milyonlarca veri sorgusu işlemini yürütür. Sistemin yapabileceğ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 kılavuzunu okuyun.
Sonraki adımlar
Artık API'nin nasıl çalıştığını anladığınıza göre, başlamak için:
- API ile nasıl çalışacağınızı öğrenmek için Geliştirici Kılavuzu'nu okuyun.
- API aracılığıyla kullanılabilen tüm verilerin listesi için Boyutlar ve Metrikler Referans Kılavuzu'na göz atın.
- API ile kullanabileceğiniz tüm istemci kitaplıklarının listesi için Kitaplıklar ve Örnekler sayfasına göz atın.