Google Analytics-Tracking für Adobe Flash

Mit der Komponente „Google Analytics-Tracking für Adobe Flash“ können Sie Google Analytics ganz einfach in Ihren Flash-basierten Content implementieren. Diese von Adobe Systems Inc. entwickelte Komponente enthält alle Funktionen des Google Analytics-JavaScript-Codes. Die Flash-Tracking-Komponente ist ein kompiliertes, kompiliertes Tracking-Objekt von ActionScript 3, das eine intuitive Analytics-Implementierung in Flash- und Flex-Entwicklungsumgebungen ermöglicht.

Die Software für diese Komponente wurde von Adobe Systems Inc. entwickelt und unterstützt. Google macht keine Zusagen und gibt keine Zusicherungen in Bezug auf Leistung, Qualität oder Inhalt. Wenn Sie als Entwickler Interesse an einem Beitrag zu dem Projekt haben, besuchen Sie die Startseite des Projekts http://code.google.com/p/gaforflash/.

Vorteile von Flash-Tracking

Ohne die Komponente für das Google Analytics-Tracking für Adobe Flash erfordert das Tracking von Adobe Flash-Inhalten mit Google Analytics einige technische Hürden. Zuerst müssen Sie eine benutzerdefinierte Schnittstelle für ga.js entwickeln, damit Ihre Flash-Anwendung die entsprechende Analytics-Methode (z. B. trackPageview() oder trackEvent()) ausführen kann. Darüber hinaus müssen Sie voraussetzen, ob Ihr Flash-Inhalt Zugriff auf das Document Object Model (DOM) des Browsers haben wird, da die Verfolgung für die Objekte fehlschlägt, bei denen der Zugriff auf das DOM verweigert wird (in der Regel, wenn sich Ihr Inhalt auf Websites von Drittanbietern befindet). Dazu müssen Sie wissen, wie der ExternalInterface-Aufruf in Action Script 3 verwendet wird, um auf das Browser-DOM zuzugreifen und die Technologie herabzustufen, wenn der Zugriff verweigert wird.

Die Adobe Flash-Komponente von Google Analytics vereinfacht das Tracking Ihres Flash-Inhalts und sorgt für einen problemlosen DOM-Zugriff. Dies ist für eine Reihe gängiger Tracking-Zwecke in Flash nützlich, wie etwa:

• einem eingebetteten Flash-Widget auf einer HTML-Seite,
• einer unabhängigen Flex-Anwendung oder einer Nur-Flash-Seite, die auf einer HTML-Seite gehostet wird, oder
• einem bereitgestellten Flex- oder Flash-Spiel oder -Programm, bei dem der Entwickler keinen Einfluss darauf hat, wo das Widget platziert wird.

Beachten Sie, dass das Tracking von Anwendungen in Flash im Vergleich zum Tracking von Website-Seiten einige strukturelle Unterschiede aufweist. Grundkenntnisse in Analytics-Tracking sind Voraussetzung für das Verständnis des Plug-ins. Ausführliche Informationen dazu, wie das Analytics-Tracking-Modell für diese Komponente übertragen wurde, können Sie auch in der Designdokumentation für dieses Projekt nachlesen.

Hinweis: Derzeit steht Flash-Tracking für jeglichen Flash-Content zur Verfügung, der auf einer Webseite eingebettet ist. Das Tracking von Daten, die von Adobe Air, Shockwave oder über die Flash-IDE (z.B. mit Test Movie) gesendet werden, wird derzeit nicht unterstützt.

Unterstützte Entwicklungsumgebung

Analytics-Tracking für Flash kann entweder in Adobe Flash- oder Adobe Flex-Umgebungen entwickelt werden. Für jede Umgebung ist eine andere Komponente erforderlich, die Sie unter http://code.google.com/p/gaforflash/ herunterladen können. Diese Komponenten basieren auf ActionScript 3 und können für jede Umgebung auf eine von zwei Arten eingerichtet werden:

In Adobe Flash

• Fügen Sie dem Komponentenprüftool eine einfache Komponente hinzu, konfigurieren Sie sie und ziehen Sie sie in den Anzeigebereich.
• Importieren Sie die Flash-Tracking-Bibliotheken direkt in Ihre Bibliothek und beginnen Sie mit dem Coding.

In Adobe Flex

• Fügen Sie eine MXML-Komponente hinzu, die Sie anhand einer MXML-Datei konfigurieren.
• Importieren Sie die Flash-Tracking-Bibliotheken in Ihre Skript-Tags/AS3-Dateien.

Zurück nach oben

Wie funktioniert die Komponente?

Zur Verwendung der Flash-Tracking-Komponente in Ihrer Umgebung können Sie entweder die visuellen Tools in Flash verwenden oder das Tracking-Objekt direkt in Ihrem Code einrichten. Unabhängig davon, ob Sie die Komponente visuell oder über Code einrichten, stellen Sie die folgenden Elemente bereit:

• Web-Property-ID: Diese ID ist auch als UA-Nummer des Tracking-Codes bekannt und sieht so aus: UA-xxxxx-yy. Das x- und das y-Zeichen werden durch die Ziffern ersetzt, die den Konto- und Datenansichtsinformationen bzw. Profilinformationen des erfassten Objekts entsprechen. Weitere Informationen finden Sie unter Web-Property.
• Tracking-Modus: Wählen Sie entweder den Bridge-Modus oder den AS3-Modus aus. Dieser Modus bestimmt, wie das Tracking mit den Analytics-Servern kommuniziert. Dieser Modus wird unten ausführlich beschrieben.
• Fehlerbehebungsmodus: Unabhängig von der Umgebung oder dem Tracking-Modus können Sie die Fehlerbehebung aktivieren, um das Tracking zu validieren und zu testen.

Tracking-Modi

Je nachdem, wie Sie Ihren Flash-Content verteilen, kommuniziert die Analytics für Flash-Komponente mit den Analytics-Servern entweder durch eine Verbindung zwischen den Flash-Inhalten in einer vorhandenen Analytics-Tracking-Installation oder durch direkte Kommunikation mit den Analytics-Servern. Diese beiden Modi heißen Bridge-Modus bzw. AS3-Modus. Beide Modi nutzen dieselbe Analytics-Tracking-Funktion, und Sie können in Ihrer Flash-Anwendung leicht von einem Modus in den anderen wechseln. Sie können nicht nur einen Kommunikationsmodus für das Analytics-Tracking auswählen, sondern auch einen Debug-Modus verwenden, um Fehler zu beheben oder das Tracking zu validieren.

In beiden Modi muss allowscriptaccess gleich always sein, damit das Kampagnen-Tracking funktioniert. Dieser Parameter aktiviert den Lesezugriff auf die URL der Seite und die Verweis-URL-Informationen, die für den Flash-Tracking-Code erforderlich sind. Ohne allowscriptaccess wird der Analytics-Tracking-Code ordnungsgemäß beeinträchtigt. Sie liefert weiterhin die meisten Daten zur Nutzeraktivität, kann jedoch nicht auf das Attributionsmodell der Google Analytics-Kampagne angewendet werden.

Bridge-Modus

Verwenden Sie diesen Modus, wenn Sie sowohl die HTML-Seite als auch den Flash-Content steuern. Dieser Modus eignet sich am besten, wenn Sie das Google Analytics-Tracking (ga.js) auf Ihrer Website bereits implementiert haben und Tracking zu eingebetteten Flash-Inhalten hinzufügen möchten. Der Bridge-Modus vereinfacht die Kommunikation zwischen Flash-zu-JavaScript-Code, indem er eine einheitliche JavaScript 3-Schnittstelle für den ga.js-Code bereitstellt. Damit das Tracking funktioniert, stellt es die Verbindung zwischen den JavaScript 3-Aufrufen von Analytics und dem Analytics-JavaScript her.

Sie haben zwei Möglichkeiten, die Verbindung mit dem Google Analytics-Tracking-Code über den Parameter für die Web-Property-ID zu konfigurieren:

• Häufigste Methode: Das Google Analytics-Tracking-Code-Objekt ist auf Ihrer Seite bereits mit einem eigenen Namen vorhanden, z. B. pageTracker. In diesem Fall stellen Sie den vollständigen DOM-Verweis auf das Tracking-Objekt bereit. Wenn Ihr Objekt beispielsweise pageTracker heißt, verweisen Sie in Ihrem Code mit window.pageTracker auf dieses Objekt. Das folgende Code-Snippet zeigt beispielsweise, wie dies in der Adobe Flex-Umgebung mit Adobe Script 3 konfiguriert werden würde:

  tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  
  
• Alternative Methode. Falls Sie auf Ihrer Seite kein Seiten-Tracking-Objekt erstellt haben, können Sie einfach Ihre Web-Property-ID übergeben. Daraufhin wird ein JavaScript-Tracking-Code-Objekt für Sie erstellt. Bei dieser Methode ist auf der HTML-Seite weiterhin ein Verweis auf die Basis-JavaScript-Quelldatei ga.js erforderlich. Das folgende Code-Snippet zeigt, wie dies in der Adobe Flex-Umgebung mit Adobe Script 3 konfiguriert werden würde:

  tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Damit der Bridge-Modus ordnungsgemäß funktioniert, muss ExternalInterface.available in Ihrem JavaScript 3-Code auf "true" gesetzt sein. Das bedeutet auch, dass allowScriptAccess auf der HTML-Seite, auf der die Flash-Inhalte eingebettet sind, auf always gesetzt werden sollte. Das folgende Beispiel zeigt den für den Bridge-Modus konfigurierten HTML-Code:

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

 

Zurück nach oben

AS3-Modus

Verwenden Sie diesen Modus, wenn Sie den Adobe Flash-ActionScript 3-Code, aber nicht die Hosting-Umgebung Ihrer Adobe Flash-Anwendung steuern. Wenn Sie beispielsweise Flash-Inhalte zur Verteilung über viele Websites entwickeln, verwenden Sie den AS3-Modus. Der AS3-Modus ist völlig unabhängig vom ga.js-Tracking-Code und enthält alle Tracking-Funktionen von Analytics. Bei diesem Modus ist keine separate ga.js-Tracking-Installation erforderlich. Darüber hinaus verwendet der AS3-Modus den Flash-Speichermechanismus, um Sitzungsinformationen für den Nutzer zu verfolgen.

Bei bestimmten DOM-Parametern wie der Sprache versucht die AS3-Komponente, die Werte aus dem Browser abzurufen. Wenn die Werte nicht vorhanden sind, verwendet die Komponente entweder den entsprechenden Flash-Wert oder verwendet standardmäßig no.

Fehlerbehebung und Validierung

Die Komponente "Google Analytics-Tracking für Adobe Flash" bietet einen Debug-Modus zur Vereinfachung der Validierung und Fehlerbehebung. Wenn diese Option aktiviert ist, werden alle Tracking-Daten abgefangen und an einen Bildschirm in einem Textfeld statt an die Analytics-Server weitergeleitet. In diesem Modus können Sie die Daten, die sonst vom Server erfasst werden, in Echtzeit sehen. Diese Funktion trägt auch dazu bei, dass Testdaten außerhalb Ihrer Produktionsdaten bleiben. Sie können die Funktion zur Fehlerbehebung aktivieren, indem Sie die Option visualDebug im Komponentenprüftool auf true setzen.

Beispiele

Detaillierte Beispiele für die Implementierung des Trackings in den verschiedenen Entwicklungsumgebungen finden Sie hier:

Blitz

• Die Analytics-Komponente in Flash verwenden
• AnalyticsLibrary-Komponente in Flash verwenden

Flex

• Beispiel für eine Flex-MXML-Komponente
• Beispiel für ein Flex-Script 3
  

Versionsverwaltung

Die neueste Version der Tracking-Komponenten als ZIP-Datei finden Sie unter http://code.google.com/p/gaforflash/downloads/list. Jeder Download enthält alle Tracking-Komponenten sowie die zugehörige Dokumentation. Der Dateiname für die Downloaddatei zeigt die Versionsnummer des darin enthaltenen Codes an.

Sie können auch die folgenden Anweisungen in Ihrem Code verwenden, um die aktuelle Versionsnummer der Komponente in der Ausgabekonsole auszugeben.

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

 

Zurück nach oben