Adobe Flex Kurulumu

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 Ekleme

Projenizde izleme kodunu kullanmaya başlamadan önce, proje kaynağı olarak indirdiğiniz SWC dosyasını bağlamanız gerekir.

1. Proje->Özellikler'i seçin. Projeniz için bir Özellikler iletişim kutusu görünür.
2. Flex Build Path'i (Esnek Derleme Yolu) tıklayın ve Library Path (Kitaplık Yolu) sekmesini seçin.
3. Kitaplık Yolu bölmesinde SWC ekle... seçeneğini tıklayın. SWC ekle iletişim kutusu görünür.
4. 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.

Başa Dön

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 parametresi tracker 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çin Bridge kullanın. ActionScript3 kullanarak rahatça kod yazabiliyorsanız AS3 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çin true kullanın. Aksi takdirde, üretimde kullanmak için bunu false 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>

Başa Dön

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 veya AS3'dir.
• Hata ayıklama modu. Üretim kullanımı için debug değerini false, doğrulama ve sorun giderme için true 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>

Başa Dön