Analytics Data API Nedir?
Analytics Data API, GA4 mülkündeki rapor verisini boyut, metrik ve tarih aralığı belirterek programla sorgulamaya yarayan Google arayüzüdür; gösterge panellerine, otomatik raporlara ve iş uygulamalarına veri taşır.
Diğer Adları: Google Analytics Data API
Analytics Data API Nasıl Çalışır?
İstek, yetkilendirilmiş kimlik bilgisiyle ve sorgulanacak GA4 mülkünün kimliğiyle gönderilir. Gövdede tarih aralığı, boyutlar (örneğin ülke) ve metrikler (örneğin aktif kullanıcı) belirtilir; yanıt sütun başlıkları ve veri satırlarıyla döner. Tek rapor için runReport, toplu istek için batchRunReports, pivot tablo için runPivotReport, son dakikaların verisi için runRealtimeReport yöntemleri kullanılır.
API, GA4 arayüzündeki rapor verisine erişir ve mülkün raporlama kimliği ayarına uyar. Bu sayede API’den alınan kullanıcı sayıları ve tekilleştirme, arayüzde seçilen kimlik ayarıyla aynı kuralla hesaplanır. Eski Universal Analytics mülkleriyle çalışmaz.
Analytics Data API Ne İşe Yarar?
Google’ın saydığı başlıca kullanım alanları özel gösterge paneli kurmak, tekrarlayan raporlamayı otomatikleştirmek ve analitik verisini diğer iş uygulamalarıyla birleştirmektir.
Örnek: Bir yönetim panelindeki trafik kartı, son yedi günün aktif kullanıcı ve oturum sayısını API’den alır. Kartın doğruluğu, aynı tarih aralığı ve aynı metrikle GA4 arayüzünde açılan raporla karşılaştırılarak sınanır; kartın üzerinde hangi metriğin gösterildiği yazılır.
Analytics Data API Kullanırken Dikkat Edilecekler
- Her istek bir Google Cloud projesi gerektirir ve mülk ile proje kotalarından düşer.
- Kota jetonla ölçülür; satır ve sütun sayısı, filtrelerin karmaşıklığı ve tarih aralığı arttıkça tüketim artar. Sık açılan panellerde sonuç bir süre önbellekte tutulur.
- Demografik veri içeren sorgularda veri eşiği uygulanabilir; bazı satırlar yanıtta yer almayabilir.
- Bağlantıya yalnızca ihtiyaç duyulan erişim izni verilir; okuma amaçlı bir panel için yazma yetkisi istenmez.
Analytics Data API Hakkında Sık Sorulan Sorular
Analytics Data API ile BigQuery dışa aktarımı arasındaki fark nedir?
Data API, raporlardaki toplulaştırılmış veriyi boyut ve metrik seçerek sorgular. BigQuery dışa aktarımı ise olay düzeyindeki ham veriyi işletmenin kendi veri ambarına taşır.
API’den gelen sayı arayüzdekinden neden farklı çıkabilir?
Tarih aralığı, mülkün saat dilimi, filtre, raporlama kimliği ya da veri eşiği farklı olabilir. Aynı ayarlarla yapılan sorgu, arayüzdeki raporla tutarlı veri verir.
Analytics Data API kullanmak için yazılım bilgisi gerekir mi?
API’yi doğrudan kullanmak için istek kuran bir uygulama ya da Google’ın istemci kitaplıkları gerekir. Hazır panel araçları aynı veriyi kendi bağlantıları üzerinden de alabilir.