Bu belgede, Adobe Flex geliştirme ortamına yönelik Adobe Flash için Google Analytics İzleme kurulumu hakkında bilmeniz gereken her şey açıklanmaktadır.
İzleme Kitaplığını Alma
Kodu (ZIP biçimi) http://code.google.com/p/gaforflash/downloads/list adresinden indirin. Flex bileşenini yüklemek için readme.txt
dosyasındaki talimatları uygulayın. Analytics Flash bileşenlerinden farklı olarak, indirme dosyasında yalnızca bir kitaplık dosyası bulunur: /lib/analytics_flex.swc
.
Kodu Projenize Ekleyin
Projenizde izleme kodunu kullanmaya başlamadan önce, proje kaynağı olarak indirdiğiniz SWC
dosyasını bağlamanız gerekir.
- Proje->Özellikler'i seçin. Projeniz için bir Özellikler iletişim kutusu görünür.
- Flex Build Path'i (Esnek Derleme Yolu) tıklayın ve Library Path (Kitaplık Yolu) sekmesini seçin.
- Kitaplık Yolu bölmesinde SWC ekle... seçeneğini tıklayın. SWC ekle iletişim kutusu görünür.
- Google Analytics API'nin sıkıştırmasını açtığınız konuma gidip
lib/analytics.swc
dosyasını seçin ve Tamam'ı tıklayın.
Alternatif olarak,analytics.swc
dosyasını Flex projenizin/libs
dizinine bırakabilirsiniz.
Flex MXML Bileşeni Örneği
Aşağıdaki örnekte, MXML dosyasındaki bir düğme için izlemenin nasıl ayarlanacağı gösterilmektedir. MXML bileşenini başlatmak için aşağıdakileri yapın:
- XML ad alanı parametresini ayarlayın. İzleme nesnenizin XML ad alanı parametresini şu şekilde ayarlayın:
xmlns:analytics="com.google.analytics.components.*"
- Nesne adını ayarlayın. Aşağıdaki örnekte
id
parametresitracker
olarak ayarlanmıştır. - Web mülkü kimliği için
account
parametresini kullanın. Web mülkü kimliği, Flash içeriğinizdeki etkinliği izlemek ve bu içeriği Analytics hesabınızda doğru görünüme (profile) iletmek için kullanılan benzersiz dizedir. mode
parametresiyle izleme modunu ayarlayın. Bir MXML dosyası oluşturuyorsanız ve izlemeyi uygulamanın basit bir yolunu arıyorsanız parametre içinBridge
kullanın. ActionScript3 kullanarak rahatça kod yazabiliyorsanızAS3
kullanın. AS3 modu, kendi izleme nesnelerinizi oluşturup yapılandırabileceğiniz tüm GA izleme sınıflarını içe aktarmanıza olanak tanır.visualDebug
parametresiyle hata ayıklama modunu ayarlayın. Programınızda hata ayıklama ve doğrulamayı etkinleştirmek içintrue
kullanın. Aksi takdirde, üretimde kullanmak için bunufalse
olarak ayarlayın.
Bu örnekte, sahneye bir düğme mybutton
eklenmiştir. Flex izleme bileşeni, tracker
adıyla oluşturulur ve bu bileşenin parametreleriyle yapılandırılır. Son olarak, mybutton
kampanyasına onButtonClick
tıklama etkinliği eklenir. Düğme tıklandığında, sanal sayfa görüntüleme /hello world
değeri tek bir sayıyla artar.
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" > <mx:Script> public function onButtonClick():void { tracker.trackPageview( "/hello world" ); } </mx:Script> <analytics:FlexTracker xmlns:analytics="com.google.analytics.components.*" id="tracker" account="UA-111-222" mode="AS3" visualDebug="false" /> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>
Flex ActionScript 3 Örneği
Daha karmaşık durumlarda, yerel ActionScript 3 izleme sınıflarını doğrudan ActionScript kaynak dosyalarınızdan çağırmak isteyebilirsiniz. Bu örnek aynı zamanda bir MXML dosyası olsa da, tüm izleme örneklendirmesi <MX:script>
etiketlerinde yapılır. Aynı işlem, diğer ActionScript 3 projelerine izleme eklemek için de kullanılabilir.
Bu örnekte, sahneye bir düğme mybutton
eklenmiştir. Komut dosyası etiketlerinde iki kitaplık içe aktarılır:
com.google.analytics.GATracker; //this is the actual tracking class com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements
Kitaplıklar içe aktarıldıktan sonra, tracker
izleme değişkeni oluşturulur. Uygulama sahneye eklendikten sonra izleme nesnesini somutlaştıran onComplete
çağrılır. GATracker nesnesini örneklendirmek için ihtiyacınız olan dört parametre şunlardır:
- Geçerli görüntüleme nesnesine başvuruda bulunun. Aşağıdaki örnekte,
this
, görüntüleme nesnesine başvuruda bulunmaktadır. - Web mülkü kimliği. Web mülkü kimliği, Flash içeriğinizdeki etkinliği izlemek ve bu içeriği Analytics hesabınızda doğru görünüme (profile) iletmek için kullanılan benzersiz dizedir.
- İzleme modu. Geçerli parametreler
Bridge
veyaAS3
'dir. - Hata ayıklama modu. Üretim kullanımı için
debug
değerinifalse
, doğrulama ve sorun giderme içintrue
olarak ayarlayın.
Son olarak, myButton
tıklama yönteminde onButtonClick
işlevi, izleme nesnemizde sanal bir sayfa görüntülemeyi izler.
Bu uygulama çalıştığında, kullanıcının düğmeyi her tıklayışında, Google Analytics izleme sunucularına sanal bir "hello world" sayfa görüntülemesi gönderilir.
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" addedToStage="onComplete()" > <mx:Script> <![CDATA[ import com.google.analytics.GATracker; import com.google.analytics.AnalyticsTracker; public var tracker:AnalyticsTracker; private function onComplete():void { tracker = new GATracker( this, "UA-111-222", "AS3", false ); } public function onButtonClick():void { tracker.trackPageview( "/hello/world" ); } ]]> </mx:Script> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>