Śledzenie Google Analytics dla Adobe Flash

Komponent Google Analytics Tracking dla Adobe Flash ułatwia wdrożenie Google Analytics w treściach Flash. Ten komponent, stworzony przez Adobe Systems, Inc., zawiera wszystkie funkcje kodu JavaScript Google Analytics. Komponent śledzenia Flash jest skompilowanym obiektem śledzenia natywnym w języku JavaScript 3, dzięki czemu implementacja Analytics jest intuicyjna w środowiskach programistycznych Flash i Flex.

Dlaczego warto używać śledzenia elementów Flash?

Bez funkcji śledzenia Google Analytics dla programu Adobe Flash śledzenie treści Adobe Flash za pomocą Google Analytics wiąże się z szeregiem przeszkód technicznych. Najpierw musisz utworzyć interfejs niestandardowy dla ga.js, tak aby aplikacja Flash mogła wykonywać odpowiednią metodę Analytics, taką jak trackPageview() lub trackEvent(). Musisz też przewidzieć, czy Twoje treści Flash będą miały dostęp do przeglądarki Document Object Model (DOM), ponieważ śledzenie nie powiedzie się w przypadku tych obiektów, w przypadku których dostęp do DOM jest odmówiony (zwykle wtedy, gdy Twoje treści znajdują się w witrynach innych firm). Obejmuje to umiejętność wykorzystania wywołania ExternalInterface w języku JavaScript 3 w celu uzyskania dostępu do modelu DOM przeglądarki i pogorszenia działania aplikacji w przypadku odmowy dostępu.

Składnik Google Analytics dla programu Adobe Flash upraszcza śledzenie obiektów Flash i świetnie radzi sobie z dostępem modelu DOM. Jest on przydatny do wielu często używanych celów śledzenia we Flashu, takich jak:

wbudowany widżet Flash na stronie HTML;
samodzielna aplikacja Flex lub witryna oparta jedynie na technologii Flash, przechowywana na stronie HTML;
rozproszona gra lub program Flex/Flash, w którym programista nie ma żadnego wpływu na to, gdzie zostanie umieszczony widżet.

Pamiętaj, że aplikacje śledzące we Flashu mają pewne różnice w strukturze niż aplikacje śledzące strony witryny. Znajomość funkcji śledzenia Analytics jest niezbędna do zrozumienia, jak działa ta wtyczka. Możesz również wyświetlić dokumentację projektowania tego projektu, aby uzyskać szczegółowe informacje o tym, jak został przeniesiony model śledzenia Analytics dla tego komponentu.

Uwaga: obecnie śledzenie Flash jest dostępne dla wszystkich treści Flash umieszczonych na stronach internetowych. Śledzenie danych wysyłanych z Adobe Air, Shockwave lub przez IDE Flash (np. za pomocą filmu testowego) nie jest obecnie obsługiwane.

Obsługiwane środowiska programistyczne

Śledzenie Analytics dla Flasha możesz utworzyć w środowisku Adobe Flash lub Adobe Flex. Każde środowisko wymaga innego komponentu, który możesz pobrać ze strony http://code.google.com/p/gaforflash/. Komponenty te działają na bazie kodu Action 3 i możesz je skonfigurować w każdym środowisku na jeden z dwóch sposobów:

W Adobe Flash

Dodaj i skonfiguruj prosty komponent w inspektorze komponentów, a następnie przeciągnij go na scenę.
Zaimportuj biblioteki śledzenia Flash bezpośrednio do biblioteki i zacznij kodować.

W Adobe Flex

Dołącz komponent MXML konfigurowany na podstawie pliku am MXML.
Zaimportuj biblioteki śledzenia Flash do tagów skryptu lub plików AS3.

Powrót do góry

Jak działa dany komponent?

Aby użyć w środowisku komponentu śledzenia Flash, musisz użyć narzędzi wizualnych we Flashu lub skonfigurować obiekt śledzenia bezpośrednio w kodzie. Niezależnie od tego, czy konfigurujesz komponent wizualnie, czy za pomocą kodu, musisz zapewnić te elementy:

identyfikator usługi internetowej – jest on również nazywany numerem UA kodu śledzenia i wygląda tak: UA-xxxxx-yy, gdzie znaki x i y są zastępowane liczbami odpowiadającymi Twoim kontu i informacjom o widoku (profilu) śledzonego obiektu. Więcej informacji można znaleźć na stronie Usługa internetowa.
tryb śledzenia – wybierz tryb mostka lub AS3. Ten tryb określa sposób, w jaki śledzenie komunikuje się z serwerami Analytics, i został szczegółowo opisany poniżej.
tryb debugowania – niezależnie od używanego środowiska i trybu śledzenia możesz włączyć debugowanie, aby sprawdzić i przetestować śledzenie.

Tryby śledzenia

W zależności od sposobu rozpowszechniania treści Flash komponent Analytics dla Flash komunikuje się z serwerami Analytics przez połączenie komunikacji między treściami Flash w istniejącej instalacji śledzącej Analytics lub bezpośrednio z serwerami Analytics. Te dwa tryby są nazywane odpowiednio trybem mostka i trybem AS3. Oba tryby wykorzystują tę samą funkcję śledzenia Analytics, a przełączanie aplikacji Flash z jednego trybu do drugiego jest proste. Oprócz wyboru trybu komunikacji na potrzeby śledzenia Analytics możesz też korzystać z trybu debugowania, aby rozwiązywać problemy ze śledzeniem lub sprawdzać jego poprawność.

Aby śledzenie kampanii działało, w obu trybach parametr allowscriptaccess musi mieć wartość always. Włącza on dostęp w trybie odczytu do adresu URL strony i informacji o stronie odsyłającej, które są wymagane przez kod śledzenia Flash. Bez allowscriptaccess kod śledzenia Analytics działa z łatwością. Nadal dostarcza większość danych o aktywności użytkowników, ale nie ma potwierdzenia w modelu atrybucji kampanii w Google Analytics.

Tryb przejściowy

Skorzystaj z tego trybu, jeśli kontrolujesz zarówno stronę HTML, jak i zawartość Flash. Ten tryb jest najlepszym wyborem, jeśli masz już zaimplementowane śledzenie Google Analytics (ga.js) w swojej witrynie i chcesz dodać śledzenie do umieszczonych treści Flash. Tryb mostka upraszcza komunikację między Flashem a JavaScriptem, udostępniając w kodzie ga.js jednolity interfejs JavaScript 3. Zapewnia połączenie pomiędzy wywołaniami kodu JavaScript 3 a skryptem JavaScript Analytics, by śledzenie działało.

Połączenie z kodem śledzenia Google Analytics można skonfigurować za pomocą parametru identyfikatora usługi internetowej na jeden z dwóch sposobów:

Najczęstsza metoda. Obiekt kodu śledzenia Google Analytics już istnieje na Twojej stronie pod własną nazwą, np. pageTracker. W takim przypadku podajesz pełne odniesienie DOM do obiektu śledzenia. Jeśli na przykład obiekt nazywa się pageTracker, możesz odwoływać się do niego w kodzie jako window.pageTracker. Na przykład ten fragment kodu pokazuje, jak należy skonfigurować środowisko, korzystając ze środowiska Adobe Flex z ActionScript 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Metoda alternatywna. Jeśli nie masz na stronie obiektu śledzenia strony, możesz przekazać identyfikator usługi internetowej, a zostanie utworzony obiekt kodu śledzenia JavaScript. W przypadku tej metody na stronie HTML nadal wymagane jest odniesienie do podstawowego pliku źródłowego JavaScriptu ga.js. Ten fragment kodu pokazuje, jak to wygląda w środowisku Adobe Flex z ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Aby tryb mostka działał prawidłowo, w kodzie w Scripcie 3 ExternalInterface.available musi mieć wartość Prawda. Oznacza to też, że na stronie HTML, która zawiera treści Flash, właściwość allowScriptAccess powinna mieć wartość always. Poniższy przykład przedstawia kod HTML skonfigurowany pod kątem trybu mostka:

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

Powrót do góry

Tryb AS3

Użyj tego trybu, jeśli kontrolujesz kod Adobe Flash Action w języku Adobe Flash 3, ale nie masz wpływu na środowisko, w którym jest przechowywana aplikacja Adobe Flash. Jeśli tworzysz na przykład treści Flash do dystrybucji w wielu witrynach, użyj trybu AS3. Tryb AS3 jest całkowicie niezależny od kodu śledzenia ga.js i zawiera wszystkie funkcje śledzenia Analytics. W tym trybie nie jest potrzebna osobna instalacja śledzenia ga.js. Dodatkowo tryb AS3 używa mechanizmu pamięci Flash do śledzenia informacji o sesji użytkownika.

W przypadku niektórych parametrów DOM, takich jak język, komponent AS3 próbuje pobrać wartości z przeglądarki. Jeśli wartości nie są podane, komponent używa równoważnej wartości Flash lub domyślnie przyjmuje wartość no.

Rozwiązywanie problemów i weryfikacja

Komponent Google Analytics Tracking for Adobe Flash udostępnia tryb debugowania, który upraszcza weryfikację i rozwiązywanie problemów. Gdy ta opcja jest włączona, wszystkie dane śledzenia są przechwytywane i kierowane na ekran w polu tekstowym zamiast na serwery Analytics. W tym trybie są widoczne dane w czasie rzeczywistym, które serwer zbierałby. Ta funkcja pomaga też przechowywać dane testowe poza danymi produkcyjnymi. Aby włączyć funkcję rozwiązywania problemów, ustaw opcję visualDebug na true w inspektorze komponentów.

Przykłady

Szczegółowe przykłady wdrażania śledzenia w różnych środowiskach programistycznych znajdziesz tutaj:

lampa błyskowa,

Flex

Obsługa wersji

Najnowsza wersja komponentów śledzenia jest dostępna w postaci pliku ZIP na stronie http://code.google.com/p/gaforflash/downloads/list. Każdy pobrany plik zawiera wszystkie komponenty śledzenia oraz powiązaną dokumentację. W nazwie pobieranego pliku pojawi się numer wersji zawartego w nim kodu.

Możesz też użyć poniższych instrukcji w kodzie, aby wydrukować numer bieżącej wersji komponentu w konsoli wyników.

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

Powrót do góry