Google Analytics Gerçek Zamanlı Raporlama API'sı Değişiklik Günlüğü

Yeni özellikler sunmak ve önceki sürümlerde bulunan hataları onarmak için Google Analytics Gerçek Zamanlı Raporlama API'sini düzenli aralıklarla güncelliyoruz. Çoğu durumda, bu değişiklikler API geliştiricileri için şeffaf olacaktır. Ancak bazen geliştiricilerin mevcut uygulamalarını değiştirmesini gerektiren değişiklikler yapmamız gerekiyor.

Bu sayfada, Google Analytics Gerçek Zamanlı Raporlama API'sında yapılan ve uygulamanızı etkileyebilecek değişiklikler açıklanmaktadır. API geliştiricilerinin yeni duyurular için bu listeyi düzenli olarak kontrol etmelerini öneririz. Değişikliklere aşağıdaki Abone ol bölümünde listelenen feed'ler aracılığıyla da abone olabilirsiniz.

İlgili Değişiklik Günlüklerine Abone Ol

Tüm Google Analytics API Değişiklik Günlükleri
–
Abone ol rss

Tüm Toplama, Yapılandırma ve Raporlama API'lerini içerir.

Tüm Reporting API Değişiklik Günlükleri
–
Abone ol rss

Temel Raporlama API'sı, Çok Kanallı Dönüşüm Hunileri Raporlama API'sı ve Gerçek Zamanlı Raporlama API'sını içerir.

Real Time Reporting API Değişiklik Günlüğü
–
Abone ol rss

Bu sürümde, Analytics Real Time API kotaları ve sınırları ile ilgili değişiklikler bulunmaktadır.

Diğer Analytics API çağrılarıyla eşit ölçüde,günlük görünüm (profil) başına 10.000 çağrıya katkıda bulunmak için kullanılan Analytics Gerçek Zamanlı Raporlama API'si çağrıları. Artık Analytics Gerçek Zamanlı Raporlama API'si çağrıları ayrı olarak hesaplanmaktadır. Bu da, Analytics Gerçek Zamanlı Raporlama API'si kullanılarak görünüm (profil) başına günde 10.000 çağrı yapmak VE diğer Analytics API'lerini kullanarak görünüm (profil) başına günde 10.000 çağrı daha yapılabileceği anlamına gelir. Daha fazla bilgi için Sınırlar ve Kotalar sayfasına bakın.

Bu değişiklik, kotaların yönetilmesinde daha ayrıntılı ve sorunsuz bir yaklaşım sağlar. Böylece, Analytics Gerçek Zamanlı Raporlama API'sını kullanan sık yapılan çağrılar, tek bir profil için günün geri kalanında yanlışlıkla diğer tüm Analytics API çağrılarını engellemeyecektir.

Bu, bir hata düzeltme sürümüdür:

  • Bu sürüm, Real Time Reporting API sorgusundaki filtreleme kısıtlamalarının uygulanmasıyla ilgili bir sorunu düzeltmektedir. rt:activeUsers içeren ve etkinlik düzeyinde boyutta filtre içeren istekler, badRequest nedeni olan bir hatayla ve OR operator not supported for a hit level filter şeklinde bir mesajla sonuçlanır. Sorgu kısıtlamaları hakkında daha fazla bilgi için Gerçek Zamanlı Reporting API Geliştirici Kılavuzu'nu ziyaret edin.

Bu sürümde yeni bir boyut var. Tanımların tam listesi için Boyutlar ve Metrikler Referansı'nı inceleyin.

Saat

  • Boyut - rt:minutesAgo - Bir isabetin kaç dakika önce gerçekleştiği.

Bu sürüm, boyut ve metriklerin yeniden adlandırılmasını içerir. Tanımların tam listesi için Boyutlar ve Metrikler Referansı'nı inceleyin.

Yeniden Adlandırılan Boyutlar ve Metrikler

Aşağıdaki boyutlar ve metrikler yeniden adlandırıldı. Verileri yeniden adlandırmayla ilgili ayrıntılar için Veri Kullanımdan Kaldırma Politikası'nı inceleyin:

Kullanıcı

  • Boyut - rt:visitorType - Bunun yerine rt:userType kullanın.
  • Metrik - rt:activeVisitors - Bunun yerine rt:activeUsers kullanın.

ga: Öneki Kullanımdan Kaldırıldı

ga: ön eki tüm Gerçek Zamanlı Boyutlar ve Metrikler için kullanımdan kaldırıldı ve yerini yeni rt: öneki aldı. ga: önekini kullanan API istekleri 6 ay boyunca çalışmaya devam eder ve sonrasında hata döndürülür.

Yeni Boyutlar ve Metrikler

Bu güncelleme, Gerçek Zamanlı Raporlama API'sine yeni boyutlar ve metrikler ekler. Listenin tamamı için Boyutlar ve Metrikler Referansı'na göz atın.

Etkinlik İzleme

  • Boyut - rt:eventAction - etkinliğin işlemi.
  • Boyut - rt:eventCategory - etkinliğin kategorisi.
  • Boyut - rt:eventLabel - etkinliğin etiketi.
  • Boyut - rt:totalEvents - tüm kategorilerde profil etkinliklerinin toplam sayısı.

Hedef İzleme

  • Boyut - rt:goalId - hedef kimliğine karşılık gelen bir dize.
  • Metrik - rt:goalXXValue - İstenen hedef sayısı için toplam sayısal değer; burada XX 1 ile 20 arasında bir sayıdır.
  • Metrik - rt:goalValueAll - profiliniz için tanımlanan tüm hedeflerin toplam sayısal değeri.
  • Metrik - rt:goalXXCompletions - İstenen hedef sayısı için toplam tamamlama sayısı. Burada XX, 1 ile 20 arasında bir sayıdır.
  • Metrik - rt:goalCompletionsAll - profilinizde tanımlanan tüm hedeflerin toplam tamamlanma sayısı.

Sayfa İzleme

  • Metrik - rt:pageViews - toplam sayfa görüntüleme sayısı.

Uygulama İzleme

  • Metrik - rt:screenViews - toplam ekran görüntüleme sayısı.

Bu, Gerçek Zamanlı Raporlama API'sinin sınırlı beta sürümündeki ilk sürümüdür:

  • Gerçek Zamanlı Raporlama API'si, şu anda mülkünüzde gerçekleşen etkinlikler hakkında rapor oluşturmanıza olanak tanır. Müşterilere yönelik web widget'ları ve gösterge tabloları oluşturmak üzere boyutları ve metrikleri sorgulamak için Gerçek Zamanlı raporlama API'sini kullanabilirsiniz. Daha fazla ayrıntı için Real Time Reporting API'ye Genel Bakış sayfasını ziyaret edin.