Konfiguracja Adobe Flex

Ten dokument zawiera wszystkie informacje potrzebne do skonfigurowania śledzenia Google Analytics dla programu Adobe Flash na potrzeby środowiska programistycznego Adobe Flex.

Pobieranie biblioteki śledzenia

Pobierz kod (w formacie ZIP) ze strony http://code.google.com/p/gaforflash/downloads/list. Postępuj zgodnie z instrukcjami w pliku readme.txt, aby zainstalować komponent Flex. W przeciwieństwie do komponentów Flash Analytics w pobranym pliku jest tylko jeden plik biblioteki: /lib/analytics_flex.swc.

Dodaj kod do projektu

Zanim zaczniesz korzystać z kodu śledzenia w projekcie, musisz połączyć pobrany plik SWC jako zasób projektu.

1. Kliknij Projekt -> Właściwości. Pojawi się okno Właściwości projektu.
2. Kliknij Flex Build Path (Ścieżka kompilacji Flex) i wybierz kartę Library Path (Ścieżka do biblioteki).
3. W panelu Ścieżka biblioteki kliknij Add SWC... (Dodaj rozszerzenie SWC). Pojawi się okno Dodaj SWC.
4. Przejdź do lokalizacji, z której rozpakowano interfejs Google Analytics API, wybierz plik lib/analytics.swc i kliknij OK.
   Możesz też po prostu przeciągnąć plik analytics.swc do katalogu /libs projektu Flex.

Powrót do góry

Przykład komponentu MXML Flex

Poniższy przykład pokazuje, jak skonfigurować śledzenie przycisku w pliku MXML. Aby zainicjować komponent MXML, wykonaj te czynności:

• Ustaw parametr XML przestrzeni nazw. Ustaw parametr przestrzeni nazw XML obiektu śledzenia w ten sposób: xmlns:analytics="com.google.analytics.components.*"
• Ustaw nazwę obiektu. W poniższym przykładzie parametr id jest ustawiony na tracker.
• Jako identyfikatora usługi internetowej użyj parametru account. Identyfikator usługi internetowej to unikalny ciąg znaków używany do śledzenia aktywności związanej z treściami Flash i przesyłania ich do odpowiedniego widoku (profilu) na koncie Analytics.
• Ustaw tryb śledzenia za pomocą parametru mode. Użyj Bridge jako parametru, jeśli tworzysz plik MXML i chcesz łatwo wdrożyć śledzenie. Użyj języka AS3, jeśli potrafisz kodować w języku JavaScript3. Tryb AS3 umożliwia importowanie wszystkich klas śledzenia Google Analytics, z których można tworzyć i konfigurować własne obiekty śledzenia.
• Ustaw tryb debugowania za pomocą parametru visualDebug. Użyj opcji true, aby włączyć debugowanie i weryfikację programu. W przeciwnym razie ustaw wartość false na potrzeby środowiska produkcyjnego.

W przykładzie do sceny został dodany przycisk mybutton. Komponent śledzenia Flex jest utworzony o nazwie tracker i skonfigurowany przy użyciu swoich parametrów. Na koniec do aplikacji mybutton zostaje dodane zdarzenie kliknięcia onButtonClick. Po kliknięciu przycisku wartość /hello world wirtualnej odsłony zwiększa się o jedną liczbę.

<?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>

Powrót do góry

Przykład aplikacji Flex Action 3

W bardziej złożonych sytuacjach zalecane jest wywoływanie natywnych klas śledzenia ActionScripcie bezpośrednio z plików zasobów ActionScripcie. Chociaż ten przykład jest również plikiem MXML, całe tworzenie instancji śledzenia odbywa się w tagach <MX:script>. W ten sam sposób można dodać śledzenie do innych projektów w języku Action 3.

W tym przykładzie do sceny został dodany przycisk mybutton. W tagach skryptu importowane są 2 biblioteki:

com.google.analytics.GATracker; //this is the actual tracking class
com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements

Po zaimportowaniu bibliotek tworzona jest zmienna śledzenia tracker. Po dodaniu aplikacji do sceny wywoływany jest obiekt onComplete, który tworzy instancję obiektu śledzenia. Cztery parametry potrzebne do utworzenia instancji obiektu GATracker to:

• Odwołaj się do bieżącego obiektu wyświetlanego. W poniższym przykładzie atrybut this odwołuje się do obiektu wyświetlanego.
• Identyfikator usługi internetowej. Identyfikator usługi internetowej to unikalny ciąg znaków używany do śledzenia aktywności związanej z treściami Flash i przesyłania ich do odpowiedniego widoku (profilu) na koncie Analytics.
• Tryb śledzenia. Prawidłowe parametry to Bridge lub AS3.
• Tryb debugowania. Ustaw debug na false w przypadku użycia w środowisku produkcyjnym oraz na true – do weryfikacji i rozwiązywania problemów.

Wreszcie w metodzie kliknięcia myButton funkcja onButtonClick śledzi wirtualną odsłonę w obiekcie śledzenia.

Gdy aplikacja jest uruchamiana, przy każdym kliknięciu przez użytkownika przycisku na stronie do serwerów śledzenia Google Analytics jest wysyłana wirtualna odsłona „hello world”.

<?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>

Powrót do góry