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.
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.
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
- Melded Si sich bi NowMetrix aa.
- Öffned Si Iistellige → API.
- Erstelled Si en neue Key mit de Bezeichnig Microsoft Power BI.
- Kopiered Si de vollständigi Key sofort. Er wird nume einisch azeigt.
- 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 |
2. E leeri Abfrag i Power BI Desktop erstelle
- Öffned Si Power BI Desktop und erstelled Si en leere Bericht.
- 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.
- De Power Query Editor wird mit ere neue Abfrag geöffnet.
- 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
- Entferned Si de bestehende Inhalt us em Erwiiterte Editor.
- Füeged Si d’vollständigi Abfrag underhalb i.
- Ersetzed Si
nm_YOUR_KEYundTRACKER_IDi de erschte zwei Ziile. - Lönd Si beidi Wert i Anfüehrigszeiche.
- 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.
- Wähled Si Anonym.
- Wänded Si d’Iistellig uf
https://api.nowmetrix.comaa. - Wähled Si Verbinde.
- 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.
5. S’semantische Modell lade und prüefe
- Warted Si, bis d’Abfragevorschau
date,tracker,timezone,pageviewsundvisitsazeigt. - Bennened Si d’Abfrag i NowMetrix Daily um.
- Wähled Si Start → Schliesse & Anwände.
- Öffned Si d’Ansicht Date und prüefed Si, ob Ziile und Spaltetüüpe stimmed.
| Spalte | Empfohlene Power-BI-Typ |
|---|---|
date | Datum |
tracker | Text |
timezone | Text |
pageviews | Ganzzahl |
visits | Ganzzahl |
6. En erschte Bericht erstelle
En eifache Bericht zeigt, ob sich d’importierte Fälder richtig verhalte:
- Göhnd Si zrugg zur Ansicht Bericht.
- Füeged Si en Liniendiagramm i.
- Leged Si
dateuf d’X-Achse. - Leged Si
pageviewsundvisitsuf d’Y-Achse. - Füeged Si zwei Karte-Visualisierige für d’Summe vo
pageviewsundvisitsi. - Füeged Si optional
trackerals 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
- Speichered Si d’PBIX-Datei a ere gschützte Stell.
- Wähled Si i Power BI Desktop Start → Veröffentliche.
- Melded Si sich mit em Power-BI-Konto vo Ihrer Organisation aa.
- Wähled Si de vorgsehne Workspace.
- Öffned Si de veröffentlichte Bericht us em Bestätigungsdialog.
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
- Öffned Si de Workspace im Power BI Service.
- Sueched Si s’semantische Modell, wo vo de veröffentlichten PBIX-Datei erstellt worde isch.
- Öffned Si Iistellige oder wähled Si Aktualisiere → Aktualisierig plane.
- Bearbeited Si under Zuegangsdate vo de Datequälle d’Zuegangsdate für
https://api.nowmetrix.com. - Wähled Si Anonym als Authentisierigsart und d’Dateschutzstufe, wo Ihri Organisation verlangt.
- Aktiviered Si de Aktualisierigsplan und wähled Si e passendi Hüüfigkeit und Ziitzone.
- Aktiviered Si Benachrichtigige bi Aktualisierigfäler für de Bsitzer vom semantische Modell oder e anderi zuständigi Person.
- Speichered Si d’Iistellige, wähled Si Jetzt aktualisiere und prüefed Si d’Aktualisierigshistorie.
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.
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.
- Wähled Si im Power Query Editor Start → Parameter verwalte → Neue Parameter.
- Erstelled Si en erforderliche Textparameter mit em Name
pNowMetrixApiKeyund gänd Si de API-Key als aktuelle Wert ii. - Erstelled Si en zweite erforderliche Textparameter mit em Name
pNowMetrixTrackerIdund gänd Si d’Tracker-ID ii. - 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 |
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.
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. |