Sujets sur : Google Analytics

Cours ActionScript 3 ‘Google Analytics’

Comment ajouter Google Analytics dans Flash en AS3 ?

6 questions

Ecrit le 24 octobre par Matthieu
Publié dans le(s) sujet(s) ActionScript 3

Nous allons découvrir comment effectuer des mesures statistiques avec les applications Flash .

Cet article est consacré à l’implémentation de Google Analytics dans vos RIA Flash en AS3.

Qu’est ce que GA For Flash ?

Une API a été conçu en AS3 par Nickski15, Zwetan et Ekameleon. Ils ont développé cette API et l’ont mis à disposition, en Open Source, via le projet Google Analytics Tracking for Flash API (gaforflash).

Google Analytics vous permet d’analyser le traffic de votre RIA Flash pour :

  • visualiser les pages vues (interfaces AS3) et leur nombre d’affichage.
  • tracer des actions et des évènements.

Installation de Google Analytics

Pour implémenter GA (Google Analytics), il suffit de télécharger la dernière version sur le site Google Code. Vous pouvez télécharger :

  • soit le fichier .SWC gaforflash-1.0.1.319.zip. Je vous conseille de télécharger le fichier SWC, c’est plus simple à utiliser dans vos projets AS3.
  • soit le code source complet via le SVN Google Code. Lien du SVN : http://gaforflash.googlecode.com/svn/trunk/

Ensuite, vous ajoutez le fichier analytics_flash.swc dans votre application AS3 avec votre Éditeur ActionScript habituel.

Avec l’Éditeur FDT, c’est très simple. J’ai rédigé un Guide gratuit pour Développer efficacement et rapidement en ActionScript.

Utilisation de GA en AS3

Reprenons l’exemple du Chapitre : Création des Graphismes / Skins des Composants AS3 pour ajouter le Tracking Google Analytics en AS3.

Création du Tracker

Juste avant la création de votre interface Flash, vous devez initialiser le Tracker.

[codesyntax lang= »actionscript3″ title= »GoogleAnalyticsExample.as » bookmarkname= »GoogleAnalyticsExample.as »]

[/codesyntax]

Les différents paramètres à renseigner :

  • Id : cette propriété permet de déclarer le Tracker dans votre application Flash.
  • Account : c’est l’identifiant de votre compte Google Analytics. Un numéro du type UA-944069-6.
  • Mode : cette valeur est renseignée par AS3 ou Bridge.

Le mode AS3 est utilisé lorsque vous ne contrôlez pas les pages HTML dans lesquelles votre RIA est incluse (par exemple les widgets affichés sur myspace, facebook…), ou s’il n’y a pas de suivi Google Analytics activé.

Dans la majorité des RIA Flash, le mode AS3 est utilisé.

Le mode Bridge est utilisé lorsque votre RIA est intégré dans une page Web qui contient un script de mesure Google Analytics. Ce mode est utilisé avec la classe ExternalInterface, il est donc important que le paramètre allowScriptAccess soit correctement défini (« always » ou « sameDomain »).

  • Debug : cette propriété active le débug avec l’API gaforflash. Si le Débug est défini sur true, toutes les données sont affichées dans une fenêtre de débogage.

Ensuite, en fonction de votre application Flash, Google Analytics peut :

  • tracker les pages vues (interfaces AS3) et leur nombre d’affichage.
  • tracker des actions ou des évènements.

Suivi des pages vues

Pour suivre les interfaces affichées dans votre RIA, une seule ligne de code est nécessaire. Renseignez le nom de l’interface et son nombre d’affichage sera comptabilisé dans Google Analytics.

[codesyntax lang= »actionscript3″ title= »GoogleAnalyticsExample.as » bookmarkname= »GoogleAnalyticsExample.as »]

[/codesyntax]

Par exemple, à chaque fois que votre application Flash est affichée, vous pouvez ajouter un trackPageview. Ou lorsqu’une interface précise est sélectionnée par l’utilisateur.

Suivi des évènements

Vous pouvez également suivre le cheminement complet de l’utilisateur dans votre RIA Flash. Cela permet d’envoyer des événements qui seront enregistrés dans GA.

Voici les 4 paramètres à définir :

  • category : le nom du groupe d’événements. Dans notre exemple la category est AS3 Facile GA.
  • action : le nom de l’action effectuée, cette action est associée avec une catégorie. Dans notre exemple, l’événement se nomme par le nom du Button choisit par l’utilisateur (Arc en Ciel Liste).

 

  • label : un nom optionnel pour donner des informations supplémentaires sur la combinaison category / action. Dans une liste d’éléments de votre interface, vous pouvez préciser le type d’élément (un Button). Ou dans une playlist vidéo, vous précisez le numéro de la vidéo.

 

  • value : un nombre non négatif, c’est une valeur optionnel qui associe un canal (ou channel)  à un événement mesuré.

[codesyntax lang= »actionscript3″ title= »GoogleAnalyticsExample.as » bookmarkname= »GoogleAnalyticsExample.as »]

[/codesyntax]

Très facilement, vous pouvez tracker toutes les actions de l’utilisateur de votre RIA Flash :

  • l’appuie sur tel ou tel élément de l’interface pour lancer un nouvel écran, ouvrir une page Web…
  • lorsque l’utilisateur télécharge des fichiers pdf, zip…
  • lorsque l’utilisateur visualise une vidéo, écoute un podcast, un MP3…

Tableau de Bord Google Analytics

Une fois votre application Flash paramétrée, vous pouvez visualiser les différentes statistiques dans votre Tableau de Bord Google Analytics.

Pour visualiser les statistiques sur les pages vues (interface AS3) et leurs nombre d’affichage, allez dans Contenu et Pages les plus consultées.

Google Analytics - Suivi des Pages

Pour visualiser les évènements ou actions de l’utilisateur, allez dans Suivi des évènements. Ensuite, vous pouvez choisir Catégories, Actions, Libellés

Google Analytics - Suivi des évènements

Google Analytics - Détails des évènements

Conclusion

Google Analytics Tracking for Flash offre des capacités de tracking infinies dans une RIA Flash en AS3.

  • L’utilisation de trackPageview vous permet de mesurer le trafic de votre application Flash dans ses moindres détails.
  • L’utilisation de trackEvent vous permet de mieux comprendre la manière dont vos utilisateurs réagissent à vos interfaces Flash.

gaforflash est donc un complément très intéressant pour comprendre les actions de vos utilisateurs dans vos interfaces AS3.

Ci-dessous, voici notre application Flash avec l’implémentation de Google Analytics.

Appuyez sur la touche « ESPACE » de votre clavier pour faire disparaitre / apparaitre la fenêtre de Debug GA.

Sources Commentées

  • GoogleAnalyticsExample.as

[codesyntax lang= »actionscript3″ title= »GoogleAnalyticsExample.as » bookmarkname= »GoogleAnalyticsExample.as »]

[/codesyntax]

Vous trouverez ci-dessous l’ensemble des classes créées. Elles sont commentées pour vous permettre de comprendre au mieux leur fonctionnement.

Vous pouvez télécharger le fichier zip :

Télécharger “Google Analytics dans Flash en AS3”

google_analytics_exemple.zip – Téléchargé 709 fois – 198,15 Ko

Pour en savoir plus

Remerciements

Je remercie les Développeurs AS3 pour la création de cette API AS3 : Google Analytics Tracking for Flash API (gaforflash).

Et je vous invite à découvrir leurs Projets respectifs :

Dans les prochains tutoriels : quels sujets voulez-vous que j’aborde ?

Souhaitez des nouveaux exemples avec le code source sur l’utilisation du Framework de Composants AS3 Facile ?

Avez-vous besoin de plus d’éclaircissement sur tel ou tel Composants AS3 du Framework ? Ou préférez que j’aborde des sujets totalement différents ?