Bu belge, Google Analytics Temel Raporlama API'sı Sürüm 3.0'a üst düzey bir genel bakış sunar. API'nin ayrıntılı referansı için Referans Kılavuzu'na göz atın.
Giriş
Google Analytics Temel Raporlama API'si, 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 sürüm 2.3'ü mü kullanıyorsunuz? - Uygulamanızı yeni sürümü kullanacak şekilde nasıl güncelleyeceğiniz hakkında ayrıntılı bilgi için Taşıma Rehberi'ni okuyun.
Başlarken
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ı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ış
Temel Raporlama API'si, Google Analytics izleme kodu tarafından toplanan verilerden türetilen istatistiklerden oluşan rapor verileri döndürür. Her rapor, boyutlar ve metrikler şeklinde 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'sının altında yatan 3 temel kavram vardı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)
Bir kullanıcının rapor verilerini istemek için uygulamanızın kullanıcıyı tanımlaması ve verilerin alınacağı bir görünüm (profil) belirtmesi gerekir. Kullanıcı, yetkilendirme kimlik bilgileri alınıp her API isteğinde iletilerek 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şisinde geçiş yapmak 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 sütununda, görünüm kimliğini almak için 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) bağımsız ölçümleridir. Boyutlar, metrikleri ülke veya tarayıcı gibi bazı yaygın ölçütlere göre ayırır. Bir sorgu oluşturduğunuzda rapor verilerinizde bulunması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 Raporlama API'si Başvuru Kılavuzu'nu da 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 verilere sahip hücrelerin bir 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 Raporlama API'si Başvuru 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 kullanmak gerekir. Belirli sınırlar için Sınırlar ve Kotalar kılavuzunu okuyun.
Temel Reporting API sütunlarında (yani boyutlar ve metrikler) yapılan değişikliklerin nasıl işlendiği hakkında ayrıntılı bilgi için Verilerin Kullanımdan Kaldırılması Politikası'nı okuyun. Metadata API'nin kullanımdan kaldırılan sütunları kontrol etmek amacıyla 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 pek çok kaynağımız var:
- API ile nasıl çalışacağınızı öğrenmek için Geliştirici Kılavuzu'nu okuyun.
- Görsel olarak sorgu oluşturmak ve yanıtı 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 sorguların 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 bakın.