Adobe Flash Kurulumu

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

Bileşen Dosyalarını alma

Flash izleme bileşeni dosyaları, http://code.google.com/p/gaforFlash/downloads/list adresinden indirebileceğiniz tek bir ZIP dosyası olarak sıkıştırılır.

Flash bileşenlerini yüklemek için readme.txt dosyasındaki talimatları uygulayın.

  1. Şu anda açık Adobe Flash CS3 varsa uygulamadan çıkın.
  2. Aşağıdaki konumlardan birinde bir Google dizini oluşturun:
    • Windows için: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • Mac OS X için: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. Bileşen ZIP dosyasını çıkardığınız konuma gidin ve aşağıdaki dosyaları önceki adımda oluşturduğunuz dizine kopyalayın:
    • lib/analytics_flash.swc — Analytics Bileşeni
    • lib/analytics.swc — Analytics Kitaplığı Bileşeni

Her iki bileşen de aynı işlevlere sahiptir ancak farklı geliştirme stilleri için kolaylık sağlar.

Analytics bileşeni. Flash içeriği geliştiriyorsanız ancak ActionScript 3 hakkında bilginiz yoksa bu bileşeni kullanın. Analytics bileşeni, eksiksiz bir izleme paketidir. Bileşenleri doğrudan sahnenize sürükleyip bırakmanız, bileşen inceleyicide birkaç basit yapılandırma yapmanız ve kontrollerinizi Analytics izleme ile etiketlemeye hazırsınız olması yeterlidir.

Analytics Kitaplığı bileşeni. ActionScript 3 hakkında bilgi sahibiyseniz AnalyticLibrary bileşenini kullanabilirsiniz. Bileşeni Flash Kitaplığınıza sürükleyin ve izleme sınıflarını doğrudan ActionScript kodunuza aktarın.

Analytics Bileşenini Kullanma

Analytics bileşeni aracılığıyla izlemeyi uygulamak için analytics_flash.swc özelliğini kullanın. Bileşeni doğru Bileşen dizinine yerleştirin, Bileşenler panelinde (Pencere - Bileşenler) görünür.

  1. Bileşeni sahneye sürükleyin ve Özellikler iletişim kutusunda bir örnek adı verin.
  2. Bileşeni, Bileşen İnceleyici panelinde (Windows - Bileşen İnceleyici) yapılandırın:
    • Analytics web mülkü kimliğinizi ekleyin.
    • Köprü modunu veya AS3 modunu seçin.
    • Görsel hata ayıklamanın açık veya kapalı olduğunu belirtin.
  3. ActionScript kodunuzda, az önce oluşturduğunuz bileşenin örneğine standart GA izleme çağrılarını ekleyin.

Flash'ın görsel bileşenlerle çalışma şekli nedeniyle, genellikle Flash uygulamanızın ikinci karesinde izlemeye başlamak en iyisidir. İlk karede izlemeyi başlatmanız gerekiyorsa bileşenin Flash içeriğinde tamamen başlatılmasını sağlamak için izleme çağrılarını etkinlik işleyicilerin içine yerleştirin.

Basit bir Analytics Flash bileşeni örneği

Aşağıdaki kod snippet'i, Flash'ta bir düğmenin tıklandığında nasıl izlenebileceğini gösterir. Bu örnekte, düğme örneğiniz ActionScript'inizde playGame olarak adlandırılmaktadır. Düğme tıklandığında onButtonClick yöntemi çağrılır. Bu sayede trackPageview() yöntemi çağrılır. Bu, /myGame1 sanal sayfasının sayfa görüntüleme sayısını artırır.

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
}

AnalyticsLibrary Bileşenini Kullanma

Analytics Kitaplığı bileşeni aracılığıyla izlemeyi uygulamak için analytics.swc dosyasını kullanın. Bu bileşen, bir izleme nesnesini doğrudan AS3 kodunuzda örneklendirmenizi sağlar. AnalyticsKitaplık bileşeni doğru konuma yerleştirildikten sonra Bileşenler panelinde görünür. Daha sonra, bileşeni Bileşenler panelinden kitaplığınıza sürükleyebilir ve kitaplıkları ActionScript kodunuza aktarabilirsiniz.

İzleme Nesnesini başlatma

Adobe Flash ortamını kullanarak, izleme nesnesini aşağıdaki parametrelerle başlatın:

  • 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.

Basit bir AnalyticsLibrary Örneği

Aşağıdaki örnekte, sahnede playGame adlı bir film klibi vardır. tracker adı verilen yeni bir izleme nesnesi, fare tıklamasını dinleyen bir etkinlik işleyici ile birlikte oluşturulur. Düğme tıklandığında onButtonClick işlevi çağrılır. Her tıklama için trackPageview() yöntemi, /myGame1 sanal sayfasının sayfa görüntüleme sayısını artırır.

import com.google.analytics.AnalyticsTracker;
import com.google.analytics.GATracker;
var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true );
playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick ( event:Event ):void
{
   tracker.trackPageview("/myGame1");
}