Intégration avec Google Analytics

Comment intégrer Google Analytics à vos lecteurs par le biais d'un SWF plug-in.

Cette rubrique décrit l’intégration de vos lecteurs avec Google Analytics. Grâce à la fonction de suivi Flash de Google, vous pouvez assurer le suivi de vos lecteurs où qu’ils soient sans devoir vous baser sur le code JavaScript intégré à la page. Lisez cette documentation Google pour une présentation du suivi flash de Google.

Si vous connaissez ActionScript et si vous souhaitez personnaliser l’intégration de Google Analytics, lisez la rubrique avancée consacrée aux développeurs : Intégration de Google Analytics pour les développeurs.

Les principales étapes de cette intégration sont :

Créer un compte Google Analytics.
Configurer votre profil de site Web pour qu’il soit prêt à recevoir des informations de vos lecteurs.
Télécharger notre SWF Analytics clés en main pour permettre à vos lecteurs d’envoyer des informations sur les événements des lecteurs (telles que le chargement du lecteur, le lancement d'une vidéo, la fin d'une vidéo) à votre compte Google Analytics.
Une fois le SWF chargé sur votre serveur Web, configurer vos lecteurs pour qu’ils utilisent le SWF en les éditant dans le module d’édition et en saisissant l’emplacement de votre SWF Analytics sur votre site Web.

Cette rubrique comprend des informations sur :

La création d’un compte Google Analytics
L'utilisation du SWF Google Analytics
L'affichage des données Video Cloud dans Google Analytics
La configuration du fichier crossdomain.xml
Les remarques et restrictions

C’est parti !

Création d’un compte Google Analytics

La première étape dans l’intégration à Google Analytics consiste à ouvrir un compte Google Analytics. Cette procédure est gratuite.

Une fois enregistré et connecté à votre compte Google Analytics, créez un profil de site Web. Le profil de site Web est en fait une vue de vos rapports. C’est un outil qui peut s’avérer très puissant : vous pouvez créer plusieurs profils pour le même site Web (ou lecteur) pour filtrer et découper vos données de plusieurs façons différentes.

Utilisation d'un compte Google Analytics existant

Si vous possédez déjà un profil Google Analytics pour votre site Web pour le suivi des vues de vos pages, nous vous recommandons de créer un profil pour le même site Web pour le suivi des données Video Cloud. Dans le cas contraire, vous pourriez écraser d'autres données de site Web que vous essayez de suivre. Plus d'informations sur les profils dans la documentation d'aide Google Analytics.

Pour créer un profil :

Cliquez sur Ajouter un profil de site Web.
Dans le champ Ajouter un profil pour un nouveau domaine, saisissez l’URL de votre lecteur, sans le nom du fichier HTML.
Vous pouvez éditer le fuseau horaire du profil et enregistrer le fichier.

Une fois le profil créé, Google Analytics affiche des codes de suivi et votre ID de compte Google alphanumérique qui ressemble à ce qui suit : « AA-123456-A ».

Vous n’avez pas besoin du code de suivi JavaScript pour profiter des fonctionnalités de suivi flash de Google Analytics. Vous aurez toutefois besoin de votre ID de compte Google. Notez ce dernier quelque part, car vous en aurez besoin lors de la configuration de vos lecteurs pour envoyer des événements à Google Analytics.

Utilisation du SWF Google Analytics

Vous pouvez télécharger le SWF Google Analytics sous forme de fichier *.zip. Le fichier échantillon envoie les événements PLAYER LOAD, MediaEvent.BEGIN et MediaEvent.COMPLETE à Google Analytics. Pour plus d’informations sur ces événements, consultez la rubrique Aide sur les MediaEvents de l’API du lecteur. Si vous êtes familier avec ActionScript, vous pouvez faire en sorte que le SWF Google Analytics lance plus d'événements. Consultez la rubrique Intégration du SWF Google Analytics pour les développeurs pour plus d’informations sur le sujet.

Autrement, vous pouvez télécharger, décompresser et utiliser le SWF Google Analytics open source disponible sur Open Source @ Brightcove. Il se trouve à cette adresse.

Pour les événements de chargement du lecteur envoyés à Google, les détails suivis sont les suivants :

Player ID (ID du lecteur)
Player Name (Nom du lecteur)
URL du lecteur (l’URL où le spectateur a chargé le lecteur)
URL de référence (la page que consultait le spectateur avant d’ouvrir le lecteur Video Cloud).

Pour les événements « media begin » et « media complete » envoyés à Google, les détails suivis sont les suivants :

Player ID (ID du lecteur)
Player Name (Nom du lecteur)
Playlist ID (ID de la sélection)
Video ID (ID de la vidéo)
Video Name (Nom de la vidéo)
le type d’événement (par exemple, Begin ou Complete).

Par exemple, si votre lecteur est chargé, l’événement qui s’affichera dans le rapport Google Analytics ressemblera à ce qui suit :
http://monsite.com/playerid=12345/playername=Mon premier lecteur/url=http://monsite.com/video/refurl=http://autressites.com/player_load

Dans le cas d’un événement Media Begin au démarrage de la lecture d’une vidéo, l’URL dans le rapport Google ressemblera à ce qui suit :
http://monsite.com/playerid=12345/playername=Mon premier lecteur/playlistid=67890/videoid=32145/videoname=My First Video Eva/video_start

Une fois le SWF Google Analytics téléchargé, vous devez le rendre disponible dans vos lecteurs. Pour utiliser le SWF de Google Analytics, vous devez :

Décompresser le fichier téléchargé et héberger le SWF à une URL accessible à vos lecteurs.
Configurer les lecteurs pour l’utilisation du SWF de Google Analytics. Pour ce faire, éditez les paramètres de votre lecteur dans le module d’édition et ajoutez l’URL du fichier SWF Analytics sous l'onglet Plugins. Vous devrez inclure votre ID Google avec le paramètre gid dans l’URL du SWF Analytics pour votre lecteur. Vous pouvez par exemple définir votre URL du SWF Analytics comme suit :
http://monsite.com/analytics.swf?gid=AA-123456-A
[Facultatif] Activer les API ActionScript/JavaScript pour les lecteurs qui utilisent le SWF Analytics dans la fenêtre Editer les paramètres du module d’édition. Si vous choisissez de ne pas activer les API pour vos lecteurs, l’échantillon de code d’intégration fonctionnera malgré tout.

Une fois que votre lecteur a été publié et commence à envoyer des événements Google, il peut se passer 24 heures entre l’événement et son inscription dans les rapports Google.

Affichage des données Video Cloud dans Google Analytics

Une fois votre lecteur configuré pour envoyer des données à Google comme défini dans les étapes ci-dessus, vous pouvez voir vos données vidéo dans les rapports Google Analytics. Pour ce faire :

Connectez-vous à votre compte Google Analytics.
Dans le menu latéral gauche, cliquez pour afficher votre rapport de contenu puis sélectionnez Meilleur contenu dans le sous-menu.
Sélectionnez la fenêtre de temps appropriée pour votre rapport. Notez que les événements Video Cloud sont suivis en tant qu'affichages de pages « virtuels » dans le rapport qui s'affiche.
Si vous désirez rechercher une vidéo ou lecteur Video Cloud spécifique dans les rapports, utilisez le champ de recherche « Chercher page » en bas de la page ou téléchargez le rapport entier dans le format de votre choix pour ensuite chercher parmi/filtrer les données.

Configuration du fichier crossdomain.xml

Vérifiez que votre fichier crossdomain.xml est correctement configuré. Le fichier crossdomain.xml repose dans le domaine (le même domaine où vous hébergez le SWF Google Analytics) qui contient une liste des domaines tiers de confiance. Vous devrez probablement contacter votre administrateur pour apporter cette modification. Votre site doit autoriser Flash Player à accéder aux données des domaines Brightcove et Google. Le fichier crossdomain.xml le plus simple possible qui autoriserait uniquement ces deux domaines ressemblerait fortement à la syntaxe suivante :

<cross-domain-policy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="http://www.adobe.com/xml/schemas/PolicyFile.xsd">
  <allow-access-from domain="*.brightcove.com"/>
  <allow-access-from domain="*.google-analytics.com"/>
</cross-domain-policy>

Si vous ne savez pas comment modifier le fichier selon les modalités ici décrites, contactez votre administrateur Web. Pour plus d’informations, consultez la rubrique Sécurité des domaines croisés.

Remarques et restrictions

Tenez compte des restrictions et des informations suivantes quant à l’utilisation de Google Analytics :

Vous pouvez définir le chemin d’accès du SWF Analytics Web dans chaque lecteur ou dans un modèle de lecteur personnalisé, mais vous ne pouvez pas le définir dans le compte pour tous les lecteurs à la fois.
Le plug-in de statistiques est un SWF et ne peut donc fonctionner qu'au sein d'un lecteur Flash Video Cloud. Il n'est pas pris en charge par les lecteurs intelligents HTML5.
Google Analytics est limitée quant au nombre d’affichages d'une page. Google Analytics est un service rapide autorisant gratuitement le décompte de l’affichage de 5 millions de pages maximum par mois. Si votre site génère plus de 5 millions d’affichages par mois, vous devrez le lier à un compte AdWords actif pour éviter l’arrêt de votre service Google Analytics. Google Analytics définit actuellement un compte AdWords actif comptant au moins une campagne active, moyennant un budget minimal d'un dollar par jour (ou l’équivalent dans une autre devise).
Google vous recommande de ne pas désactiver les cookies de suivi permanents créés par Google Analytics. Si vous choisissez de les désactiver malgré tout, vous perdrez des données dans plusieurs rapports, dont notamment Nouveaux vs. récurrents, Fidélité des visiteurs et tout ce qui figure dans Sources du trafic. Si vous devez désactiver tous les cookies sur votre site, suivez les instructions du site Web de Google Analytics pour une explication détaillée du processus.

Video Cloud

App Cloud

Ressources