Bu belge, Google Analytics Temel Raporlama API'si Sürüm 3.0'a genel bakış sunmaktadır. API ile ilgili ayrıntılı bir referans için Referans Kılavuzu'na bakın.
Giriş
Google Analytics Temel Raporlama API'si, Google Analytics'teki rapor verilerinin çoğuna erişmenizi sağlar. Temel Raporlama API'si ile şunları yapabilirsiniz:
- Google Analytics verilerini görüntülemek için özel gösterge tabloları oluşturun.
- Karmaşık raporlama görevlerini otomatik hale getirerek zamandan tasarruf edin.
- Google Analytics verilerinizi diğer iş uygulamalarıyla entegre edin.
Sürüm Seçme
Kısa süre önce Core Reporting API'nin yeni bir sürümünü kullanıma sunduk.
- Yeni bir uygulama mı oluşturuyorsunuz? - En son sürümü kullanmanızı öneririz.
- Eski sürüm 2.3'ü mü kullanıyorsunuz? - Uygulamanızı yeni sürümü kullanacak şekilde nasıl güncelleyeceğinizle ilgili ayrıntılar için Taşıma Kılavuzu'nu okuyun.
Başlayın
Hemen başlamak ister misiniz? Hello Analytics API Eğiticisi'ni okuyun.
API'yi kullanan her uygulamanın kaydolmak, kullanıcıyı yetkilendirmek ve API ile çalışmak için birkaç adımı uygulaması gerekir. Bu eğitim her adımda size yol gösterecek ve sonunda özelleştirebileceğiniz çalışan bir uygulamaya sahip olacaksınız.
Kavrama Genel Bakış
Core Reporting API, Google Analytics izleme kodundan toplanan verilerden oluşan rapor verilerini döndürür. Her rapor boyut ve metrik olarak düzenlenir. Özelleştirilmiş raporlar oluşturmak amacıyla boyutları ve metrikleri sorgulamak için Core Reporting API'yi kullanırsınız.
Temel Raporlama API'sinin altında yatan 3 temel kavram vardır:
- Raporların kullanıcılar ve görünümler (profiller) ile 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üntülemeler (Profiller)
Kullanıcının rapor verileri isteyebilmesi için uygulamanızın kullanıcıyı tanımlaması ve verileri almak üzere bir görünüm (profil) belirtmesi gerekir. Kullanıcı, yetkilendirme kimlik bilgilerini öğrenip her bir API isteğinde ileterek tanımlanır. Görünüm (profil), Google Analytics yapılandırma hiyerarşisinin bir parçasıdır ve görünüm (profil) kimliğiyle tanımlanır.
Görünüm (profil) kimliğinizi bulmanın birkaç yolu vardır.
- Uygulamanız, görünüm (profil) kimliği edinmek için Yönetim yapılandırma hiyerarşisinden geçiş yapmak üzere Management API'sini kullanabilir.
- Google Analytics'teki her raporun URL'sinde.
ekranın görüntüsü
- Google Analytics'te menü çubuğundaki
Yönetici'yi tıklayın. Görünümün ait olduğu hesabı ve mülkü seçin. Görünüm kimliğini almak için GÖRÜNÜM sütununda Görünüm Ayarları'nı tıklayın.
ekranın görüntüsü
Boyutlar ve Metrikler için Sorgulama
Boyutlardan ve metriklerden oluşan Google Analytics için API rapor verilerini sorguluyorsunuz. Metrikler, mülkünüzdeki kullanıcı etkinliğinin (ör. oturum sayısı ve sayfa görüntüleme sayısı) ayrı ayrı ölçümüdür. Boyutlar, metrikleri ülke veya tarayıcı gibi bazı yaygın ölçütlere göre ayırır. Bir sorgu oluştururken rapor verilerinizde istediğiniz boyutları ve metrikleri belirtirsiniz.
API ile gösterilen tüm boyut ve metrikleri keşfetmek için etkileşimli Boyutlar ve Metrikler Referans Kılavuzu'nu kullanın. Ayrıca, API sorgusunda boyutları ve metrikleri belirtme hakkında bilgi edinmek için Temel Raporlama API'si Referans Kılavuzu'nu okuyun.
Raporlarla Çalışma
API ile döndürülen veriler, başlığı ve satır listesi olan 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ıt, satırların listesini de içerir. Burada, her satır, verileri başlıklarla aynı sırayla içeren bir hücre listesidir. Her hücredeki veri türünü belirlemek için başlıktaki bilgileri kullanırsınız.
API yanıtı hakkında daha fazla bilgi için Temel Raporlama API'si Referans Kılavuzu'nu okuyun.
Kota ve Kullanımdan Kaldırma Politikaları
Google Analytics API, milyonlarca işlemi gerçekleştirir. Sayfanın kaldırabileceğinden daha fazla işlem almasını önlemek ve sistem kaynaklarının eşit şekilde dağıtılmasını sağlamak için bir kota sistemi kullanılmalıdır. Belirli sınırlar için Sınırlar ve Kotalar kılavuzunu okuyun.
Core Reporting API sütunlarında (ör. boyutlar ve metrikler) yapılan değişikliklerin nasıl işlendiği hakkında ayrıntılı bilgi için Veri Kullanımdan Kaldırma Politikası'nı okuyun. Kullanımdan kaldırılan sütunları kontrol etmek üzere Meta Veri API'sının nasıl kullanılabileceğini öğrenmek için Meta Veri API'sı Geliştirici Kılavuzu'na göz atın.
Sonraki Adımlar
API'nin işleyiş şeklini anladığınıza göre, başlamanıza yardımcı olacak bir dizi kaynağımız var:
- API ile nasıl çalışacağınızı öğrenmek için Geliştirici Kılavuzu'nu okuyun.
- Etkileşimli Sorgu Gezgini aracını kullanarak sorguları görsel olarak oluşturun ve yanıtları API aracılığıyla görün.
- Core Reporting API'ye yapılan en yaygın sorgulardan bazılarını listeleyen Yaygın Sorgular makalesini okuyun.
- API aracılığıyla kullanılabilen tüm verilerin listesi için Boyutlar ve Metrikler referansını kontrol edin.
- Bu API ile kullanılabilecek tüm istemci kitaplıklarının listesi için Kitaplıklar ve Örnekler sayfasını kontrol edin.