Geliştirici Kılavuzu

Bu dokümanda, Google Analytics verilerini almak için Gerçek Zamanlı Raporlama API'sinin nasıl kullanılacağı açıklanmaktadır.

Giriş

Real Time Reporting API, mülkünüzde gerçekleşen etkinlikleri raporlamanızı sağlar. Gerçek zamanlı verilere erişmek için bir görünümü (profil) ve en az bir metriği belirten bir sorgu oluşturursunuz. Sorgunuzu hassaslaştırmak için boyutlar ve filtreler gibi ek sorgu parametreleri de sağlayabilirsiniz. Bu sorgu, verileri tablo biçiminde döndüren Real Time Reporting API'ye gönderilir.

API'yi kullanmaya yeni başladıysanız Gerçek Zamanlı Raporlama API'si ve sağladığı verilerle ilgili giriş bilgileri için Gerçek Zamanlı Raporlama API'sine Genel Bakış'ı okuyun.

Ön koşul

Google Analytics verilerini almak için Gerçek Zamanlı Raporlama API'sini kullanmadan önce:

  • API ile çalışan programlama diline özel istemci kitaplıklarının tam listesi için istemci kitaplıkları sayfasını okuyun.
  • Google Analytics verilerini almak için API'yi tek başına (istemci kitaplığı kullanmadan) nasıl kullanacağınızı öğrenmek için Referans Kılavuzu'nu okuyun.

Her istemci kitaplığı, tüm Gerçek Zamanlı Raporlama API'si verilerine erişmek için tek bir analiz hizmet nesnesi sağlar. Hizmet nesnesi oluşturmak için:

  1. Uygulamanızı Google API Konsolu'na kaydedin.
  2. Google Analytics verilerine erişim yetkisi verin.
  3. Analytics hizmet nesnesi oluşturun.

Bu adımları tamamlamadıysanız lütfen bir Google Analytics API uygulaması oluşturmanın ilk adımlarında size yol gösterecek Merhaba Google Analytics API Eğiticisi'ni durdurun ve okuyun. Ardından Google Analytics verilerini almak için API'yi nasıl kullanacağınızı biliyorsunuz.

Gerçek Zamanlı Raporlama API'sini Kullanma

Bir uygulamanın Gerçek Zamanlı Raporlama API'sini kullanmak için:

  1. Gerçek Zamanlı Raporlama API'sini sorgular.
  2. API yanıtını işler.

Gerçek Zamanlı Raporlama API'sini Sorgulama

Analytics hizmet nesnesi, Gerçek Zamanlı Raporlama API sorgusu oluşturmak için bir yöntem sağlar. Sorgu parametreleri ve API'nin kullanabileceği veriler hakkında ayrıntılı bilgi için aşağıdakileri okuyun:

Bir sorgu tanımladıktan sonra, sorguyu Google Analytics sunucularına göndermek için execute yöntemini kullanın.

API yanıtını işleme

Gerçek Zamanlı Raporlama API'sine gönderilen sorgu başarılı olursa API, istenen verileri gerçek zamanlı veri kaynağının bir parçası olarak döndürür. API yanıt yapısı ve biçimi hakkında ayrıntılı bilgi için Gerçek Zamanlı Raporlama API'si referansına bakın.

Herhangi bir hata oluşursa API belirli bir durum kodu ve hatayı açıklayan bir mesaj döndürür. Tüm uygulamalar hataları yakalamalı ve işlemelidir. Hataların ayrıntılı listesi için Hata Yanıtları'nı inceleyin ve önerileri yeniden deneyin.

Kod Örnekleri

Gerçek Zamanlı Veriler: get sayfasındaki Örnekler bölümü, Gerçek Zamanlı Raporlama API'sini sorgulamak ve API yanıtını yönetmek için çeşitli programlama dillerinde örnek kod sağlar.

Sorgu Kısıtlamaları

Gerçek Zamanlı API sorgularıyla ilgili kısıtlamalar şunlardır:

  • rt:activeUsers metriği aşağıdaki boyut filtrelerine sahip bir sorguya eklenirse yalnızca AND operatörü ve eşitlik eşleştirme türü (==) desteklenir.
    • rt:goalId
    • rt:eventAction
    • rt:eventCategory
    • rt:eventLabel

    rt:activeUsers metriği şu anda yalnızca sitede etkin olan kullanıcıların sayısını aldığından, rt:activeUsers ile rt:minutesAgo bağlantısını kullanmayın. Yani rt:activeUsers, rt:minutesAgo değerinin 0 olduğu anlamına gelir.

  • Metrik filtreleri desteklenmez.
  • fields parametresi desteklenmiyor.

Kota Yönetimi

Sınırlar ve Kota'da açıklandığı gibi, Gerçek Zamanlı Raporlama API'si için diğer Google Analytics API'leriyle paylaşılan günlük kotalar vardır. Gerçek Zamanlı Raporlama API'sini kısa aralıklarla sorguluyorsanız günlük kota sınırlarına çok hızlı bir şekilde ulaşırsınız. Böyle bir durumda, kota yenilenene kadar diğer Google Analytics API'lerinden gelen istekler de çalışmayı durdurur.

Kotayı çok hızlı kullanan bazı uygulamalara örnek olarak şunlar verilebilir:

  • Her gün çok kısa aralıklarla, tek bir Google Analytics görünümü (profili) için veri sorgulayan birden fazla gerçek zamanlı kontrol paneliniz vardır.
  • Çok sayıda kullanıcıya sahip bir mülkünüz var ve gerçek zamanlı bir widget uyguladınız. Widget bir kullanıcıya her görüntülendiğinde, bir önbellek kullanmak yerine doğrudan Google Analytics'i sorgularsınız.

Kota kullanımını en aza indirmek ve verimli bir şekilde yönetmek için:

  • Sunucu tarafı önbelleğe alma uygulayın. Birden fazla kullanıcı aynı gerçek zamanlı veriler için istekte bulunduğunda, her kullanıcının isteği için Gerçek Zamanlı Raporlama API'sini doğrudan sorgulamak yerine önbelleğe alınan bir yanıt döndürmeniz gerekir. Ardından, günlük kota sınırlarını aşmamak için önbelleği en son gerçek zamanlı verilerle makul bir yenileme aralığında periyodik olarak yenileyin.
  • Ek boyutlar belirterek birden fazla sorguyu birleştirin ve yanıtı, sunucu veya istemci tarafında ayrıştırın.
  • Gerçek zamanlı veri isteğinde bulunduğunuz zaman aralığını artırın.

Örnek: Yenileme Aralığını Hesaplama

Gerçek zamanlı veriler için düzenli olarak istekte bulunmayı bekliyorsanız beklenen kullanımınıza göre makul bir yenileme aralığı seçmeniz gerekir.

Örneğin, tek bir Google Analytics görünümünde (profil) günlük kota sınırı 10.000 istektir. Bir gün içinde tek bir görünüm (profil) için Core Reporting API'ye 6.000 sorgu gerçekleştirmeyi bekliyorsanız ilgili görünüm (profil) için kalan 4.000 istek kotanız olur.

Aynı görünüm (profil) üzerinden gerçek zamanlı verileri sorgulamaya yönelik tüm gün süren 3 gerçek zamanlı kontrol paneli uygulamak için Gerçek Zamanlı Raporlama API'sini kullanmaya karar verdiğinizi varsayalım. Her kontrol paneli günde yaklaşık 1.333 sorgu oluşturabilir (4.000 sorgu / 3 kontrol paneli). Bir günde 86.400 saniye var. Bu nedenle, her bir gösterge tablosunun yenileme aralığı 65 saniyeden (86.400 / 1.333) büyük olmalıdır. Böylece, görünüm (profil) için yapılan günlük isteklerin toplam sayısı 4.000 günlük sınırın altında kalır.