Configuration d'Adobe Flash

Ce document aborde tout ce que vous devez savoir pour configurer le suivi Google Analytics pour Adobe Flash dans l'environnement de développement Adobe Flash.

Obtenir les fichiers des composants

Les fichiers du composant de suivi Flash sont compressés dans un seul fichier ZIP que vous pouvez télécharger à l'adresse http://code.google.com/p/gaforflash/downloads/list.

Suivez les instructions du fichier readme.txt pour installer les composants Flash.

  1. Si Adobe Flash CS3 est actuellement ouvert, quittez l'application.
  2. Créez un répertoire Google à l'un des emplacements suivants :
    • Pour Windows : C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • Pour Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. Accédez à l'emplacement où vous avez décompressé le fichier ZIP du composant, puis copiez les fichiers suivants dans le répertoire que vous avez créé à l'étape précédente :
    • lib/analytics_flash.swc : composant Analytics
    • lib/analytics.swc : composant de la bibliothèque Analytics

Les deux composants ont les mêmes fonctionnalités, mais sont fournis pour plus de commodité dans des styles de développement différents.

Composant Analytics. Si vous développez du contenu Flash, mais que vous n'êtes pas familiarisé avec JavaScript 3, utilisez ce composant. Le composant Analytics est un package de suivi complet. Il vous suffit de glisser-déposer les composants directement dans l'espace de création, de définir quelques configurations simples dans l'inspecteur de composants, et vous êtes prêt à ajouter des balises à vos commandes avec le suivi Analytics.

Composant AnalyticsLibrary. Si vous connaissez bien JavaScript 3, vous pouvez utiliser le composant AnalyticLibrary. Faites glisser le composant dans votre bibliothèque Flash, puis importez les classes de suivi directement dans votre code ActionScript.

Utilisation du composant Analytics

Utilisez analytics_flash.swc pour implémenter le suivi via le composant Analytics. Placez le composant dans le répertoire "Composants" approprié. Il apparaît alors dans le panneau "Composants" (Fenêtre > Composants).

  1. Faites glisser le composant dans l'espace de création, puis attribuez-lui un nom d'instance dans la boîte de dialogue Propriétés.
  2. Configurez le composant dans le panneau de l'inspecteur de composants (Windows – Inspecteur de composants) :
    • Ajoutez votre ID de propriété Web Google Analytics.
    • Sélectionnez le mode Pont ou AS3.
    • Indique si le débogage visuel est activé ou désactivé.
  3. Dans votre code ActionScript, ajoutez les appels de suivi GA standard à l'instance du composant que vous venez de créer.

Compte tenu de la façon dont Flash fonctionne avec les composants visuels, il est généralement préférable de lancer le suivi sur le deuxième frame de votre application Flash. Si vous devez initialiser le suivi sur la première image, placez les appels de suivi dans les gestionnaires d'événements pour vous assurer que le composant est entièrement initialisé dans le contenu Flash.

Exemple simple de composant Flash Analytics

L'extrait de code suivant montre comment suivre un bouton dans Flash lorsqu'un internaute clique dessus. Dans cet exemple, l'instance du bouton est nommée playGame dans votre code ActionScript. Lorsque vous cliquez sur le bouton, la méthode onButtonClick est appelée, qui à son tour appelle la méthode trackPageview(). Cela augmente le nombre de pages vues pour la page virtuelle /myGame1.

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

Utiliser le composant AnalyticsLibrary

Utilisez le fichier analytics.swc pour implémenter le suivi via le composant AnalyticsLibrary. Ce composant vous permet d'instancier un objet de suivi directement dans le code AS3. Une fois que le composant AnalyticsLibrary se trouve au bon endroit, il apparaît dans le panneau "Composants". Vous pouvez ensuite faire glisser le composant vers votre bibliothèque à partir du panneau "Composants", puis importer les bibliothèques dans votre code ActionScript.

Initialiser l'objet de suivi

Dans l'environnement Adobe Flash, initialisez l'objet de suivi avec les paramètres suivants:

  • Référencer l'objet "affichage" actuel Dans l'exemple ci-dessous, this fait référence à l'objet display.
  • L'ID de propriété Web. L'ID de propriété Web est la chaîne unique utilisée pour effectuer le suivi de l'activité sur votre contenu Flash et l'afficher dans la vue (profil) appropriée de votre compte Google Analytics.
  • Mode de suivi : Les paramètres valides sont Bridge ou AS3.
  • Mode débogage : Définissez debug sur false pour une utilisation en production et sur true pour la validation et le dépannage.

Exemple simple d'AnalyticsLibrary

Dans l'exemple suivant, l'espace de création contient un extrait de film appelé playGame. Un objet de suivi appelé tracker est créé avec un gestionnaire d'événements qui écoute les clics de souris. Lorsque l'utilisateur clique sur le bouton, la fonction onButtonClick est appelée. Pour chaque clic, la méthode trackPageview() incrémente le nombre de pages vues pour la page virtuelle /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");
}