Adobe Flash einrichten

Dieses Dokument enthält alles, was Sie wissen müssen, um Google Analytics-Tracking für Adobe Flash für die Adobe Flash-Entwicklungsumgebung einzurichten.

Komponentendateien abrufen

Die Dateien der Flash-Tracking-Komponenten werden in einer einzelnen ZIP-Datei komprimiert, die Sie unter http://code.google.com/p/gaforflash/downloads/list herunterladen können.

Folgen Sie der Anleitung in der Datei readme.txt, um die Flash-Komponenten zu installieren.

  1. Falls Adobe Flash CS3 geöffnet ist, schließen Sie das Programm.
  2. Erstellen Sie an einem der folgenden Speicherorte ein Google-Verzeichnis:
    • Für Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • Für Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. Gehen Sie zu dem Speicherort, an dem Sie die ZIP-Datei der Komponente entpackt haben, und kopieren Sie die folgenden Dateien in das Verzeichnis, das Sie im vorherigen Schritt erstellt haben:
    • lib/analytics_flash.swc – die Analytics-Komponente
    • lib/analytics.swc – die Analytics-Bibliothekskomponente

Beide Komponenten verfügen über die gleiche Funktionalität, werden aber der Einfachheit halber für verschiedene Entwicklungsstile bereitgestellt.

Analytics-Komponente: Verwenden Sie diese Komponente, wenn Sie Flash-Inhalte entwickeln, aber nicht mit Flash 3 vertraut sind. Die Analytics-Komponente stellt ein umfassendes Tracking-Paket dar. Ziehen Sie die Komponenten einfach per Drag-and-drop in den Anzeigebereich und nehmen Sie im Komponentenprüftool ein paar einfache Konfigurationen vor. Dann können Sie Ihre Steuerelemente mit Analytics-Tracking versehen.

AnalyticsLibrary-Komponente Wenn Sie mit ActionScript 3 vertraut sind, können Sie die AnalyticLibrary-Komponente verwenden. Ziehen Sie die Komponente in Ihre Flash-Bibliothek und importieren Sie die Tracking-Klassen direkt in Ihren Action-ActionScript-Code.

Verwenden der Analytics-Komponente

Verwenden Sie analytics_flash.swc, um das Tracking über die Analytics-Komponente zu implementieren. Platzieren Sie die Komponente im richtigen Komponentenverzeichnis. Sie wird dann im Bereich „Komponenten“ (Fenster – Komponenten) angezeigt.

  1. Ziehen Sie die Komponente in den Anzeigebereich und geben Sie ihr im Dialogfeld Eigenschaften einen Instanznamen.
  2. Konfigurieren Sie die Komponente im Bereich „Komponentenprüftool“ (Windows – Komponentenprüftool):
    • Fügen Sie Ihre Analytics-Web-Property-ID hinzu.
    • Wählen Sie entweder den Bridge-Modus oder den AS3-Modus aus.
    • Gibt an, ob die visuelle Fehlerbehebung aktiviert oder deaktiviert ist.
  3. Fügen Sie der Instanz der soeben erstellten Komponente im Action-Code-Code die standardmäßigen Google Analytics-Tracking-Aufrufe hinzu.

Aufgrund der Funktionsweise von Flash mit visuellen Komponenten ist es im Allgemeinen am besten, mit dem Tracking mit dem zweiten Frame Ihrer Flash-Anwendung zu beginnen. Wenn Sie das Tracking im ersten Frame initialisieren müssen, platzieren Sie die Tracking-Aufrufe in Event-Handlern, um sicherzustellen, dass die Komponente innerhalb des Flash-Contents vollständig initialisiert wird.

Beispiel für eine einfache Analytics-Flash-Komponente

Das folgende Code-Snippet zeigt, wie eine Schaltfläche in Flash erfasst werden kann, wenn ein Nutzer darauf klickt. In diesem Beispiel heißt die Schaltflächeninstanz playGame in Ihrem ActionScript. Wenn auf die Schaltfläche geklickt wird, wird die Methode onButtonClick aufgerufen, die wiederum die Methode trackPageview() aufruft. Dadurch wird die Anzahl der Seitenaufrufe für die virtuelle Seite /myGame1 erhöht.

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

Verwenden der AnalyticsLibrary-Komponente

Verwenden Sie die Datei analytics.swc, um das Tracking über die AnalyticsLibrary-Komponente zu implementieren. Mit dieser Komponente können Sie ein Tracking-Objekt direkt in Ihrem AS3-Code instanziieren. Sobald sich die AnalyticsLibrary-Komponente an der richtigen Stelle befindet, wird sie im Bereich "Komponenten" angezeigt. Anschließend können Sie die Komponente aus dem Bereich "Komponenten" in Ihre Bibliothek ziehen und die Bibliotheken von dort in Ihren Action-ActionScript-Code importieren.

Tracking-Objekt initialisieren

Initialisieren Sie das Tracking-Objekt in der Adobe Flash-Umgebung mit den folgenden Parametern:

  • Auf das aktuelle Anzeigeobjekt verweisen Im folgenden Beispiel verweist this auf das Anzeigeobjekt.
  • Die Web-Property-ID Die Web-Property-ID ist die eindeutige Zeichenfolge, mit der Aktivitäten in Bezug auf Flash-Inhalte erfasst und an die richtige Datenansicht (Profil) in Ihrem Analytics-Konto gesendet werden.
  • Tracking-Modus: Gültige Parameter sind Bridge und AS3.
  • Debug-Modus: Legen Sie debug für die Produktionsnutzung auf false und für die Validierung und Fehlerbehebung auf true fest.

Ein einfaches AnalyticsLibrary-Beispiel

Im folgenden Beispiel ist ein Movie-Clip mit dem Namen „playGame“ auf dem Anzeigebereich vorhanden. Ein neues Tracking-Objekt namens tracker wird zusammen mit einem Event-Handler erstellt, der auf Mausklicks wartet. Wenn auf die Schaltfläche geklickt wird, wird die Funktion onButtonClick aufgerufen. Bei jedem Klick erhöht die Methode trackPageview() die Anzahl der Seitenaufrufe für die virtuelle Seite /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");
}