Creare report Power BI con i dati di NowMetrix

Il collegamento prevede due fasi facoltative:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service

• Power BI Desktop crea la query, il modello dati e il report.
• Power BI Service pubblica il report per consentirne l'accesso dal browser, la condivisione e l'aggiornamento pianificato.

L'esempio pronto importa le ultime 30 righe giornaliere disponibili da /v1/overview. Ogni riga include la data, il tracker, il fuso orario del tracker, i Pageview e le visite.

Occorrono:

• un account NowMetrix con accesso alla REST API;
• accesso al tracker per il quale desidera creare il report;
• Microsoft Power BI Desktop per creare il report;
• un account Power BI e un'area di lavoro adeguati, se desidera pubblicare il report o pianificarne gli aggiornamenti.

Le licenze Power BI, le autorizzazioni delle aree di lavoro e le frequenze di aggiornamento disponibili sono gestite da Microsoft e dall'amministratore della sua organizzazione. Può completare la configurazione di Desktop senza pubblicare il report.

1. Acceda a NowMetrix.
2. Apra Impostazioni → API.
3. Crei una nuova chiave con l'etichetta Microsoft Power BI.
4. Copi subito la chiave completa. Viene mostrata una sola volta.
5. Annoti l'ID del tracker relativo al sito web che desidera importare.

1. Apra Power BI Desktop e crei un report vuoto.
2. Selezioni Home → Get data → Blank query. Se l'opzione non è nell'elenco, selezioni Get data → More e cerchi Blank query.
3. Si apre l'Editor di Power Query con una nuova query.
4. Selezioni Home → Advanced Editor.

Per questo esempio non scelga la finestra di dialogo Web di base. Si utilizza l'Editor avanzato perché NowMetrix richiede un'intestazione di autorizzazione Bearer e la risposta deve essere convertita da JSON in righe di tabella.

1. Rimuova il contenuto esistente dall'Editor avanzato.
2. Incolli la query completa riportata di seguito.
3. Sostituisca nm_YOUR_KEY e TRACKER_ID nelle prime due righe.
4. Mantenga entrambi i valori tra virgolette.
5. Selezioni Done.

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

La query utilizza un URL di base fisso insieme a RelativePath e Query. In questo modo la fonte resta prevedibile per gli aggiornamenti successivi e la chiave API viene inviata solo nell'intestazione HTTPS Authorization.

Power BI potrebbe chiedere come deve connettersi a https://api.nowmetrix.com.

1. Scelga Anonymous.
2. Applichi l'impostazione a https://api.nowmetrix.com.
3. Selezioni Connect.
4. Se viene richiesto un livello di privacy, selezioni quello previsto dalla sua organizzazione. Private offre la separazione più rigorosa dalle altre fonti dati.

1. Attenda che l'anteprima della query mostri date, tracker, timezone, pageviews e visits.
2. Rinomini la query in NowMetrix Daily.
3. Selezioni Home → Close & Apply.
4. Apra la vista Data e verifichi che le righe e i tipi di colonna siano corretti.

Un report semplice conferma che i campi importati funzionino correttamente:

1. Torni alla vista Report.
2. Aggiunga un grafico a linee.
3. Inserisca date nell'asse X.
4. Inserisca pageviews e visits nell'asse Y.
5. Aggiunga due oggetti visivi Card per le somme di pageviews e visits.
6. Facoltativamente, aggiunga tracker come filtro dei dati quando il modello conterrà più tracker.

Selezioni Home → Refresh per verificare l'aggiornamento completo in Desktop. Gli oggetti visivi esistenti si aggiornano al termine della query.

1. Salvi il file PBIX in un percorso protetto.
2. In Power BI Desktop, selezioni Home → Publish.
3. Acceda con l'account Power BI della sua organizzazione.
4. Selezioni l'area di lavoro prevista.
5. Apra il report pubblicato dalla finestra di conferma.

La pubblicazione crea un report e un modello semantico associato. L'aggiornamento pianificato si configura sul modello semantico, non su un singolo grafico o su una singola pagina del report.

1. Apra l'area di lavoro in Power BI Service.
2. Individui il modello semantico creato dal file PBIX pubblicato.
3. Apra Settings oppure selezioni Refresh → Schedule refresh.
4. In Data source credentials, modifichi le credenziali per https://api.nowmetrix.com.
5. Selezioni Anonymous come metodo di autenticazione e il livello di privacy previsto dalla sua organizzazione.
6. Attivi la pianificazione degli aggiornamenti e selezioni una frequenza e un fuso orario adeguati.
7. Attivi le notifiche per gli aggiornamenti non riusciti per il proprietario del modello semantico o per un'altra persona responsabile.
8. Salvi le impostazioni, selezioni Refresh now e controlli Refresh history.

Le frequenze di aggiornamento disponibili dipendono dalla licenza Power BI e dalla capacità dell'area di lavoro. Microsoft documenta i controlli, i limiti, la gestione degli errori e la cronologia degli aggiornamenti attualmente disponibili nella guida all'aggiornamento pianificato.

I parametri di Power Query semplificano la modifica del tracker o la rotazione della chiave senza dover modificare l'intera query. Migliorano la manutenibilità, ma non sono un archivio di segreti.

1. Nell'Editor di Power Query, selezioni Home → Manage Parameters → New Parameter.
2. Crei un parametro Text obbligatorio denominato pNowMetrixApiKey e inserisca la chiave API come valore corrente.
3. Crei un altro parametro Text obbligatorio denominato pNowMetrixTrackerId e inserisca l'ID del tracker.
4. Sostituisca le prime due righe della query con quelle riportate di seguito.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Dopo la pubblicazione, i parametri modificabili potrebbero essere disponibili nelle impostazioni del modello semantico. L'accesso all'area di lavoro deve comunque essere limitato, perché gli utenti con autorizzazioni sufficienti possono esaminare o modificare questi parametri.

Crei una query Power Query separata per ogni set di dati e utilizzi le relazioni nel modello quando appropriato:

• Utilizzi una chiave API NowMetrix dedicata per ogni modello semantico Power BI.
• Conceda all'utente NowMetrix solo l'accesso ai tracker richiesto dal report.
• Conservi il file PBIX in un percorso protetto e non lo pubblichi mai come download pubblico.
• Consideri gli editor PBIX e i proprietari dei modelli semantici utenti affidabili, che possono esaminare la query.
• Non inserisca la chiave in oggetti visivi, filtri dei report, URL, screenshot o documentazione.
• Utilizzi il pubblico più ristretto dell'area di lavoro Power BI compatibile con i requisiti del report.
• Verifichi le autorizzazioni per report, area di lavoro, app, creazione, ricondivisione e download prima della distribuzione.
• Revochi immediatamente la chiave se il file PBIX, l'area di lavoro o l'account del proprietario potrebbero essere compromessi.
• Quando cambia il proprietario, verifichi che le credenziali di aggiornamento e le notifiche degli errori funzionino ancora.