Adobe Flash için Google Analytics İzleme

Adobe Flash için Google Analytics İzleme bileşeni, Google Analytics'i Flash tabanlı içeriğinize uygulamanızı kolaylaştırır. Adobe Systems, Inc. tarafından geliştirilen bu bileşen, Google Analytics JavaScript kodunun tüm işlevlerini içerir. Flash İzleme bileşeni, ActionScript 3'e özgü olan derlenmiş bir izleme nesnesidir. Bu bileşen, Flash ve Flex geliştirme ortamlarında Analytics uygulamasını kolay anlaşılır hale getirir.

Neden Flash İzleme Kullanılmalı?

Adobe Flash için Google Analytics İzleme bileşeni olmadan, Adobe Flash içeriğini Google Analytics ile izlemek bir dizi teknik engelle karşılaşacaktır. Öncelikle, Flash uygulamanızın trackPageview() veya trackEvent() gibi uygun Analytics yöntemini çalıştırabilmesi için ga.js için özel bir arayüz geliştirmeniz gerekir. Ayrıca, DOM'a erişimin reddedildiği (genellikle içeriğiniz üçüncü taraf sitelerde bulunduğunda) için izleme başarısız olduğundan, Flash içeriğinizin tarayıcı Belge Nesne Modeli'ne (DOM) erişimi olup olmayacağını da tahmin etmeniz gerekir. Bu, tarayıcı DOM'sine erişmek ve erişim reddedildiğinde performansı düşürmek için ActionScript 3'te ExternalInterface çağrısının nasıl kullanılacağının anlaşılmasını içerir.

Adobe Flash için Google Analytics bileşeni, Flash içeriğinizi izlemeyi basitleştirir ve DOM erişimini sorunsuzca gerçekleştirir. Bu, Flash'taki bir dizi yaygın izleme amacı için yararlıdır. Örneğin:

  • HTML sayfasında gömülü bir Flash widget
  • Bağımsız bir Flex uygulaması veya HTML sayfasında bulunan, yalnızca Flash'tan oluşan bir site
  • Widget'ın yerleştirileceği yerle ilgili olarak geliştiricinin hiçbir denetime sahip olmadığı, dağıtılan bir Flex/Flash oyunu veya programı

Flash'taki izleme uygulamalarını izleme ile web sitesi sayfalarının izlenmesi arasında bazı yapısal farklılıklar olduğunu unutmayın. Bu eklentinin nasıl çalıştığını anlamak için Analytics İzleme özelliğine aşina olmanız çok önemlidir. Bu bileşen için Analytics İzleme modelinin nasıl aktarıldığına ilişkin ayrıntılı bilgi için bu projenin Tasarım Belgelerini de görüntüleyebilirsiniz.

Not: Şu anda Flash izleme, bir web sayfasına yerleştirilen tüm Flash içerik için kullanılabilir. Adobe Air, Shockwave veya Flash IDE üzerinden gönderilen verilerin izlenmesi (ör. Test Filmi kullanılarak) şu anda desteklenmemektedir.

Desteklenen Geliştirme Ortamları

Flash için Analytics İzlemeyi Adobe Flash veya Adobe Flex ortamlarında geliştirebilirsiniz. Her ortam için, http://code.google.com/p/gaforflash/ adresinden indirebileceğiniz farklı bir bileşen gereklidir. Bu bileşenler ActionScript 3'e dayanır ve her ortam için iki yöntemden biriyle ayarlanabilir:

Adobe Flash'ta

  • Bileşen İnceleyici'de basit bir bileşen ekleyip yapılandırın ve sahneye sürükleyin.
  • Flash İzleme kitaplıklarını doğrudan kitaplığınıza aktarın ve kodlamaya başlayın.

Adobe Flex'te

  • Am MXML dosyasından yapılandırdığınız bir MXML bileşenini ekleyin.
  • Flash İzleme kitaplıklarını komut dosyası etiketlerinize/AS3 dosyalarınıza aktarın.

Bileşen Nasıl Çalışır?

Ortamınızda Flash izleme bileşenini kullanabilmek için Flash'ın içindeki görsel araçları kullanabilir veya izleme nesnesini doğrudan kodunuzda ayarlayabilirsiniz. Bileşeni görsel olarak veya kod aracılığıyla oluşturuyor olmanızdan bağımsız olarak aşağıdaki öğeleri sağlarsınız:

  • web mülkü kimliği: Bu, izleme kodunuzun UA numarası olarak da bilinir ve UA-xxxxx-yy biçimindedir. Burada x ve y'ler, izlemekte olduğunuz nesnenin hesap ve görünüm (profil) bilgilerine karşılık gelen sayılarla değiştirilir. Daha fazla bilgi için Web Mülkü konusuna bakın.
  • izleme modu: Köprü modunu veya AS3 modunu seçin. Bu mod, izlemenizin Analytics sunucularıyla nasıl iletişim kuracağını belirler ve aşağıda ayrıntılı olarak açıklanmıştır.
  • hata ayıklama modu - Hangi ortamı veya izleme modunu kullanırsanız kullanın, izlemenizi doğrulamak ve test etmek için hata ayıklamayı açabilirsiniz.

İzleme Modları

Flash içeriğinizi nasıl dağıttığınıza bağlı olarak, Flash için Analytics bileşeni, Analytics sunucularıyla, ya mevcut bir Analytics izleme kurulumundaki Flash içeriği arasında köprü oluşturarak ya da doğrudan Analytics sunucularıyla iletişim kurarak Analytics sunucularıyla iletişim kurar. Bu iki mod, sırasıyla köprü modu ve AS3 modu olarak adlandırılır. Her iki mod da aynı Analytics izleme işlevini kullanır. Flash uygulamanızı bir moddan diğerine kolayca değiştirebilirsiniz. Analytics izlemesi için bir iletişim modu seçmeye ek olarak, izlemeyle ilgili sorunları gidermek veya izlemek için hata ayıklama modunu da kullanabilirsiniz.

Her iki modda da kampanya izlemenin çalışması için allowscriptaccess, always değerine eşit olmalıdır. Bu parametre, sayfanın URL'sine ve Flash izleme kodunun gerektirdiği yönlendiren bilgilerine okuma erişimini açar. allowscriptaccess kullanılmadığında, Analytics izleme kodu sorunsuz bir şekilde düşürür. Kullanıcı etkinliği verilerinin çoğu yine sağlansa da Google Analytics kampanyası ilişkilendirme modelini doğrulamaz.

Köprü Modu

Bu modu hem HTML sayfasını hem de Flash içeriğini kontrol ediyorsanız kullanın. Bu mod, web sitenizde Google Analytics (ga.js) izlemeyi zaten uyguladıysanız ve yerleştirilmiş Flash içeriğe izleme eklemek istiyorsanız en iyi seçenektir. Köprü modu, ga.js koduna birleştirilmiş bir ActionScript 3 arayüzü sağlayarak Flash-JavaScript iletişimi basitleştirir. İzlemenin çalışması için, ActionScript 3 çağrılarıyla Analytics JavaScript'e yapılan bağlantıyı sağlar.

Google Analytics İzleme Kodu ile bağlantı, web mülkü kimliği parametresi aracılığıyla şu iki yöntemden biriyle yapılandırılabilir:

  • En yaygın yöntem. Google Analytics İzleme Kodu nesnesi, sayfanızda pageTracker gibi kendi adıyla zaten mevcut. Bu durumda, izleme nesnesine tam DOM referansını sağlarsınız. Örneğin, nesneniz pageTracker olarak adlandırılırsa kodunuzda bu nesneye window.pageTracker olarak referans verirsiniz. Örneğin, aşağıdaki kod snippet'inde ActionScript 3 ile Adobe Flex ortamı kullanılarak bunun nasıl yapılandırılacağı gösterilmektedir:
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • Alternatif yöntem. Sayfanızda bir sayfa izleme nesnesi oluşturmadıysanız, web mülkü kimliğinizi girmeniz yeterlidir; sizin için bir JavaScript izleme kodu nesnesi oluşturulur. Bu yöntemle, HTML sayfanızda temel ga.js javascript kaynak dosyasına referans verilmesi gerekir. Aşağıdaki kod snippet'inde, ActionScript 3 ile Adobe Flex ortamı kullanılarak bunun nasıl yapılandırılacağı gösterilmektedir:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Köprü modunun düzgün çalışması için ExternalInterface.available, ActionScript 3 kodunuzda true olarak ayarlanmalıdır. Bu aynı zamanda, Flash içeriğinin yerleştirildiği HTML sayfasında allowScriptAccess öğesinin always olarak ayarlanması gerektiği anlamına gelir. Aşağıdaki örnekte, köprü modu için yapılandırılmış HTML kodu gösterilmektedir:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

 

AS3 Modu

Bu modu, Adobe Flash ActionScript 3 kodunu kontrol ediyor, ancak Adobe Flash uygulamanızın barındırma ortamını siz kontrol etmiyorsanız kullanın. Örneğin, çok sayıda siteye dağıtılmak üzere Flash içeriği geliştiriyorsanız AS3 modunu kullanırsınız. AS3 modu, ga.js izleme kodundan tamamen bağımsızdır ve tüm Analytics izleme işlevlerini içerir. Bu modda ayrı bir ga.js izleme kurulumuna gerek yoktur. Buna ek olarak, AS3 modu kullanıcının oturum bilgilerini izlemek için Flash depolama mekanizmasını kullanır.

AS3 bileşeni, dil gibi belirli DOM parametreleri için değerleri tarayıcıdan almaya çalışır. Değerler mevcut değilse bileşen, Flash eşdeğer değerini kullanır veya varsayılan olarak no değerini kullanır.

Sorun Giderme ve Doğrulama

Adobe Flash için Google Analytics İzleme bileşeni, doğrulama ve sorun gidermeyi basitleştirmek için bir hata ayıklama modu sağlar. Etkinleştirildiğinde, tüm izleme verileri engellenir ve Analytics sunucuları yerine bir metin kutusundaki bir ekrana yönlendirilir. Bu modda, aksi takdirde sunucu tarafından toplanacak verileri gerçek zamanlı olarak görebilirsiniz. Bu özellik, test verilerini üretim verilerinizin dışında tutmanıza da yardımcı olur. Bileşen İnceleyici'de visualDebug seçeneğini true olarak ayarlayarak sorun giderme özelliğini etkinleştirebilirsiniz.

Örnekler

İzlemeyi farklı geliştirme ortamlarında uygulamayla ilgili ayrıntılı örnekler için aşağıdakilere bakın:

Flash

Flex

Sürüm oluşturma

İzleme bileşenlerinin en son sürümünü ZIP dosyası olarak http://code.google.com/p/gaforflash/downloads/list adresinde bulabilirsiniz. Her indirme, tüm izleme bileşenleriyle birlikte ilgili belgeleri içerir. İndirilen dosyanın adı, içerdiği kodun sürüm numarasını gösterir.

Bileşenin mevcut sürüm numarasını çıktı konsoluna yazdırmak için kodunuzda aşağıdaki ifadeleri de kullanabilirsiniz.

import com.google.analytics.API;
trace(API.version);