Bu belgede, Google Analytics Core Reporting API Sürüm 3.0'a üst düzey bir genel bakış sunulmaktadır. API'ye ilişkin ayrıntılı referans için Referans Kılavuzu'na göz atın.
Giriş
Google Analytics Core Reporting API, Google Analytics'teki rapor verilerinin çoğuna erişmenizi sağlar. Core Reporting API 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 3.0 sürümünü kullanmanızı öneririz.
- Eski 2.3 sürümünü mü kullanıyorsunuz? – Uygulamanızı yeni sürümü kullanacak şekilde güncelleme hakkında ayrıntılı bilgi için Taşıma Rehberi'ni okuyun.
Başlayın
Hemen başlamak ister misiniz? Hello Analytics API Eğiticisi'ni okuyun.
API'yi kullanan her uygulamanın kaydedilmesi, kullanıcıyı yetkilendirmesi ve API ile çalışması için birkaç adımdan geçmesi gerekir. Bu eğitim her adımda size yol gösterir ve sonunda özelleştirebileceğiniz, çalışan bir uygulamanız olur.
Kavrama Genel Bakış
Core Reporting API, Google Analytics izleme kodu tarafından toplanan verilerden türetilen rapor verilerini döndürür. Her rapor, boyutlar ve metrikler olarak düzenlenmiştir. Özelleştirilmiş raporlar oluşturmak için 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ü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)
Bir kullanıcının rapor verilerini istemek için uygulamanızın kullanıcıyı tanımlaması ve verilerini almak için bir görünüm (profil) belirtmesi gerekir. Kullanıcı, yetkilendirme kimlik bilgileri alıp her 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 bir 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 almak amacıyla Yönetim yapılandırma hiyerarşisine geçmek için Management API'sini kullanabilir.
- Google Analytics'teki her raporun URL'sinde.
ekranın görüntüsü
- Google Analytics'te, menü çubuğundan 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
Boyut ve metriklerden oluşan Google Analytics rapor verileri için API'yi sorgularsınız. Metrikler, mülkünüzdeki kullanıcı etkinliklerinin (ör. oturumlar ve sayfa görüntülemeler) ayrı ayrı ölçümleridir. Boyutlar, metrikleri ülke veya tarayıcı gibi bazı yaygın ölçütlere göre ayırır. Bir sorgu oluştururken rapor verilerinizde yer almasını istediğiniz boyutları ve metrikleri belirtirsiniz.
API aracılığıyla sunulan tüm boyut ve metrikleri keşfetmek için etkileşimli Boyutlar ve Metrikler Başvuru Kılavuzu'nu kullanın. API sorgusunda boyutları ve metrikleri nasıl belirteceğinizi öğrenmek için Temel Reporting API Referans Kılavuzu'nu da 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 bir satır listesi de bulunur. Bu listede her satır, başlıklarla aynı sırada verilere sahip bir hücre listesidir. Her bir 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 Reporting API Referans Kılavuzu'nu okuyun.
Kota ve Kullanımdan Kaldırma Politikaları
Google Analytics API milyonlarca işlem gerçekleştirebilir. 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 benimsemek gerekir. Belirli sınırlar için Sınırlar ve Kotalar kılavuzunu okuyun.
Temel Reporting API sütunlarındaki değişikliklerin (yani boyutlar ve metrikler) nasıl işlendiği hakkında ayrıntılı bilgi için Verilerin Kullanımdan Kaldırılması Politikası'nı okuyun. Kullanımdan kaldırılan sütunları kontrol etmek üzere Metadata API'nin nasıl kullanılabileceğini öğrenmek için Metadata API Geliştirici Kılavuzu'na bakın.
Sonraki adımlar
Artık API'nin işleyiş şeklini anladığınıza göre, başlamanıza yardımcı olacak bazı kaynaklarımız var:
- API ile nasıl çalışacağınızı öğrenmek için Geliştirici Kılavuzu'nu okuyun.
- Sorguları görsel olarak oluşturmak ve yanıtları API aracılığıyla görmek için etkileşimli Sorgu Araştırma Aracı'nı kullanın.
- Core Reporting API'ye yapılan en yaygın sorgulardan birkaçı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ına göz atın.