Gadget İzleme

Bu belgede, yeni Google Gadget API'sının Analytics gadget izleme için nasıl kullanılacağı açıklanmaktadır. Bu API, gadget'larınız için Analytics rapor istatistikleri toplamak üzere geliştirilmiş bir veri modeli ve performans izleme özelliği sunar.

  1. Başlamadan Önce
  2. Gadget'ınızı İzleme
  3. Takip Yöntemleri
  4. Kullanımla İlgili Dikkat Edilmesi Gereken Noktalar
  5. İpuçları
 

Başlamadan Önce

Google Analytics'te, hesabınıza eklediğiniz her benzersiz web sitesi alanı veya alt alan adı, ayrı bir görünümde (profilde) izlenir ve ayrı bir alan kimliği atanır. Her bir gadget gmodules.com ana makine sitesinde kendi alt alanında çalıştığından, oluşturduğunuz her bir gadget'ı kendi görünümünde (profil) ve benzersiz bir alan kimliği ile izlemek istersiniz.

Bunu yapmanın en kolay yolu, Google Analytics'in sizin için benzersiz bir kimlik oluşturmasına izin vermektir.

  1. Başlamak için, Google Analytics'te oturum açın veya bir Google Analytics hesabına kaydolun.
    • Yeni kullanıcılar Yeni Hesap Kaydolma sayfasını görürler.
    • Mevcut kullanıcılar Analytics Ayarları sayfasına gidip Web Sitesi Görünümü (Profil) Ekle'yi tıklamalıdır. (Yeni alan'ı seçtiğinizden emin olun.)
  2. Bu sayfaların birinden geçerli bir web sitesi URL'si girin.
    3. Web sitesi URL'si yalnızca Google Analytics yazılımının alan kimliğinizle eşleştirdiği bir dize olduğundan, bu URL, uydurma veya gerçek olması fark etmeksizin herhangi bir geçerli web sitesi URL'si dizesi olabilir. İzleme kodunu web sayfalarına hiçbir şekilde yüklemeyeceksiniz ve web sitenizin herhangi bir sayfasına erişmeniz gerekmeyecektir.
  3. Sonraki ekrana devam etmek için düğmeyi tıklayın.
    4. İzleme kodu snippet'i göründüğünde, benzersiz alan kimliğini beyaz tahtaya kopyalayın. Otomatik olarak oluşturulan kod snippet'i, bu alan kimliğini UA-123456-1 biçiminde içerir.
  4. Son düğmesini tıklayın.
    5. Görünüm (profil) listesinde web sitenizin URL'sinin adını görmeniz gerekir. Ayrıca, ilgili görünümün (profilin) Düzenle bağlantısını ve ardından tekrar Düzenle'yi tıklayarak görünüm (profil) adını daha anlamlı bir şekilde değiştirebilirsiniz.
  5. Oluşturulan alan kimliğini gadget izleme kodunuzda kullanın.
    6. Analytics alan kimlikleri şu şekildedir:
    UA-123456-1
 

Gadget'ınızı İzleme

Gadget'ınızı izleme işlemi, gadget kodunuza üç ekleme içerir:

  1. Özellik etkinleştiriliyor.
  2. İzleyici nesnesi oluşturuluyor.
  3. İki yöntemden birini kullanarak gadget'ınızı izleme.

Aşağıdaki gadget kod örneğinde bu kod eklemelerinin her biri gösterilmektedir. Bunlar aşağıda açıklanmıştır. Kendi gadget'ınızı başlatmak için bu örnek dosyayı kullanabilirsiniz.

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Analytics Test">
     <!-- Sets the feature -->
     <Require feature="com.google.gadgets.analytics" /> 
     <Require feature="setprefs" /> 
  </ModulePrefs>
  <UserPref 
      name="counter"
      datatype="hidden"
      default_value="0" />
  <Content type="html"> 
  <![CDATA[ 
      <script>
      // Track this gadget using Google Analytics.

      // Creates a tracking object and uses reportPageview method to call gadget view
      var ga = new _IG_GA("UA-00000-1");
      ga.reportPageview('/view/counterGadget');

      // Suppose, for example, you have a gadget with two counter buttons.
      // You can track interactions with those counters via Analytics.

      // Increment value of "counter" user preference
      function incrementCounter() {
         var count = prefs.getInt("counter");

         prefs.set("counter", count + 1);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Increment", "Button", 0);
      }

      // Reset value of "counter" userpref to 0
      function resetCounter(){
         prefs.set("counter", 0);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Reset", "Button", 0);
      }
      </script>
      <form name="counter">
      <input type=button value="Reset" name="reset" onClick="resetCounter()">
      <input type=button value="Count" name="count" onClick="incrementCounter()">
      </form>
  ]]>
  </Content>
</Module>

1. Özelliği etkinleştirme

İlk olarak, özellik ad alanını kullanıp Analytics kitaplığını içe aktararak bu özelliği etkinleştirin:

 <Require feature="com.google.gadgets.analytics" />

2. İzleyici Nesnesi Oluşturma

Analytics izleme API'si ga.js izleme koduyla aynı nesneye dayalı modele uyar. Bu nedenle, gadget'ınızı izlemeden önce bir izleyici nesnesi örneği oluşturun:

var ga = new _IG_GA("UA-123456-1");

Yukarıdaki adımları uygulayarak oluşturduğunuz alan kimliğini buraya eklersiniz.

Sondaki tek rakamla birlikte tam alan kimliğini kullanmanız gerekir. Aksi takdirde, izleme nesnesi çağrısı başarısız olur.

3. Gadget'ınızı İzleme

Gadget API'sı, gadget'larınızdaki etkileşimi izlemek için kullanabileceğiniz iki yöntem sağlar:

  • Sanal URL yöntemi
    • ga.reportPageview(path);

    Bu yöntem, gadget istatistiklerini özel sayfa görüntülemeleri olarak izler ve Analytics gadget API'sının önceki sürümünde kullanılan yöntemle aynıdır. Bu yöntemi kullanarak, mevcut Analytics rapor düzeninizi etkilemeden önceden var olan herhangi bir gadget izleme kodunu güncelleyebilirsiniz. Raporlama verilerini, tıpkı web sayfaları için raporlama verilerini görüntülediğiniz gibi, gadget'larınızda da görüntüleyebilirsiniz.

    Gadget etkileşimini izlemek için sanal URL yöntemini kullandığınızda, her çağrı yönteme parametre olarak sağladığınız dize için bir sayfa isteği olarak kaydedilir. Bu davranıştan yararlanarak, uydurma bir URL yolu aktarabilirsiniz. Böylece, Google Analytics arayüzünde, web sitesi sayfası raporlarında olduğu gibi, gadget'lara ilişkin raporları da görüntüleyebilirsiniz. Örneğin, hem gadget görünümlerini hem de gadget etkileşimlerini izlemek için ayrı yollar kullanabilirsiniz: 

    ga.reportPageview('/view/counterGadget');
ga.reportPageview('/click/increment');
ga.reportPageview('/click/reset');

  • Etkinlik izleme yöntemi
    • ga.reportEvent(name, action, [[]label], [[]value]);

    Bu yöntem yalnızca yeni Analytics gadget API'sinde kullanılabilir. Bu yöntemi kullanarak, sayfa görüntülemelerini (örneğin, gadget oluşturma) gadget'ınızdaki kullanıcı etkileşimlerinden ayrı olarak izleyebilirsiniz.

    Not: Etkinlik İzleme şu anda kapalı beta sürümündedir. Etkinlik İzleme'ye erişiminiz yoksa sanal URL yöntemini kullanın.

    Etkinlik yöntemi, gadget izleme ile kullanmanız için farklı bir model sağlar. Öncelikle, etkinlik çağrıları sayfa görüntüleme çağrılarından ayrı olarak hesaplanır ve elde edilen veriler Google Analytics İçerik raporlarının ayrı bir bölümünde gösterilir. Böylece, kullanıcı etkileşiminin, gadget görünümlerinin toplam rakamlarını şişirmesine gerek kalmadan, bir gadget'ın görünümünü, gadget'taki kullanıcı etkileşimlerinden ayrı bir şekilde izleyebilirsiniz. İkinci olarak, bu yöntemde etkinlik izleme modeli kullanılır. Bu modelin yapısı özel olarak gadget'lardaki kullanıcı etkileşimini analiz etmek için tasarlanmıştır. Bu modelde hem etiket hem de değer isteğe bağlı parametrelerdir.

    Sayaçlar örneğini kullanarak, hangi gadget işlevlerinin tetiklendiğini izlemek için etkinlik yöntemini kullanabilir ve her iki durumda da bir düğme olan denetim türünü aktarabiliriz. 

    ga.reportEvent("Counter Gadget", "Increment", "Button");
ga.reportEvent("Counter Gadget", "Reset", "Button");

    Bu çok basit bir örnektir, ancak etkinlik izleme modeli, gadget'ınızın benzersiz izleme gereksinimlerinden yararlanacak şekilde hassaslaştırabileceğiniz son derece esnek bir yapıdır. Daha fazla bilgi için İzleme Etkinlikleri belgelerine bakın.

 

Takip Yöntemleri

Şu anda, Analytics özelliği aşağıdaki yöntemleri sunmaktadır. Bunların kullanımı yukarıda anlatılmıştır.

  • reportPageview()
    • İçerik raporlarının doğru şekilde doldurulması için dize kullanılması gerekir. Genellikle bu dize, raporlama amaçlarınız için tanımladığınız bir yol biçimindedir. Bu yönteme iletilen değer, GIF isteği içinde utmp değişkeni aracılığıyla gönderilir. Gadget yüklemelerini ve gadget etkileşimlerini izlemek için bu yöntemi kullanın. 
    ga.reportPageview("/view/gadgetName");
    parameters
    String  path Bu öğenin sanal URL'sini sağlayacak yol.

  • reportEvent()
    • İzlenen verilerin Etkinlik İzleme raporlarına doğru şekilde eklenebilmesi için gadget ve işlem parametresinin adını gerektirir. Diğer parametreler isteğe bağlıdır. Bu yöntemle iletilen değerler, GIF istek görünümünde utmevariableU gönderilir.

    parameters
    String  name  Zorunlu.Etkinlik İzleme raporlarının en üst düzeyinde kullanılan bir dize. Örneğin, çok sayıda gadget öğesiyle ilgili etkileşimi izliyorsanız, muhtemelen bu parametre için gadget'ın adını kullanırsınız. Böylece, gadget'la ilgili tüm etkileşim izleme Google Analytics raporlarının aynı bölümünde toplanır.

    String  action  Zorunlu. Etkinlik İzleme raporlarında gadget etkileşimini daha ayrıntılı segmentlere ayıran dize. Daha fazla bilgi için İzleme Etkinlikleri belgelerine bakın.

    String  label  İsteğe bağlı. Gadget'ınız için ikincil segment olarak kullanabileceğiniz dize.

    Int  value  İsteğe bağlı. Gadget etkileşimi için değer olarak sağlayabileceğiniz sayı. Bu sayı, yöntemin her çağrılışında toplanır.

 

Kullanımla İlgili Dikkat Edilmesi Gereken Noktalar

Google Analytics gadget API'sı kullanırken dikkat edilmesi gereken bir dizi nokta vardır:

  • Desteklenen Kapsayıcılar
    • Google Analytics gadget API'si ile aşağıdakiler dahil ancak bunlarla sınırlı olmamak üzere birçok kapsayıcı türü desteklenir:
    • iGoogle
    • Sendikasyonu Aç
    • Open Social
    • Gadget
  • Desteklenmeyen Gadget Türleri
    • Google Analytics gadget API aşağıdaki gadget türlerini desteklemez:
    • Satır içi gadget'lar (type=html-inline)
    • Mapplets
    • URL türü gadget'lar (type-url)
    • Google AdSense'te Gadget Reklamlar
  • Alanla ilgili dikkat edilmesi gereken noktalar
    • Gadget'ınız için Analytics özelliğini kullanmanız gerektiğinde, gadget'ınız <subdomain>.gmodules.com adresine yönlendirilecek. Burada <subdomain>, benzersiz ve rastgele bir alt alan adıdır. Dolayısıyla, gadget'taki tüm içerik söz konusu alt alanda görüntülenir. Örnek: 3nvma227-a.gmodules.com. Ayrıca, tüm Google Analytics izleme çerezleri bu benzersiz alt alan adına ayarlanır. Bu nedenle, haritalar Analytics izleme özelliği tarafından desteklenmez ve özellikle Flash içeriğine, izleme özelliğine özel erişim izni vermeniz gerekir (aşağıya bakın).
  • Flash içeriği kullanan gadget'lar
    • Flash içeriği kullanan gadget'lar, allowScriptAccess parametresini "her zaman" değerine ayarlayarak Flash URL'si ile gadget URL'si arasındaki iletişimi özel olarak etkinleştirmelidir. 
    _IG_EmbedFlash("example.swf", "wrapper", {allowScriptAccess: "always"});
 

İpuçları

Sanal URL Yöntemi En İyi Nasıl Kullanılır?

Gadget'larınız için etkinlik izleme yöntemine erişiminiz yoksa, gadget'larınızı sanal URL yöntemiyle izlemek için şu önerileri uygulayın:

  • Gadget yüklemenizi belirgin bir şekilde bölümlere ayırın.
    • Gadget yükleme/görüntüleme istatistiklerini, gadget etkileşim metriklerinden ayrı olarak segmentlere ayıran bir yol sağlayarak, gadget yüklenirken ga.reportPageview() öğesini çağırabilirsiniz. Bu işlem, gadget'a ilişkin içerik raporlama verilerini, gadget'taki etkileşimlerden ayrı bir "dizinde" tutacaktır. Böylece, genel görünümlerinizi gadget'ın kendisindeki etkileşim sayısından ayrı olarak görebilirsiniz. Örneğin, gadget yüklemenize ait tüm istatistikleri görüntülemek için gadget'ınızda aşağıdaki kod snippet'i kullanılabilir: 
      ga.reportPageview('/view/gadgetName');
  • Farklı etkileşim türlerini birbirinden segmentlere ayırın.
    • ga.reportPageview() öğesini, farklı kullanıcı etkileşimlerini segmentlere ayıran bir yolla çağırın. Bu şekilde, gadget bağlantıları, gadget düğmeleri veya etkileşim verileri için izlemek isteyebileceğiniz diğer widget'lar için ayrı içerik raporları alabilirsiniz. Örneğin:
    • ga.reportPageview('/link/click');
    • ga.reportPageview('/link/submit');

Etkinlik İzleme Yöntemini Kullanma

Google Analytics raporlarındaki Etkinlik İzleme özelliğine erişiminiz varsa, nesnelerinizi izleme özelliğinden en iyi şekilde yararlanmak için son derece esnek veri modelinden yararlanabilirsiniz. Aşağıda bazı ipuçları verilmiştir:

  • ga.reportPageview() kullanarak gadget görünümünü veya gösterimini, ga.reportEvent() kullanarak gadget etkileşimini izleyin.
    • Gadget görünümleri, sayfa verilerinin İçerik bölümünde, gadget etkileşimleri ise İçerik raporlarının altındaki Etkinlikler bölümünde gösterilir.
  • Gadget'ınızın nereye yerleştirildiğini öğrenmek için document.referrer parametresini kullanın.
    • Gadget'ta document.referrer, genellikle kapsayıcının sayfa URL'sidir. Dolayısıyla bu URL'yi ga.reportEvent() yönteminde etiket parametresi olarak aktarabilirsiniz:
    var containerPage = document.referrer;
ga.reportEvent("Counter Gadget", "Increment", containerPage, 0);

Sorun giderme

Gadget'ınızın GIF isteği dizesini analiz etmek için 3. taraf araçlarını kullanabilirsiniz. Böylece, veriler Google Analytics raporlarına beklediğiniz şekilde gönderileceğini doğrulayabilirsiniz. Gadget düzgün bir şekilde barındırılıp test sayfanızda çalışmaya başladıktan sonra GIF isteği dizesini aşağıdaki gibi analiz edin:

  • Sayfa görüntüleme yöntemi
    • GIF isteği parametrelerinde utmp değişkenini arayın. Bu değişkenle ilişkili bilgiler, Google Analytics raporlarına gadget için "yol" olarak gönderilir.
  • Etkinlik İzleme yöntemi
    • GIF istek parametrelerindeki utme değişkenini arayın. Bu bilgi 5(object*action*label)(value) biçiminde olmalıdır.

İzleme koduyla ilgili sorunları giderme hakkında daha fazla bilgi edinmek için GATC Sorun Giderme Kılavuzu'na bakın.