Conserver les métriques NowMetrix dans Microsoft Excel

Excel demande directement les données sélectionnées à l’API REST NowMetrix :

NowMetrix REST API → Power Query → Excel table → charts, formulas, or PivotTables

L’exemple de ce guide importe les 30 dernières lignes quotidiennes disponibles depuis /v1/overview. Chaque ligne contient une date, un tracker, le fuseau horaire du tracker, le nombre de pages vues et le nombre de visites. L’actualisation de la requête remplace le tableau importé par la dernière réponse de l’API.

Vous avez besoin des éléments suivants :

• un compte NowMetrix avec accès à l’API REST ;
• un accès au tracker à exporter ;
• Microsoft Excel avec Power Query ;
• l’autorisation de créer et d’actualiser des connexions de données externes.

Sous Windows, Power Query est disponible via Données → Obtenir des données. Dans les versions actuelles de Microsoft 365 pour macOS, utilisez Données → Obtenir des données (Power Query). Les noms des menus peuvent légèrement varier selon la version et la langue d’Excel.

Si vous ne trouvez pas l’éditeur Power Query sur un Mac, commencez par mettre Microsoft 365 à jour. Microsoft décrit la procédure actuelle pour Mac dans son guide Power Query pour Excel sur Mac.

1. Connectez-vous à NowMetrix.
2. Ouvrez Paramètres → API.
3. Créez une clé avec un libellé explicite, par exemple Microsoft Excel.
4. Copiez immédiatement la clé complète. Elle ne s’affiche qu’une seule fois.
5. Notez l’ID du tracker correspondant au site à exporter.

Excel pour Windows

1. Créez un classeur ou ouvrez celui qui doit contenir l’exportation.
2. Sélectionnez Données → Obtenir des données → À partir d’autres sources → Requête vide.
3. Dans l’éditeur Power Query, sélectionnez Accueil → Éditeur avancé.

Excel pour macOS

1. Créez un classeur ou ouvrez le classeur cible.
2. Sélectionnez Données → Obtenir des données (Power Query) → Lancer l’éditeur Power Query.
3. Créez une Requête vide, puis ouvrez Accueil → Éditeur avancé.

1. Supprimez le contenu existant dans l’éditeur avancé.
2. Collez la requête complète ci-dessous.
3. Remplacez nm_YOUR_KEY et TRACKER_ID dans les deux premières lignes.
4. Conservez les guillemets autour des deux valeurs.
5. Sélectionnez Terminé.

let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

L’URL de base fixe, associée à RelativePath et Query, permet de conserver une adresse lisible et d’éviter que la clé API apparaisse dans l’URL. La clé est envoyée uniquement dans l’en-tête HTTPS Authorization.

Excel peut vous demander comment se connecter à https://api.nowmetrix.com.

1. Choisissez Anonyme.
2. Appliquez ce paramètre à https://api.nowmetrix.com.
3. Sélectionnez Se connecter.
4. Si un niveau de confidentialité est demandé, sélectionnez celui requis par votre organisation. Privé offre la séparation la plus stricte par rapport aux autres sources de données.

1. Attendez que l’aperçu Power Query affiche cinq colonnes.
2. Si nécessaire, renommez la requête en NowMetrix Daily.
3. Sélectionnez Accueil → Fermer et charger.
4. Excel crée un tableau dans une feuille de calcul avec les lignes importées.

Vous pouvez maintenant créer des formules, des graphiques, des tableaux croisés dynamiques ou des feuilles supplémentaires qui font référence à ce tableau. Conservez les notes et calculs manuels en dehors du tableau importé, car une actualisation peut redimensionner ou remplacer ses lignes.

Actualisation manuelle

Sélectionnez Données → Actualiser tout. Excel exécute à nouveau la requête et remplace les lignes importées.

Actualisation à l’ouverture du classeur

1. Ouvrez Données → Requêtes et connexions.
2. Cliquez avec le bouton droit sur NowMetrix Daily, puis sélectionnez Propriétés.
3. Activez Actualiser les données lors de l’ouverture du fichier.

Actualisation à intervalles réguliers

1. Ouvrez les propriétés de la même requête.
2. Activez Actualiser toutes les, puis saisissez un intervalle tel que 60 minutes.
3. Enregistrez le classeur.

Évitez les actualisations inutilement fréquentes. La limite de l’API NowMetrix est partagée entre les clés API et les utilisateurs pour chaque tracker. Microsoft explique les paramètres de connexion d’Excel dans son guide sur l’actualisation des données externes.

L’API REST fournit plusieurs jeux de données pour répondre à différents besoins de rapports :

• Utilisez une clé NowMetrix distincte, libellée pour ce classeur.
• Accordez à l’utilisateur NowMetrix uniquement l’accès au tracker nécessaire pour l’exportation.
• Ne stockez pas la clé API dans une cellule, une formule, une URL, une capture d’écran ou un commentaire.
• Ne téléversez pas le classeur dans un espace de téléchargement public.
• Partagez le classeur uniquement avec les personnes autorisées à utiliser la clé API.
• Considérez que chaque personne pouvant modifier le classeur peut inspecter la requête Power Query et lire sa clé.
• Protégez l’accès à OneDrive ou SharePoint si le classeur y est stocké.
• Révoquez immédiatement la clé dédiée si le classeur ou le compte a pu être compromis.
• Après avoir renouvelé une clé, mettez à jour la première ligne de la requête et actualisez le classeur.