Conservare le metriche di NowMetrix in Microsoft Excel

Excel richiede i dati selezionati direttamente dalla REST API di NowMetrix:

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

L'esempio di questa guida importa le ultime 30 righe giornaliere disponibili da /v1/overview. Ogni riga contiene una data, il tracker, il fuso orario del tracker, i Pageview e le visite. Quando si aggiorna la query, la tabella importata viene sostituita con la risposta più recente dell'API.

Occorrono:

• un account NowMetrix con accesso alla REST API,
• l'accesso al tracker da esportare,
• Microsoft Excel con Power Query,
• l'autorizzazione a creare e aggiornare connessioni dati esterne.

In Windows, Power Query è disponibile in Dati → Recupera dati. Nelle versioni attuali di Microsoft 365 per macOS, usare Dati → Recupera dati (Power Query). I nomi dei menu possono variare leggermente in base alla versione e alla lingua di Excel.

Se non si trova l'Editor di Power Query su Mac, aggiornare prima Microsoft 365. Microsoft descrive il flusso di lavoro attuale per Mac nella guida di Power Query per Excel per Mac.

1. Accedere a NowMetrix.
2. Aprire Impostazioni → API.
3. Creare una nuova chiave con un'etichetta chiara, ad esempio Microsoft Excel.
4. Copiare subito la chiave completa. Verrà mostrata una sola volta.
5. Annotare l'ID del tracker del sito da esportare.

Excel per Windows

1. Creare una nuova cartella di lavoro oppure aprire quella che dovrà contenere l'esportazione.
2. Selezionare Dati → Recupera dati → Da altre origini → Query vuota.
3. Nell'Editor di Power Query, selezionare Home → Editor avanzato.

Excel per macOS

1. Creare una nuova cartella di lavoro oppure aprire quella di destinazione.
2. Selezionare Dati → Recupera dati (Power Query) → Avvia l'Editor di Power Query.
3. Creare una Query vuota, quindi aprire Home → Editor avanzato.

1. Rimuovere il contenuto esistente dall'Editor avanzato.
2. Incollare la query completa riportata di seguito.
3. Sostituire nm_YOUR_KEY e TRACKER_ID nelle prime due righe.
4. Lasciare le virgolette intorno a entrambi i valori.
5. Selezionare Fine.

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 di base fissa, insieme a RelativePath e Query, mantiene l'indirizzo leggibile e impedisce che la chiave API compaia nell'URL. La chiave viene inviata solo nell'header HTTPS Authorization.

Excel potrebbe chiedere come connettersi a https://api.nowmetrix.com.

1. Scegliere Anonimo.
2. Applicare l'impostazione a https://api.nowmetrix.com.
3. Selezionare Connetti.
4. Se viene richiesto un livello di privacy, selezionare quello previsto dall'organizzazione. Privato offre la separazione più rigorosa dalle altre origini dati.

1. Attendere che l'anteprima di Power Query mostri cinque colonne.
2. Se necessario, rinominare la query in NowMetrix Daily.
3. Selezionare Home → Chiudi e carica.
4. Excel crea una tabella nel foglio di lavoro con le righe importate.

È ora possibile creare formule, grafici, tabelle pivot o altri fogli di lavoro che facciano riferimento a questa tabella. Conservare note e calcoli manuali al di fuori della tabella importata, perché un aggiornamento può ridimensionarne o sostituirne le righe.

Aggiornamento manuale

Selezionare Dati → Aggiorna tutto. Excel esegue nuovamente la query e sostituisce le righe importate.

Aggiornamento all'apertura della cartella di lavoro

1. Aprire Dati → Query e connessioni.
2. Fare clic con il pulsante destro del mouse su NowMetrix Daily e selezionare Proprietà.
3. Attivare Aggiorna dati all'apertura del file.

Aggiornamento a intervalli regolari

1. Aprire le proprietà della stessa query.
2. Attivare Aggiorna ogni e inserire un intervallo, ad esempio 60 minuti.
3. Salvare la cartella di lavoro.

Evitare aggiornamenti più frequenti del necessario. Il limite dell'API NowMetrix è condiviso tra chiavi API e utenti per ciascun tracker. Microsoft spiega le impostazioni delle connessioni Excel nella guida all'aggiornamento dei dati esterni.

La REST API offre diversi dataset per esigenze di reportistica differenti:

• Usare una chiave NowMetrix separata, identificata con un'etichetta per questa cartella di lavoro.
• Concedere all'utente NowMetrix solo l'accesso al tracker necessario per l'esportazione.
• Non salvare la chiave API in una cella del foglio di lavoro, formula, URL, screenshot o commento.
• Non caricare la cartella di lavoro in un'area pubblica per i download.
• Condividere la cartella di lavoro solo con chi è autorizzato a usare la chiave API.
• Considerare ogni persona che modifica la cartella di lavoro in grado di ispezionare Power Query e leggere la chiave.
• Proteggere l'accesso a OneDrive o SharePoint se la cartella di lavoro è archiviata in uno di questi servizi.
• Revocare immediatamente la chiave dedicata se la cartella di lavoro o l'account potrebbero essere stati compromessi.
• Dopo aver ruotato la chiave, aggiornare la prima riga della query e aggiornare la cartella di lavoro.