Export · Microsoft Power BI

Power-BI-Bericht mit NowMetrix-Date erstelle

NowMetrix-Metrike mit Power Query importiere, de erscht Bericht i Power BI Desktop erstelle und s’Dataset für kontrollierts Teile und regelmässigi Aktualisierige veröffentliche.

So funktioniert d’Verbindig

D’Verbindig het zwei optionali Stufe:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service
  • Power BI Desktop erstellt d’Abfrag, s’Datenmodell und de Bericht.
  • Power BI Service veröffentlicht de Bericht für de Zuegriff im Browser, zum Teile und für regelmässigi Aktualisierige.

S’vorbereitete Biispil importiert di letschte 30 verfüegbare täglichi Ziile vo /v1/overview. Jedi Ziile enthält s’Datum, de Tracker, d’Ziitzone vom Tracker, Pageviews und Bsüech.

Power BI importiert es Abbild, sobald s’semantische Modell aktualisiert wird. Es unterhält kei dauerendi Live-Verbindig zu NowMetrix und sendet kei NowMetrix-Wert a Google Analytics.

Vor em Start

Si bruuched:

  • es NowMetrix-Konto mit REST-API-Zuegriff,
  • Zuegriff uf de Tracker, über de Si berichte wänd,
  • Microsoft Power BI Desktop zum Erstelle vom Bericht und
  • es passends Power-BI-Konto und en Workspace, falls Si de Bericht veröffentliche oder Aktualisierige plane wänd.
Power BI Desktop isch e Windows-Anwendig. Falls Si mit macOS schaffed, erstelled Si de Bericht i ere verwaltete Windows-virtuelle Maschine, über e externi Windows-Umgebig oder mit Hilf vo ere Kollegin oder eme Kollege mit Power BI Desktop. Veröffentlichti Bericht chönd Si denn im Webbrowser aaluege.

D’Power-BI-Lizenz, d’Workspace-Berechtigunge und d’verfüegbare Aktualisierigshüüfigkeite werdet vo Microsoft und de Administration vo Ihrer Organisation verwaltet. Si chönd d’Desktop-Iirichtig abschlüsse, ohni de Bericht z’veröffentliche.

1. En eigene API-Key erstelle

  1. Melded Si sich bi NowMetrix aa.
  2. Öffned Si Iistellige → API.
  3. Erstelled Si en neue Key mit de Bezeichnig Microsoft Power BI.
  4. Kopiered Si de vollständigi Key sofort. Er wird nume einisch azeigt.
  5. Notiered Si d’Tracker-ID vo de Website, wo Si importiere wänd.
Platzhalter Ersetze mit Biispil
nm_YOUR_KEY Ihre vollständige NowMetrix-API-Key nm_…
TRACKER_ID Tracker-ID zum Importiere news-example-com
Verwänded Si für dä Bericht en separate Key. Falls d’PBIX-Datei oder de Power-BI-Workspace offeleggt wird, chönd Si dä Key sperre, ohni Excel, Google Sheets oder e anderi Integration z’unterbräche.

2. E leeri Abfrag i Power BI Desktop erstelle

  1. Öffned Si Power BI Desktop und erstelled Si en leere Bericht.
  2. Wähled Si Start → Date abhole → Leeri Abfrag. Falls dä Punkt nöd azeigt wird, wähled Si Date abhole → Meh und sueched Si nach Leeri Abfrag.
  3. De Power Query Editor wird mit ere neue Abfrag geöffnet.
  4. Wähled Si Start → Erwiiterte Editor.

Wähled Si für das Biispil nöd de einfache Dialog Web. De Erwiiterte Editor wird verwendet, wil NowMetrix en Bearer-Autorisierigshäader bruucht und d’Antwort vo JSON i Tabälleziile umgwandle werde muess.

3. D’vorbereitete Power Query iifüege

  1. Entferned Si de bestehende Inhalt us em Erwiiterte Editor.
  2. Füeged Si d’vollständigi Abfrag underhalb i.
  3. Ersetzed Si nm_YOUR_KEY und TRACKER_ID i de erschte zwei Ziile.
  4. Lönd Si beidi Wert i Anfüehrigszeiche.
  5. Wähled Si Fertig.
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

D’Abfrag verwendet e fixe Basis-URL mit RelativePath und Query. Das haltet d’Quelle für spöteri Aktualisierige berechenbar und sendet de API-Key nur im HTTPS- Authorization-Header.

4. D’Zuegangsdate vo de Datequälle bestätige

Power BI fragt Si villicht, wie s’mit https://api.nowmetrix.com verbunde söll.

  1. Wähled Si Anonym.
  2. Wänded Si d’Iistellig uf https://api.nowmetrix.com aa.
  3. Wähled Si Verbinde.
  4. Falls Si nach ere Dateschutzstufe gfrögt werded, wähled Si d’Stufe, wo Ihri Organisation verlangt. Privat bietet di strengschti Trennig vo andere Datequälle.
D’Verbindig isch für NowMetrix nöd anonym. Anonym seit Power BI, dass es kei zweiti Microsoft-Zuegangsmethode söll hinzuefüege. D’Abfrag authentifiziert sich bereits mit em NowMetrix-API-Key i ihrem Bearer-Header.

5. S’semantische Modell lade und prüefe

  1. Warted Si, bis d’Abfragevorschau date, tracker, timezone, pageviews und visits azeigt.
  2. Bennened Si d’Abfrag i NowMetrix Daily um.
  3. Wähled Si Start → Schliesse & Anwände.
  4. Öffned Si d’Ansicht Date und prüefed Si, ob Ziile und Spaltetüüpe stimmed.
Spalte Empfohlene Power-BI-Typ
dateDatum
trackerText
timezoneText
pageviewsGanzzahl
visitsGanzzahl

6. En erschte Bericht erstelle

En eifache Bericht zeigt, ob sich d’importierte Fälder richtig verhalte:

  1. Göhnd Si zrugg zur Ansicht Bericht.
  2. Füeged Si en Liniendiagramm i.
  3. Leged Si date uf d’X-Achse.
  4. Leged Si pageviews und visits uf d’Y-Achse.
  5. Füeged Si zwei Karte-Visualisierige für d’Summe vo pageviews und visits i.
  6. Füeged Si optional tracker als Filter i, falls s’Modell spöter mehri Tracker enthält.

Wähled Si Start → Aktualisiere, zum d’vollständigi Aktualisierig im Desktop z’teschte. Bestehendi Visualisierige werde aktualisiert, sobald d’Abfrag fertig isch.

7. Im Power BI Service veröffentliche

  1. Speichered Si d’PBIX-Datei a ere gschützte Stell.
  2. Wähled Si i Power BI Desktop Start → Veröffentliche.
  3. Melded Si sich mit em Power-BI-Konto vo Ihrer Organisation aa.
  4. Wähled Si de vorgsehne Workspace.
  5. Öffned Si de veröffentlichte Bericht us em Bestätigungsdialog.
Veröffentliched Si de Bericht nöd über en öffentliche Weblink. Bi de Veröffentlichig werde d’Abfrag und d’importierte Date i de Power-BI-Umgebig vo Ihrer Organisation abgleit. Workspace-Mitglieder und Bsitzer vom semantische Modell müend vertrauenswürdig sii, damit sie mit dene Date und em API-Zuegriff richtig umgönd.

D’Veröffentlichig erstellt en Bericht und es dezueghörends semantischs Modell. D’regelmässigi Aktualisierig wird am semantische Modell iigrichtet, nöd a ere einzelne Chart oder Berichtsiite.

8. Regelmässigi Aktualisierig iirichte

  1. Öffned Si de Workspace im Power BI Service.
  2. Sueched Si s’semantische Modell, wo vo de veröffentlichten PBIX-Datei erstellt worde isch.
  3. Öffned Si Iistellige oder wähled Si Aktualisiere → Aktualisierig plane.
  4. Bearbeited Si under Zuegangsdate vo de Datequälle d’Zuegangsdate für https://api.nowmetrix.com.
  5. Wähled Si Anonym als Authentisierigsart und d’Dateschutzstufe, wo Ihri Organisation verlangt.
  6. Aktiviered Si de Aktualisierigsplan und wähled Si e passendi Hüüfigkeit und Ziitzone.
  7. Aktiviered Si Benachrichtigige bi Aktualisierigfäler für de Bsitzer vom semantische Modell oder e anderi zuständigi Person.
  8. Speichered Si d’Iistellige, wähled Si Jetzt aktualisiere und prüefed Si d’Aktualisierigshistorie.
NowMetrix isch e öffentlichi HTTPS-Cloud-Quelle. Normalerwiis bruuched Si kei lokale Datengateway, wenn de Power BI Service api.nowmetrix.com erreiche cha. D’Abfrag verwendet absichtlich RelativePath und Query. Das sind unterstützti Uusnahme für aktualisierbari Web-Abfrage mit variable Abfrageparameter.
Falls Power BI nur d’Basis-URL prüeft und Verbindigstest überspringe aabietet, aktiviered Si die Option. D’Basis-URL allei isch kei vollständigi NowMetrix-API-Anfrag. Falls Ihri Organisation selber verfassti Web-Abfrage oder externi Cloud-Quelle sperrt, bitted Si de Power-BI-Administrator, d’Iistellige vom semantische Modell z’prüefe.

D’verfüegbare Aktualisierigs-Hüüfigkeite hänged vo de Power-BI-Lizenz und de Workspace-Kapazität ab. Microsoft beschreibt d’aktuelle Steuerige, Limite, s’Verhalte bi Fähler und d’Aktualisierigshistorie i de Anleitig zur geplante Aktualisierig.

Optional: Key und Tracker konfigurierbar mache

Mit Power-Query-Parameter chönd Si de Tracker einfacher ändere oder de Key erneuere, ohni d’ganzi Abfrag z’bearbeite. Das erleichteret d’Pfleg, isch aber kei Geheimnisspeicher.

  1. Wähled Si im Power Query Editor Start → Parameter verwalte → Neue Parameter.
  2. Erstelled Si en erforderliche Textparameter mit em Name pNowMetrixApiKey und gänd Si de API-Key als aktuelle Wert ii.
  3. Erstelled Si en zweite erforderliche Textparameter mit em Name pNowMetrixTrackerId und gänd Si d’Tracker-ID ii.
  4. Ersetzed Si d’erschte zwei Abfragziile mit dene Ziile:
    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Nach de Veröffentlichig chönd bearbeitbari Parameter i de Iistellige vom semantische Modell azeigt werde. De Workspace-Zuegriff muess trotzdem iigschränkt sii, wil Lüüt mit gnueg Berechtigung die Parameter aaluege oder ändere chönd.

Anderi NowMetrix-Dataset hinzuefüege

Erstelled Si für jedes Dataset e separati Power Query und verwänded Si, falls sinnvoll, Beziehige im Modell:

Anwendungsfall Endpoint Hinwiis zum Modell
Täglichi Pageviews und Bsüech /v1/overview E Ziile pro Tracker und Datum
Top-Siite für abgloffeni Ziitruum /v1/recap D’angefordereti Spanne mit jedem importierte Ergebnis speichere
Aktuelli Live-Artikel /v1/realtime Bi ere Aktualisierig wird s’Abbild ersetzt, usser Si baued e separate Verlaufsspeicherig
Aktuelli Quälle /v1/sources Verwänded Si de Antwort-Ziitstempel, wenn Si Abbilder kombiniere
Textprüefig-Probleme /v1/proofreading Schränked Si de Berichtszuegriff uf s’zuständige Redaktionsteam ii
Jede Endpoint liefert e anderi JSON-Struktur. Es längt nöd, s’Biispil z’kopiere und nur RelativePath z’ändere. D’nei Antwort wird susch nöd richtig umgwandle. Passed Si d Schritt nach Response anhand vom dokumentierte Antwort-Biispil vom Endpoint aa.

Checkliste für Sicherheit und Teile

  • Verwänded Si für jedes Power-BI-Modell en eigene NowMetrix-API-Key.
  • Gänd Si em NowMetrix-Nutzer nur de Tracker-Zuegriff, wo de Bericht bruucht.
  • Speichered Si d’PBIX-Datei a ere gschützte Stell und veröffentliched Si sie nie als öffentliche Download.
  • Behandled Si PBIX-Bearbeiter und Bsitzer vom semantische Modell als vertrauenswürdigi Nutzer, wo d’Abfrag chönd aaluege.
  • Platziered Si de Key nöd i Visualisierige, Berichtsfilter, URLs, Screenshots oder Dokumentation.
  • Verwänded Si de chliinstmögliche Power-BI-Workspace-Kreis, wo d’Berichtsanforderig erfüllt.
  • Prüefed Si vor de Verteilige d’Berechtigunge für Bericht, Workspace, App, Erstelle, Weiterteile und Download.
  • Sperred Si de Key sofort, falls d’PBIX-Datei, de Workspace oder s’Besitzerkonto chönnt kompromittiert worde sii.
  • Wenn d’Zueständigkeit wechslet, prüefed Si, ob d’Aktualisierigsdaten und d’Fählerbenachrichtigige no funktioniered.
Power-Query-Parameter sind Konfigurationswert, kei Geheimnis. Egal, ob de Key direkt i de Abfrag staht oder über en Parameter iigäh wird: De Zuegriff uf d’PBIX-Datei und s’semantische Modell muess iigschränkt bliibe.

Problem löse

Problem Was Si prüefe sötted
Power BI fragt immer wieder nach de Zuegangsdate Unter Datei → Optione und Iistellige → Iistellige vo de Datequälle d’Berechtigunge für https://api.nowmetrix.com lösche, neu verbinde und Anonym wähle.
401 oder «Zuegriff uf d’Ressource verweigeret» Prüefed Si, ob de vollständige Key nm_YOUR_KEY ersetzt, kei Leerzeiche enthält und nöd gsperrt worde isch.
403 De Key het kei Zuegriff uf de konfigurierte Tracker. Prüefed Si TRACKER_ID und d’Tracker-Berechtigunge vom NowMetrix-Nutzer.
429 D’API-Limite für de Tracker isch überschritte worde. Warted Si und verringered Si d’Hüüfigkeit vo geplante oder manuelle Aktualisierige.
503 S Analytics-Backend isch vorübergehend nöd verfüegbar. Behalted Si s’bestehende semantische Modell und probiered Si es spöter nomal.
Desktop-Aktualisierig funktioniert, Service-Aktualisierig nöd Prüefed Si d’Datequälle-Zuegangsdate, de Bsitzer, d’Dateschutzstufe, d’Aktualisierigshistorie und ob Ihri Administration Cloud-Webquelle oder selber verfassti Abfrage sperrt.
Power BI meldet e dynamischi Datequälle Stelled Si sicher, dass d’Abfrag no d’fixi Basis-URL https://api.nowmetrix.com mit RelativePath und Query verwendet. Baued Si d vollständigi URL nöd durch Verketti vo Text zäme.
D’geplanti Aktualisierig isch deaktiviert Öffned Si d’Aktualisierigshistorie, lösed Si de letschte Fähler, prüefed Si d’Zuegangsdate und aktiviered Si de Plan wieder. Power BI cha Plän nach wiederholte Fähler oder Inaktivität pausiere.
D’Gateway-Konfiguration wird unerwartet azeigt Prüefed Si, ob Power BI d’Quelle als erreichbari Cloud-Webquelle iistuft. Bitted Si de Workspace-Administrator, Gateway- und Cloud-Verbindigs-Iistellige z’prüefe.