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.
- Si Adobe Flash CS3 est actuellement ouvert, quittez l'application.
- 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
- Pour Windows :
- 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 Analyticslib/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).
- 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.
- 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é.
- 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
ouAS3
. - Mode débogage : Définissez
debug
surfalse
pour une utilisation en production et surtrue
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"); }