Cette page a été traduite par l'API Cloud Translation.

Suivi Google Analytics pour Adobe Flash

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

Pourquoi utiliser le suivi Flash ?

Sans le composant Google Analytics Tracking for 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 dans ga.js afin que votre application Flash puisse exécuter la méthode Analytics appropriée (trackPageview() ou trackEvent(), par exemple). En outre, vous devez également prévoir si votre contenu Flash aura accès au modèle d'objet de document (DOM) du navigateur, car le suivi échoue pour les objets pour lesquels 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 OAuth 3 pour accéder au DOM du navigateur et le réduire 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 d'effectuer un certain nombre de tâches de suivi courantes dans Flash :

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 des différences structurelles par rapport au suivi des pages de sites Web. Il est essentiel de connaître le suivi Google Analytics 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. À l'heure actuelle, il n'est pas possible de suivre les données envoyées à partir d'Adobe Air, de Shockwave ou de l'IDE Flash.

Environnements de développement compatibles

Vous pouvez développer le suivi Analytics pour Flash dans des 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 sur du code ActionScript 3 et peuvent être configurés de deux manières 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 amML.
Importez les bibliothèques de suivi Flash dans vos balises de script/fichiers AS3.

Haut de page

Comment fonctionne le composant ?

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

L'ID de propriété Web : il s'agit également du numéro UA de votre code de suivi. Il se présente sous la forme UA-xxxxx-yy, où les "x" et les "y" sont remplacés par les chiffres qui correspondent aux informations de votre compte et de vos vues (profil) pour l'objet que vous suivez. Pour en savoir plus, consultez Propriété Web.
le mode de suivi : choisissez le mode Pont ou le mode AS3. Ce mode détermine la façon dont votre suivi communique avec les serveurs Analytics. Il est décrit en détail ci-dessous.
Le mode débogage : quel que soit l'environnement ou le mode de suivi que vous utilisez, vous pouvez activer le débogage pour valider et tester votre suivi.

Modes de suivi

Selon la manière dont vous diffusez votre contenu Flash, le composant Analytics pour Flash communique avec les serveurs Analytics soit en reliant le contenu Flash sur une installation de suivi Analytics existante, soit en communiquant directement avec les serveurs Analytics. Ces deux modes sont appelés mode Pont et Mode AS3, respectivement. Les deux modes utilisent la même fonctionnalité de suivi Analytics et vous pouvez facilement changer de mode de transfert de l'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 la campagne fonctionne. Ce paramètre active l'accès en lecture à l'URL 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 correspond pas au modèle d'attribution des campagnes Google Analytics.

Mode Pont

Utilisez ce mode si vous contrôlez la page HTML et le contenu Flash. Ce mode est préférable si vous avez déjà activé le suivi Google Analytics (ga.js) sur votre site Web et souhaitez ajouter le suivi au contenu Flash intégré. Le mode Pont simplifie la communication Flash-JavaScript en fournissant une interface ActionScript 3 unifiée au code ga.js. Il permet d'établir la connexion entre les appels ActionScript 3 et le code JavaScript Analytics afin que le suivi fonctionne.

Vous pouvez configurer l'association au code de suivi Google Analytics via le paramètre de l'ID de propriété Web de l'une des deux manières suivantes:

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 la référence DOM complète de 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 configurer ce comportement à l'aide de l'environnement Adobe Flex avec OAuth 3 :
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Autre méthode. Si vous n'avez pas créé d'objet de suivi sur votre page, il vous suffit de transmettre votre ID de propriété Web. Un objet de code de suivi JavaScript est alors créé. 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 illustre la configuration avec l'environnement Adobe Flex avec OAuth 3 :
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Pour que le mode Pont fonctionne correctement, vous devez définir ExternalInterface.available sur"true"dans votre code ActionScript 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 du 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 que vous ne contrôlez pas l'environnement d'hébergement de votre application Adobe Flash. Par exemple, si vous développez du contenu Flash à diffuser sur de nombreux sites, vous pouvez utiliser le mode AS3. Le mode AS3 est totalement indépendant du code de suivi ga.js et contient toutes les fonctionnalités de suivi Analytics. Il n'est pas nécessaire d'installer une solution de suivi ga.js distincte pour ce mode. En outre, le mode AS3 utilise le mécanisme de stockage Flash pour assurer le suivi des informations de session relatives à l'internaute.

Pour certains paramètres DOM tels que la langue, le composant AS3 tente de récupérer les valeurs du navigateur. Si les valeurs ne sont pas présentes, le composant utilise la valeur équivalente Flash ou la valeur par défaut no.

Dépannage et validation

Le composant de suivi Google Analytics pour Adobe Flash fournit un mode de 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 dans une zone de texte plutôt que vers les serveurs Analytics. Ce mode vous permet d'afficher en temps réel les données qui seraient autrement collectées par le serveur. Cette fonctionnalité permet également de garder 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 composant.

Exemples

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

Flash

Flex

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 de téléchargement affiche 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 version actuel du composant dans la console de contrôle.

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

Haut de page