Power BI-rapporten maken met NowMetrix-gegevens

De verbinding bestaat uit twee optionele fasen:

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

• Power BI Desktop maakt de query, het gegevensmodel en het rapport.
• Power BI Service publiceert het rapport voor toegang via de browser, delen en geplande vernieuwing.

Het voorbereide voorbeeld importeert de laatste 30 beschikbare dagelijkse rijen uit /v1/overview. Elke rij bevat de datum, tracker, tijdzone van de tracker, Pageviews en bezoeken.

U hebt het volgende nodig:

• een NowMetrix-account met toegang tot de REST API,
• toegang tot de tracker waarover u wilt rapporteren,
• Microsoft Power BI Desktop om het rapport te maken, en
• een geschikt Power BI-account en een geschikte werkruimte als u rapporten wilt publiceren of vernieuwingen wilt plannen.

Microsoft en de beheerder van uw organisatie beheren Power BI-licenties, werkruimtemachtigingen en beschikbare vernieuwingsfrequenties. U kunt de configuratie in Desktop voltooien zonder het rapport te publiceren.

1. Meld u aan bij NowMetrix.
2. Open Instellingen → API.
3. Maak een nieuwe sleutel met het label Microsoft Power BI.
4. Kopieer de volledige sleutel onmiddellijk. Deze wordt maar één keer weergegeven.
5. Noteer de tracker-ID van de website die u wilt importeren.

1. Open Power BI Desktop en maak een leeg rapport.
2. Selecteer Start → Gegevens ophalen → Lege query. Staat deze optie er niet bij, selecteer dan Gegevens ophalen → Meer en zoek naar Lege query.
3. De Power Query-editor wordt geopend met een nieuwe query.
4. Selecteer Start → Geavanceerde editor.

Kies voor dit voorbeeld niet het standaarddialoogvenster Web. De geavanceerde editor wordt gebruikt omdat NowMetrix een Bearer-autorisatieheader vereist en de respons van JSON moet worden omgezet naar tabelrijen.

1. Verwijder de bestaande inhoud uit de geavanceerde editor.
2. Plak de volledige query hieronder.
3. Vervang nm_YOUR_KEY en TRACKER_ID op de eerste twee regels.
4. Laat beide waarden tussen aanhalingstekens staan.
5. Selecteer Gereed.

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

De query gebruikt een vaste basis-URL in combinatie met RelativePath en Query. Hierdoor blijft de bron voorspelbaar bij latere vernieuwingen en wordt de API-sleutel uitsluitend in de HTTPS-Authorization-header verzonden.

Power BI kan vragen hoe verbinding moet worden gemaakt met https://api.nowmetrix.com.

1. Kies Anoniem.
2. Pas de instelling toe op https://api.nowmetrix.com.
3. Selecteer Verbinden.
4. Als u wordt gevraagd een privacyniveau te kiezen, selecteert u het niveau dat uw organisatie vereist. Privé zorgt voor de striktste scheiding van andere gegevensbronnen.

1. Wacht totdat in het queryvoorbeeld date, tracker, timezone, pageviews en visits worden weergegeven.
2. Wijzig de naam van de query in NowMetrix Daily.
3. Selecteer Start → Sluiten en toepassen.
4. Open de weergave Gegevens en controleer of de rijen en kolomtypen correct zijn.

Met een eenvoudig rapport kunt u controleren of de geïmporteerde velden correct werken:

1. Ga terug naar de weergave Rapport.
2. Voeg een Lijndiagram toe.
3. Plaats date op de X-as.
4. Plaats pageviews en visits op de Y-as.
5. Voeg twee Kaart-visualisaties toe voor de sommen van pageviews en visits.
6. Voeg eventueel tracker als slicer toe wanneer het model later meerdere trackers bevat.

Selecteer Start → Vernieuwen om de volledige vernieuwing in Desktop te testen. Bestaande visualisaties worden bijgewerkt zodra de query is voltooid.

1. Sla het PBIX-bestand op een beveiligde locatie op.
2. Selecteer in Power BI Desktop Start → Publiceren.
3. Meld u aan met het Power BI-account van uw organisatie.
4. Selecteer de gewenste werkruimte.
5. Open het gepubliceerde rapport vanuit het bevestigingsvenster.

Publicatie maakt een rapport en een bijbehorend semantisch model. Geplande vernieuwing wordt geconfigureerd op het semantische model, niet op een afzonderlijke grafiek of rapportpagina.

1. Open de werkruimte in Power BI Service.
2. Zoek het semantische model dat door het gepubliceerde PBIX-bestand is gemaakt.
3. Open Instellingen of selecteer Vernieuwen → Vernieuwing plannen.
4. Bewerk onder Aanmeldgegevens voor gegevensbron de aanmeldgegevens voor https://api.nowmetrix.com.
5. Selecteer Anoniem als verificatiemethode en kies het privacyniveau dat uw organisatie vereist.
6. Schakel het vernieuwingsschema in en selecteer een geschikte frequentie en tijdzone.
7. Schakel meldingen over mislukte vernieuwingen in voor de eigenaar van het semantische model of een andere verantwoordelijke.
8. Sla de instellingen op, selecteer Nu vernieuwen en bekijk Vernieuwingsgeschiedenis.

De beschikbare vernieuwingsfrequenties zijn afhankelijk van de Power BI-licentie en de capaciteit van de werkruimte. Microsoft beschrijft de actuele instellingen, limieten, het gedrag bij fouten en de vernieuwingsgeschiedenis in de handleiding voor geplande vernieuwing.

Met Power Query-parameters kunt u de tracker eenvoudiger wijzigen of de sleutel vernieuwen zonder de volledige query te bewerken. Dit verbetert de onderhoudbaarheid, maar parameters zijn geen opslag voor geheimen.

1. Selecteer in de Power Query-editor Start → Parameters beheren → Nieuwe parameter.
2. Maak een vereiste tekstparameter met de naam pNowMetrixApiKey en voer de API-sleutel in als huidige waarde.
3. Maak een tweede vereiste tekstparameter met de naam pNowMetrixTrackerId en voer de tracker-ID in.
4. Vervang de eerste twee queryregels door de onderstaande regels.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Na publicatie kunnen bewerkbare parameters in de instellingen van het semantische model worden weergegeven. De toegang tot de werkruimte moet nog steeds worden beperkt, omdat gebruikers met voldoende machtigingen de parameters kunnen bekijken of wijzigen.

Maak voor elke gegevensset een afzonderlijke Power Query en gebruik waar passend relaties in het model:

• Gebruik voor elk Power BI-semantisch model een speciale NowMetrix API-sleutel.
• Geef de NowMetrix-gebruiker alleen toegang tot de trackers die het rapport nodig heeft.
• Sla het PBIX-bestand op een beveiligde locatie op en publiceer het nooit als openbare download.
• Beschouw redacteuren van PBIX-bestanden en eigenaren van semantische modellen als vertrouwde gebruikers die de query kunnen bekijken.
• Plaats de sleutel niet in visualisaties, rapportfilters, URL’s, schermafbeeldingen of documentatie.
• Gebruik de kleinst mogelijke doelgroep voor de Power BI-werkruimte die aan de rapportagevereisten voldoet.
• Controleer vóór verspreiding de machtigingen voor rapporten, werkruimten, apps, maken, opnieuw delen en downloaden.
• Trek de sleutel onmiddellijk in als het PBIX-bestand, de werkruimte of het eigenaarsaccount mogelijk is gecompromitteerd.
• Controleer bij een wijziging van eigenaar of de aanmeldgegevens voor vernieuwing en meldingen over fouten nog werken.