Adobe Flex Kurulumu

Bu dokümanda, Adobe Flex geliştirme ortamında Adobe Flash için Google Analytics İzleme özelliğini ayarlamak üzere bilmeniz gereken her şey ele alınmaktadır.

İzleme Kitaplığı'nı edinin

Kodu (ZIP biçimi) http://code.google.com/p/gaforFlash/downloads/list adresinden indirebilirsiniz. Flex bileşenini yüklemek için readme.txt dosyasındaki talimatları uygulayın. Analytics Flash bileşenlerinin aksine, indirmede 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.

  1. Proje-Özellikler'i seçin. Projeniz için Özellikler iletişim kutusu görüntülenir.
  2. Flex Derleme Yolu'nu tıklayın ve Kitaplık Yolu sekmesini seçin.
  3. Kitaplık Yolu bölmesinde SWC ekle... seçeneğini tıklayın. SWC ekleyin iletişim kutusu görünür.
  4. Google Analytics API'yi çıkardığınız konuma gidin ve lib/analytics.swc dosyasını seçip Tamam'ı tıklayın.
    Alternatif olarak, analytics.swc dosyasını Esnek proje /libs dizininize bırakabilirsiniz.

Flex MXML Bileşen Örneği

Aşağıdaki örnekte, MXML dosyası içindeki 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ızdaki doğru görünüme (profile) göndermek için kullanılan benzersiz dizedir.
  • İzleme parametresini mode parametresiyle ayarlayın. MXML dosyası oluşturuyorsanız ve izlemeyi uygulamanın basit bir yolunu arıyorsanız parametre için Bridge kullanın. ActionScript3 kullanarak kod yazma konusunda rahatsanı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.
  • Hata ayıklama modunu visualDebug parametresiyle ayarlayın. Programınızda hata ayıklama ve doğrulamayı etkinleştirmek için true özelliğini kullanın. Aksi takdirde, üretimde kullanım için bunu false olarak ayarlayın.

Örnekte, sahneye mybutton düğmesi eklenir. Flex izleme bileşeni, tracker adı ile örneklenir ve parametreleriyle yapılandırılır. Son olarak, mybutton tıklama etkinliği onButtonClick eklenir. Düğme tıklandığında, sanal sayfa görüntüleme /hello world 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 bir MXML dosyası da olsa tüm izleme örnekleri <MX:script> etiketlerinde yapılır. Aynı işlem, diğer ActionScript 3 projelerine izleme eklemek için de kullanılabilir.

Bu örnekte, sahneye mybutton düğmesi eklenir. 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 soran onComplete çağrılır. GATracker nesnesini somutlaştırmak için gereken dört parametre vardır:

  • Mevcut görüntüleme nesnesine başvurun. Aşağıdaki örnekte, this görünen nesneye referans vermektedir.
  • 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ızdaki doğru görünüme (profile) göndermek 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 de true olarak ayarlayın.

Son olarak, myButton tıklama yönteminde onButtonClick işlevi, izleme nesnemizdeki sanal sayfa görüntülemesini izler.

Bu uygulama çalıştırıldığında, kullanıcılar düğmeyi her tıkladığında Google Analytics izleme sunucularına "merhaba dünya"nın sanal bir 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>