Bu sayfa, Cloud Translation API ile çevrilmiştir.

Adobe Flash için Google Analytics İzleme

Adobe Flash için Google Analytics İzleme bileşeni, Flash odaklı içeriğinizde Google Analytics'i 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 yerel olarak derlenmiş bir izleme nesnesidir. Analytics, Flash ve Flex geliştirme ortamlarında sezgisel bir uygulama sunar.

Flash İzleme Neden Kullanılmalı?

Adobe Flash için Google Analytics İzleme bileşeni olmadan, Adobe Flash içeriğinin Google Analytics ile izlenmesi birçok teknik engel gerektirir. İlk olarak, Flash uygulamanızın trackPageview() veya trackEvent() gibi uygun Analytics yöntemini yürütebilmesi için ga.js özel bir arayüz geliştirmelidir. Ayrıca, DOM'ye erişimin reddedildiği (bunun için genellikle içeriğinizin üçüncü taraf sitelerde olduğu) nesnelerde izleme başarısız olduğundan, Flash içeriğinizin tarayıcı Doküman Nesne Modeli'ne (DOM) erişimi olup olmayacağını da tahmin etmeniz gerekir. Bunun için tarayıcı DOM'una erişmek ve erişim reddedildiğinde erişim düzeyini düşürmek için ActionScript 3'te ExternalInterface çağrısının nasıl kullanılacağını anlamak gerekir.

Adobe Flash için Google Analytics bileşeni, Flash içeriğinizi izlemeyi basitleştirir ve DOM erişimini sorunsuzca gerçekleştirir. Flash'ta aşağıda belirtilen çeşitli yaygın izleme amaçları açısından yararlıdır:

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 uygulamaları izlemenin, web sitesi sayfalarını izlemeden bazı yapısal varyasyonları olduğunu unutmayın. Bu eklentinin nasıl çalıştığını anlamak için Analytics İzleme'ye aşina olmak çok önemlidir. Analytics İzleme modelinin bu bileşene nasıl taşındığı hakkında ayrıntılı bilgi için bu projenin Tasarım Belgelerini de görüntüleyebilirsiniz.

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

Desteklenen Geliştirme Ortamları

Adobe Flash veya Adobe Flex ortamlarında Flash için Analytics İzleme geliştirebilirsiniz. Her ortam için farklı bir bileşen gerekir. Bu bileşeni http://code.google.com/p/gaforFlash/ adresinden indirebilirsiniz. Bu bileşenler, ActionScript 3'ü temel alır ve her ortam için iki şekilde ayarlanabilir:

Adobe Flash'ta

Bileşen inceleyiciye 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şeni ekleyin.
Flash İzleme kitaplıklarını komut dosyası etiketlerinize/AS3 dosyalarınıza aktarın.

Başa Dön

Bileşenin İşleyiş Şekli

Ortamınızda Flash izleme bileşenini kullanmak için Flash'ın içindeki görsel araçları kullanabilir veya izleme nesnesini doğrudan kodunuza yerleştirebilirsiniz. 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 durum, izleme kodunuzun UA numarası olarak da bilinir ve UA-xxxxx-yy şeklindedir. Burada, x' ve y' değerleri, hesabınıza karşılık gelen ve izlediğiniz nesneyle ilgili profil (profil) bilgilerini gösteren sayılarla değiştirilir. Daha fazla bilgi için Web Mülkü bölümüne bakın.
izleme modu: Köprü modunu veya AS3 modunu seçin. Bu mod, izleme işleminizin Analytics sunucularıyla nasıl iletişim kurduğunu 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ı etkinleştirebilirsiniz.

İzleme Modları

Flash içeriğinizi nasıl dağıttığınıza bağlı olarak Flash için Analytics bileşeni, mevcut bir Analytics izleme kurulumundaki Flash içeriği arasındaki iletişimi sonlandırarak veya doğrudan Analytics sunucuları ile iletişim kurarak Analytics sunucularıyla iletişim kurar. Bu iki moda sırasıyla köprü modu ve AS3 modu denir. Her iki mod da aynı Analytics izleme işlevini kullanır ve Flash uygulamanızı bir moddan diğerine geçirmek kolaydır. Analytics izleme için iletişim modu seçmenin yanı sıra izlemenizle ilgili sorunları gidermek veya doğrulamak için bir hata ayıklama modu da kullanabilirsiniz.

Her iki modda da kampanya izleme özelliğinin çalışması için allowscriptaccess özelliğinin always değerine eşit olması gerekir. Bu parametre, sayfa izleme URL'sine ve Flash izleme kodu için gereken yönlendiren bilgilerine okuma erişimini etkinleştirir. allowscriptaccess olmazsa Analytics izleme kodu kontrollü şekilde düşer. Kullanıcı etkinliği verilerinin çoğunu sağlamaya devam eder ancak Google Analytics kampanya ilişkilendirme modelini onaylamaz.

Köprü Modu

Hem HTML sayfasını hem de Flash içeriğini kontrol ediyorsanız bu modu kullanın. Web sitenizde Google Analytics (ga.js) izlemeyi zaten uyguladıysanız ve yerleştirilmiş Flash içeriğine izleme özelliği eklemek istiyorsanız bu modu kullanabilirsiniz. Köprü modu, ga.js koduna birleştirilmiş bir ActionScript 3 arayüzü sağlayarak Flash'ten JavaScript'e iletişimi basitleştirir. İzlemenin çalışması için ActionScript 3 çağrılarından Analytics JavaScript'ine bağlantı sağlar.

Google Analytics İzleme Kodu bağlantısı, web mülkü kimliği parametresi aracılığıyla iki şekilde yapılandırılabilir:

En yaygın yöntem. Google Analytics İzleme Kodu nesnesi, sayfanızda zaten pageTracker adı gibi kendi adına sahip. Bu durumda, izleme nesnesine tam DOM referansını sağlarsınız. Örneğin, nesneniz pageTracker olarak adlandırılırsa kodunuzdaki söz konusu nesneye window.pageTracker olarak başvurursunuz. Örneğin, aşağıdaki kod snippet'i ActionScript 3 ile Adobe Flex ortamı kullanılarak nasıl yapılandırılacağını gösterir:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Alternatif yöntem. Sayfanızda sayfa izleme nesnesi oluşturmadıysanız web mülkü kimliğinizi iletmeniz yeterlidir; sizin için bir JavaScript izleme kodu nesnesi oluşturulur. Bu yöntemle, HTML sayfanızda temel ga.js JavaScript kaynak dosyasına başvuruda bulunmak da gerekir. Aşağıdaki kod snippet'i, ActionScript 3 ile Adobe Flex ortamı kullanılarak bunun nasıl yapılandırılacağını gösterir:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Köprü modunun düzgün çalışması için ExternalInterface.available, ActionScript 3 kodunuzda doğru olarak ayarlanmalıdır. Bu aynı zamanda, allowScriptAccess içeriğini Flash içeriğini yerleştiren HTML sayfasında always olarak ayarlanması gerektiği anlamına da 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>

Başa Dön

AS3 Modu

Adobe Flash ActionScript 3 kodunu kontrol ediyor ancak Adobe Flash uygulamanızın barındırma ortamını kontrol etmiyorsanız bu modu kullanın. Örneğin, birçok sitede 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 modla ayrı bir ga.js izleme kurulumuna gerek yoktur. Ayrıca 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ğerine ayarlanır.

Sorun Giderme ve Doğrulama

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

Örnekler

Farklı geliştirme ortamlarında izlemeyi uygulama hakkında ayrıntılı örnekler için aşağıdaki konulara bakın:

Flaş

Esnek

Sürüm oluşturma

ZIP dosyası olarak izleme bileşenlerinin en son sürümünü http://code.google.com/p/gaforFlash/downloads/list adresinde bulabilirsiniz. Her indirme işlemi, ilgili belgelerin yanı sıra tüm izleme bileşenlerini içerir. İndirilen dosyanın dosya adı, içerdiği kodun sürüm numarasını gösterir.

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

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

Başa Dön