Suivi Google Analytics pour Adobe Flash

Le composant de suivi Google Analytics d'Adobe Flash vous permet d'implémenter facilement Google Analytics dans votre contenu Flash. Développé par Adobe Systems, Inc., ce composant contient toutes les fonctionnalités du code JavaScript Google Analytics. Le composant de suivi Flash est un objet de suivi compilé natif d'ActionScript 3. Il rend l'implémentation d'Analytics intuitive dans les environnements de développement Flash et Flex.

Le logiciel de ce composant est développé et pris en charge par Adobe Systems, Inc. Google ne fait aucune promesse et ne fait aucune déclaration concernant ses performances, sa qualité ou son contenu. Si vous êtes développeur et que vous souhaitez contribuer au projet, consultez la page d'accueil du projet http://code.google.com/p/gaforflash/.

Pourquoi utiliser le suivi Flash ?

Sans le composant de suivi Google Analytics d'Adobe Flash, le suivi du contenu Adobe Flash avec Google Analytics implique un certain nombre d'obstacles techniques. Tout d'abord, vous devez développer une interface personnalisée pour ga.js, afin que votre application Flash puisse exécuter la méthode Analytics appropriée, telle que trackPageview() ou trackEvent(). En outre, vous devez également prévoir si votre contenu Flash aura accès au Document Object Model (DOM) du navigateur, car le suivi échoue pour les objets dont l'accès au DOM est refusé (généralement lorsque votre contenu se trouve sur des sites tiers). Pour ce faire, vous devez comprendre comment utiliser l'appel ExternalInterface dans Action 3 pour accéder au DOM du navigateur et se dégrader lorsque l'accès est refusé.

Le composant Google Analytics pour Adobe Flash simplifie le suivi de votre contenu Flash et gère avec simplicité l'accès DOM. Il permet de suivre un certain nombre d'éléments courants dans Flash, par exemple :

• un widget Flash incorporé dans une page HTML ;
• une application Flex autonome ou un site acceptant uniquement les fichiers Flash, hébergé sur une page HTML ;
• un jeu ou un programme Flex/Flash distribué dans lequel le développeur ne contrôle pas l'emplacement du widget.

N'oubliez pas que le suivi des applications dans Flash présente certaines structures par rapport au suivi des pages de sites Web. Une bonne connaissance du suivi Google Analytics est indispensable pour comprendre le fonctionnement de ce plug-in. Vous pouvez également consulter la documentation de conception de ce projet pour obtenir des informations détaillées sur le transfert du modèle de suivi Analytics pour ce composant.

Remarque:Actuellement, le suivi Flash est disponible pour tout contenu Flash intégré dans une page Web. Le suivi des données envoyées depuis Adobe Air, Shockwave ou l'IDE Flash (par exemple, à l'aide d'un film de test) n'est pas disponible pour le moment.

Environnements de développement compatibles

Vous pouvez développer le suivi Analytics pour Flash dans les environnements Adobe Flash ou Adobe Flex. Chaque environnement nécessite un composant différent, que vous pouvez télécharger à l'adresse http://code.google.com/p/gaforflash/. Ces composants sont basés surActionScript 3 et peuvent être configurés de l'une des deux manières suivantes pour chaque environnement:

Dans Adobe Flash

• Ajoutez et configurez un composant simple dans l'inspecteur de composants, puis faites-le glisser dans l'espace de création.
• Importez les bibliothèques de suivi Flash directement dans votre bibliothèque et commencez à coder.

Dans Adobe Flex

• Incluez un composant MXML que vous configurez à partir du fichier am MXML.
• Importez les bibliothèques de suivi Flash dans vos tags de script ou vos fichiers AS3.

Haut de page

Comment le composant fonctionne-t-il ?

Pour utiliser le composant de suivi Flash dans votre environnement, vous pouvez soit utiliser les outils visuels de cet outil, soit configurer l'objet de suivi directement dans votre code. Que vous configuriez le composant de façon visuelle ou via du code, vous devez fournir les éléments suivants:

• ID de propriété Web : également appelé numéro UA de votre code de suivi, il se présente sous la forme UA-xxxxx-yy, où les "x" et "y" sont remplacés par les numéros correspondant à votre compte et aux informations de vue (profil) de l'objet que vous suivez. Pour en savoir plus, consultez la page Site Web.
• Mode de suivi : sélectionnez le mode Pont ou le mode AS3. Ce mode détermine la manière dont votre suivi communique avec les serveurs Analytics et est décrit en détail ci-dessous.
• Mode débogage : quel que soit l'environnement ou le mode de suivi que vous utilisez, vous pouvez l'activer pour valider et tester votre suivi.

Modes de suivi

Selon la manière dont vous distribuez votre contenu Flash, le composant Analytics pour Flash communique avec les serveurs Analytics soit en établissant la communication entre le contenu Flash d'une installation de suivi Analytics existante, soit en communiquant directement avec les serveurs Analytics. Ces deux modes sont respectivement appelés mode Pont et mode AS3. Ces deux modes utilisent la même fonctionnalité de suivi Google Analytics. Vous pouvez facilement passer de l'un à l'autre dans votre application Flash. En plus de choisir un mode de communication pour le suivi Analytics, vous pouvez utiliser un mode de débogage pour résoudre les problèmes ou valider votre suivi.

Quel que soit le mode, allowscriptaccess doit être égal à always pour que le suivi de campagne fonctionne. Ce paramètre active l'accès en lecture à l'URL de la page et aux informations de provenance requises par le code de suivi Flash. Sans allowscriptaccess, le code de suivi Analytics se dégrade correctement. Elle fournit toujours la plupart des données sur l'activité des utilisateurs, mais ne confirme pas le modèle d'attribution de la campagne Google Analytics.

Mode Pont

Utilisez ce mode si vous contrôlez à la fois la page HTML et le contenu Flash. Ce mode est optimal si vous avez déjà implémenté le suivi Google Analytics (ga.js) sur votre site Web et que vous souhaitez ajouter le suivi au contenu Flash intégré. Le mode Pont simplifie la communication entre Flash et JavaScript en fournissant une interface Action 3 unifiée pour le code ga.js. Il établit la connexion entre les appels ActionScript 3 et le code JavaScript Analytics pour assurer le bon fonctionnement du suivi.

L'association au code de suivi Google Analytics peut être configurée via le paramètre d'ID de propriété Web de deux manières:

• Méthode la plus courante. L'objet Code de suivi Google Analytics existe déjà sur votre page, avec son propre nom (par exemple, pageTracker). Dans ce cas, vous devez fournir l'intégralité de la référence DOM à l'objet de suivi. Par exemple, si votre objet s'appelle pageTracker, vous devez le référencer dans votre code en tant que window.pageTracker. Par exemple, l'extrait de code suivant montre comment effectuer cette configuration dans l'environnement Adobe Flex avecActionScript 3 :

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

  
  
• Autre méthode Si vous n'avez pas créé d'objet de suivi de page sur votre page, il vous suffit de transmettre votre ID de propriété Web pour qu'un objet de code de suivi JavaScript soit créé pour vous. Avec cette méthode, vous devez toujours faire référence au fichier source JavaScript ga.js de base sur votre page HTML. L'extrait de code suivant montre comment configurer cette fonctionnalité dans l'environnement Adobe Flex avecActionScript 3 :

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

Pour que le mode Pont fonctionne correctement, ExternalInterface.available doit être défini sur "true" dans votre code JavaScript 3. Cela signifie également que allowScriptAccess doit être défini sur always dans la page HTML qui intègre le contenu Flash. L'exemple suivant illustre le code HTML configuré pour le mode Pont:

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

 

Haut de page

Mode AS3

Utilisez ce mode si vous contrôlez le code Adobe Flash ActionScript 3, mais pas l'environnement d'hébergement de votre application Adobe Flash. Par exemple, si vous développez du contenu Flash en vue de sa distribution sur de nombreux sites, utilisez le mode AS3. Le mode AS3 est complètement indépendant du code de suivi ga.js et contient toutes les fonctionnalités de suivi Analytics. Avec ce mode, vous n'avez pas besoin d'installer le suivi ga.js séparément. De plus, le mode AS3 utilise le mécanisme de stockage Flash pour suivre les informations de session de l'utilisateur.

Pour certains paramètres DOM tels que la langue, le composant AS3 tente de récupérer les valeurs dans le navigateur. En l'absence de valeurs, le composant utilise la valeur équivalente Flash ou la valeur par défaut no.

Dépannage et validation

Le composant de suivi Google Analytics d'Adobe Flash propose un mode débogage qui simplifie la validation et le dépannage. Lorsque cette option est activée, toutes les données de suivi sont interceptées et redirigées vers un écran situé dans une zone de texte, et non vers les serveurs Analytics. Ce mode vous permet de voir en temps réel les données qui seraient autrement collectées par le serveur. Cette fonctionnalité permet également de conserver les données de test en dehors de vos données de production. Vous pouvez activer la fonctionnalité de dépannage en définissant l'option visualDebug sur true dans l'inspecteur de composants.

Exemples

Pour obtenir des exemples détaillés d'implémentation du suivi dans les différents environnements de développement, consultez les pages suivantes:

Flash

• Utiliser le composant Analytics dans Flash
• Utiliser le composant AnalyticsLibrary dans Flash

Flex

• Exemple de composant MXML Flex
• Exemple d'ActionScript 3 Flex 3
  

Gestion des versions

Vous trouverez la dernière version des composants de suivi sous forme de fichier ZIP à l'adresse http://code.google.com/p/gaforflash/downloads/list. Chaque téléchargement contient tous les composants de suivi, ainsi que la documentation associée. Le nom du fichier téléchargé indique le numéro de version du code qu'il contient.

Vous pouvez également utiliser les instructions suivantes dans votre code pour imprimer le numéro de la version actuelle du composant dans la console de contrôle.

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

 

Haut de page