Créer et gérer vos templates Data Query Créer vos tableaux personnalisés Exporter les templates obtenus Générer les templates sur des périmètres différents DE.S.2-000000981 v1.0 (updated 10/2010)
Sommaire 1. Avant de commencer 1. Pré-requis 2. Notions importantes 2. Data Query 3. Créer un template 1. Paramétrer votre template 2. Sélection des dimensions 3. Sélection des métriques 4. Appliquer un segment 5. Appliquer un filtre 6. Prévisualiser 5. Gestion des templates 1. Dupliquer un template 2. Modifier un template 3. Exporter un template 4. Supprimer un template 6. Questions/Réponses 7. En savoir plus 4. Finaliser un template 1. Enregistrer 2. Obtenir l URL REST 3. Export immédiat 4. Connecteur IQY 2
1. Avant de commencer 1.1 Pré-requis Data Query est une interface disponible avec l option Data Explorer. Cette interface vous permet de configurer vos templates en définissant vous-même les colonnes à afficher, les filtres ou segments à appliquer. 1.2 Notions importantes Dimensions : différents types d éléments mesurés mis à disposition dans l interface Digital WorkSpace NX. Métriques : indicateurs associés à une dimension. Elles permettent d effectuer l analyse de performance ou de volumétrie de chaque élément qui compose la dimension. Métriques personnalisées : métriques que vous définissez vous-mêmes, en fonction de vos besoins. Ces métriques se basent sur des opérations entre différentes métriques, des entiers, des décimaux, des métriques segmentées, etc. Une interface dédiée est disponible pour la définition de ces métriques. Retrouvez plus d informations dans le User Guide Custom Metrics. Filtres : permettent d affiner les éléments affichés dans les tableaux. Segment : définition de critères permettant d obtenir des sous-ensembles de visites possédant les mêmes caractéristiques. Une interface dédiée est disponible pour la définition de ces segments. Retrouvez plus d informations dans le User Guide Segmentation. Template : ensemble cohérent qui définit la structure des données à exporter, basée sur l ensemble des notions précédentes. Vous pouvez créer autant de templates que d exports de données souhaités. 3
2. Data Query Accédez à Data Query en passant par le menu Outils de votre interface Analyzer. Dans le cas de nombreux templates, des filtres permettent de les retrouver plus facilement. Cliquez sur le bouton Ajouter pour définir un nouveau template 4
3. Créer un template 3.1 Paramétrer votre template Nommez votre template en cliquant sur le lien Renommer. Veillez à bien sélectionner au préalable le site et la période sur laquelle vous souhaitez générer votre rapport. A savoir Vous pourrez faire varier la période et le site une fois le template sauvegardé. 5
3. Créer un template 3.2 Sélection des dimensions Retrouvez la liste des dimensions à votre disposition sur la gauche Sélectionnez alors la dimension qui vous intéresse et déplacez-la dans la colonne souhaitée du template à droite A savoir Une fois une dimension sélectionnée, vous pouvez en ajouter d autres. En fonction de la dimension sélectionnée, seules les autres dimensions pouvant être croisées avec celle-ci sont proposées dans le menu. 6
3. Créer un template 3.3 Sélection des métriques Dès qu une dimension est positionnée dans le template, vous pouvez sélectionner une ou plusieurs métriques. Si vous créez des métriques personnalisées pendant la construction du template, pensez à rafraîchir la liste des métriques. Sélectionnez alors la métrique qui vous intéresse et déplacez-la dans la colonne souhaitée du template à droite. A savoir - Votre template peut contenir jusqu à 30 colonnes. - La définition des métriques personnalisées est accessible directement depuis cette interface. 7
3. Créer un template 3.4 Appliquer un segment Une fois votre template réalisé, vous pouvez appliquer un segment à votre tableau. Il suffit de déplacer en haut de votre template le segment sélectionné. A savoir - Le segment s appliquera à l ensemble de votre template. - La définition de segment est accessible directement depuis cette interface. - Ces segments sont différents de ceux que vous auriez pu enregistrer dans le DWS NX. 8
3. Créer un template 3.5 Appliquer un filtre En cliquant sur l icône d une colonne, une fois votre template construit, vous pouvez appliquer un filtre sur la colonne choisie. A savoir Vous pouvez appliquer un filtre sur chacune des colonnes de votre template. 9
3. Créer un template 3.6 Prévisualiser Cliquez sur Prévisualiser pour visualiser à quoi ressemblera votre template (top 30 des données) A noter Si votre template ne vous convient pas, vous pouvez retourner à la configuration pour le modifier et répéter ainsi cette opération autant de fois que vous le souhaitez. 10
4. Finaliser un template 4.1 Enregistrer A utiliser pour sauvegarder les modifications faites sur le template. Pensez à nommer votre template lors du 1 er enregistrement. Cliquez sur Terminer pour finaliser votre template A utiliser pour enregistrer le template sous un autre nom. Dans ce cas, une fenêtre vous demande de saisir le nouveau nom. A noter Vous pouvez à tout moment retourner à la liste de vos templates en cliquant sur le bouton [retour à la liste] disponible en haut à gauche. 11
4. Finaliser un template 4.2 Obtenir l URL REST Avec l URL REST vous avez la possibilité de récupérer les données brutes directement dans votre navigateur sous format XML (après identification par login/mot de passe) Sélectionnez le nombre de lignes maximum que vous souhaitez obtenir puis récupérez l URL associée au template que vous venez de définir. Si votre template est enregistré, vous avez également la possibilité de récupérer un short code (URL raccourcie) A noter Le short code permet d avoir une URL constante liée au template : toute modification du template est alors automatiquement prise en compte par ce short code (contrairement à l URL standard). 12
4. Finaliser un template 4.3 Export immédiat L export immédiat vous permet de récupérer les données du template que vous venez de définir au format Excel ou CSV. Nommez votre export, sélectionnez le nombre de ligne maximum que vous souhaitez obtenir puis le format des données et cliquez sur Générer. 13
4. Finaliser un template 4.4 Connecteur IQY Récupérez votre fichier IQY Téléchargez le connecteur IQY qui vous permettra de récupérer dynamiquement les données des templates que vous aurez sauvegardés. Nommez votre fichier et sélectionnez le nombre de lignes maximum que vous souhaitez obtenir. Cliquez ensuite sur Télécharger. 14
4. Finaliser un template 4.4 Utilisation du connecteur IQY Préparez votre fichier Excel Ouvrez Excel et définissez deux champs : Date de début Date de fin Les deux cellules associées doivent être définies au format Texte. Dans ces 2 cellules, saisissez une date de début de période et une date de fin de période au format AAAA-MM-JJ 15
4. Finaliser un template 4.4 Utilisation du connecteur IQY Appelez votre fichier IQY Appelez votre fichier IQY en allant dans l onglet Données > Connexions existantes. Puis cliquez sur le bouton Rechercher et sélectionnez le fichier que vous avez récupéré depuis Data Query. 16
4. Finaliser un template 4.4 Utilisation du connecteur IQY Configurez votre connexion Choisissez l emplacement pour insérer vos données. Avant de valider votre choix, cliquez sur le bouton Propriétés et choisissez les options qui vous conviennent le mieux. A savoir Cochez la 3ème option si vous souhaitez que les nouvelles données soient insérées sur les anciennes et conservent ainsi le format que vous avez préalablement défini. 17
4. Finaliser un template 4.4 Utilisation du connecteur IQY Paramétrez votre fichier Sélectionnez la cellule contenant la date de début (au format AAAA-MM-JJ). De la même façon, sélectionnez la cellule contenant la date de fin. Renseignez votre login et mot de passe (les mêmes identifiants que pour vous connecter à l interface DWS) A savoir Cochez la case Utilisez cette valeur ou référence pour les nouvelles actualisations. De cette façon, cette cellule servira de référence à chaque mise à jour des données. Si vous cochez Actualiser automatiquement lorsque la valeur de la cellule est modifiée toute modification des 2 cellules de date entrainera une actualisation des données via nouvel appel API. 18
4. Finaliser un template 4.4 Utilisation du connecteur IQY Aller plus loin En rentrant dans le fichier IQY, vous pouvez insérer des balises (texte surligné ci-dessous) afin de faire également varier très simplement les éléments suivants : Site de niveau 1 Nombre maximum de lignes Les métriques Les dimensions Les filtres Les tris Etc. Vous pourrez ainsi construire des templates dynamiques adaptés à vos besoins. 19
5. Gestion des templates 5.1 Dupliquer un template Cliquez sur l icône Dupliquer du template que vous souhaitez rendre visible par un autre utilisateur. Puis sélectionnez le ou les utilisateurs concernés et cliquez ensuite sur le bouton Dupliquer. A savoir Les templates sont propres à chaque compte. Ils ne peuvent être dupliqués qu avec les administrateurs, les utilisateurs avec pouvoir et les utilisateurs. 20
5. Gestion des templates 5.2 Modifier un template Cliquez sur l icône Modifier du template sur lequel vous souhaitez travailler. Le squelette de votre template est alors présenté dans l espace de travail et vous pouvez le modifier. A savoir Les modifications que vous allez réaliser sur le template de votre choix n auront pas d impact sur les duplications que vous auriez pu faire à partir de ce template. Ces modifications ne seront visibles que sur votre compte. 21
5. Gestion des templates 5.3 Exporter un template Cliquez sur l icône Exporter du template pour accéder à l écran du choix de mode de récupération des données. 22
5. Gestion des templates 5.4 Supprimer un template Cliquez sur l icône Supprimer du template que vous souhaitez supprimer. Vous pouvez également supprimer plusieurs templates en même temps en les sélectionnant puis en cliquant sur le bouton Supprimer. 23
6. Questions/Réponses Pourquoi je ne vois plus l intégralité des dimensions dans le menu lorsque l une d entre-elles est déjà dans mon template? Une fois une dimension sélectionnée, vous ne voyez pas toutes les dimensions parce qu il n est pas possible de croiser toutes les dimensions entre elles. L interface ne présente que les informations qui peuvent être croisées entre elles en fonction du template créé. Comment faire pour recevoir toutes les semaines un bilan du trafic de mon site? Concernant votre demande, Data Query n est pas obligatoire. Vous pouvez continuer à planifier des exports ou rapports depuis votre interface Digital WorkSpace NX, en passant par le lien Diffuser disponible en haut de l ensemble des analyses. Quel est l avantage d utiliser l URL «short code»? Le principal avantage est que cette URL est figée. Si vous avez un système automatique d appel à l URL REST, modifier le template vous oblige à modifier cette URL REST alors que la version «short code» n aura pas besoin d être changée. Combien de colonnes puis-je mettre dans mon template? Combien de templates puis-je réaliser? Vous pouvez mettre jusqu à 30 colonnes dans votre template (avec au moins une dimension et une métrique) et construire autant de templates que vous le désirez. Tous vos templates seront accessibles sur la page d accueil de Data Query. 24
6. Questions/Réponses Dans la partie Terminer, je n ai pas accès au «shortcode» quand je clique sur le bouton Obtenir l'url REST, pourquoi? Le shortcode n est disponible que sur les templates enregistrés. Il vous faut donc le sauvegarder une première fois pour voir apparaître cette option. Je ne retrouve pas mes segments déjà créés dans Digital WorkSpace NX Les segments proposés dans cette interface Data Query reposent sur le nouveau moteur d accès à nos données : ce ne sont pas les mêmes que ceux que vous auriez pu déjà créer dans le Digital WorkSpace NX. Les 2 listes de segments resteront indépendantes et non mutualisables. Je n arrive pas à appliquer un segment sur mon template Vérifiez qu il n existe pas de métrique personnalisée dans votre template. En effet, les métriques personnalisées pouvant elles mêmes reposer sur des segments, il n est pas possible d appliquer un segment sur un template avec métrique personnalisée. Existe-t-il des contraintes sur les appels API? Plus vous aurez de colonnes dans votre template, plus l URL Rest peut être longue. Il faut savoir que certains navigateurs limitent les URLs à environ 2 000 caractères : il est alors recommandé d utiliser l URL «short code». Pour toute question sur le paramétrage et l utilisation de l interface Data Query, contactez notre Service Relation Clients depuis le Digital WorkSpace NX dans l onglet Centre Support > Messages. 25
7. En savoir plus Centre d aide en ligne Accéder a l aide en ligne directement depuis : la page d analyse de votre interface (bouton [Aide]) le Centre support > Ressources > Centre d aide Formation* Pour vous accompagner dans la prise en main des analyses, notre équipe de consultants vous propose un module de formation à distance. Sources d informations complémentaires à votre disposition Guide de marquage Un guide de marquage spécifique à la fonctionnalité est disponible : dans le Centre Support > Ressources > Documents techniques à votre demande auprès de notre Centre Support Centre Support Si vous restez sans réponses à vos questions, contactez notre Service Client depuis l interface dans l onglet Centre Support > Messages * Prestation payante soumise à conditions. Pour plus d informations, contactez notre Service Relation Clients via le Centre support > Messages 26
Head office: PA LA Devèze - 8 impasse Rudolf Diesel 33700 Mérignac France RCS Bordeaux B 403 261 258 Les marques et logos figurant dans ce document sont des marques enregistrées ou non appartenant à la société AT Internet ou à des tiers. Toute utilisation, non autorisée explicitement par les titulaires des marques précitées, est strictement interdite. Toute reproduction partielle ou totale de ce document, sans autorisation expresse d AT Internet est interdite. AT Internet se réserve le droit de mettre à jour le présent document à tout moment et sans préavis. Document et informations non contractuels. AT Internet 2012