Konfiguracja Adobe Flash

Niniejszy dokument zawiera wszystkie informacje potrzebne do skonfigurowania śledzenia Google Analytics dla programu Adobe Flash w środowisku programistycznym Adobe Flash.

Pobierz pliki komponentu

Pliki komponentu śledzenia Flash są kompresowane w pojedynczym pliku ZIP, który można pobrać ze strony http://code.google.com/p/gaforflash/downloads/list.

Postępuj zgodnie z instrukcjami zawartymi w pliku readme.txt, by zainstalować komponenty Flash.

1. Jeśli masz otwarty Adobe Flash CS3, zamknij aplikację.
2. Utwórz katalog Google w jednej z tych lokalizacji:
   • W systemie Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. Przejdź do lokalizacji, w której rozpakowano plik ZIP komponentu, i skopiuj te pliki do katalogu utworzonego w poprzednim kroku:
   • lib/analytics_flash.swc – komponent Analytics
   • lib/analytics.swc – składnik biblioteki Analytics

Oba komponenty mają takie same funkcje, ale zapewniamy wygodę przy korzystaniu z różnych stylów programowania.

Komponent Analytics. Użyj tego komponentu, jeśli tworzysz treści we Flashu, ale nie znasz języka JavaScript 3. Komponent Analytics to kompletny pakiet śledzenia. Wystarczy przeciągnąć komponenty i upuścić je bezpośrednio na scenie, wprowadzić kilka prostych konfiguracji w inspektorze komponentów i gotowe dodać tagi śledzenia Analytics.

Komponent AnalyticsLibrary. Jeśli znasz język JavaScript 3, możesz użyć komponentu AnalyticLibrary. Przeciągnij komponent do biblioteki Flash i zaimportuj klasy śledzenia bezpośrednio do kodu JavaScript.

Korzystanie z komponentu Analytics

Użyj komponentu analytics_flash.swc, aby zaimplementować śledzenie za pomocą komponentu Analytics. Umieść komponent w odpowiednim katalogu komponentów. Pojawi się on w panelu Komponenty (Okno – Komponenty).

1. Przeciągnij komponent na scenę i nadaj mu nazwę instancji w oknie Właściwości.
2. Skonfiguruj komponent w panelu Inspektora komponentów (Windows – Inspektor komponentów):
   • Dodaj identyfikator usługi internetowej Analytics.
   • Wybierz tryb Bridge (most) lub AS3 (AS3).
   • Określ, czy debugowanie wizualne jest włączone czy wyłączone.
3. W kodzie JavaScript dodaj standardowe wywołania śledzenia GA do wystąpienia utworzonego właśnie komponentu.

Ze względu na sposób współpracy Flasha z komponentami wizualnymi śledzenie najlepiej jest rozpocząć od drugiej klatki aplikacji Flash. Jeśli musisz zainicjować śledzenie w pierwszej ramce, umieść wywołania śledzenia w modułach obsługi zdarzeń, by mieć pewność, że komponent zostanie w pełni zainicjowany w treści Flash.

Przykład prostego komponentu Flash Analytics

Poniższy fragment kodu pokazuje, jak można śledzić kliknięcie przycisku we Flashu przez użytkownika. W tym przykładzie wystąpienie przycisku nosi nazwę playGame w języku JavaScript. Po kliknięciu przycisku wywoływana jest metoda onButtonClick, która z kolei wywołuje metodę trackPageview(). Powoduje to zwiększenie liczby odsłon wirtualnej strony /myGame1.

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

Powrót do góry

Korzystanie z komponentu AnalyticsLibrary

Użyj pliku analytics.swc, by wdrożyć śledzenie za pomocą komponentu AnalyticsLibrary. Ten komponent umożliwia utworzenie instancji obiektu śledzenia bezpośrednio w kodzie AS3. Gdy komponent AnalyticsLibrary znajdzie się w prawidłowym miejscu, pojawi się w panelu Komponenty. Następnie możesz przeciągnąć komponent z panelu Komponenty do biblioteki, a stamtąd zaimportować biblioteki do kodu JavaScript.

Inicjowanie obiektu śledzenia

W środowisku Adobe Flash zainicjuj obiekt śledzenia za pomocą następujących parametrów:

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

Przykład prostej biblioteki Analytics

W poniższym przykładzie na scenie znajduje się klip filmowy o nazwie playGame. Zostanie utworzony nowy obiekt śledzenia o nazwie tracker wraz z modułem obsługi zdarzeń, który nasłuchuje kliknięcia myszą. Kliknięcie przycisku powoduje wywołanie funkcji onButtonClick. W przypadku każdego kliknięcia metoda trackPageview() zwiększa liczbę odsłon wirtualnej strony /myGame1.

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");
} 

Powrót do góry