Power-BI-Berichte mit NowMetrix-Daten erstellen

Die Verbindung umfasst zwei optionale Stufen:

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

• Power BI Desktop erstellt die Abfrage, das Datenmodell und den Bericht.
• Power BI Service veröffentlicht den Bericht für den Zugriff im Browser, zum Teilen und für geplante Aktualisierungen.

Das vorbereitete Beispiel importiert die letzten 30 verfügbaren Tageszeilen aus /v1/overview. Jede Zeile enthält das Datum, den Tracker, die Zeitzone des trackers, Pageviews und Besuche.

Sie benötigen:

• ein NowMetrix-Konto mit Zugriff auf die REST API,
• Zugriff auf den Tracker, über den Sie berichten möchten,
• Microsoft Power BI Desktop zum Erstellen des Berichts und
• ein geeignetes Power-BI-Konto und einen Arbeitsbereich, wenn Sie Berichte veröffentlichen oder Aktualisierungen planen möchten.

Die Power-BI-Lizenzierung, Berechtigungen für Arbeitsbereiche und verfügbaren Aktualisierungsintervalle werden von Microsoft und der Administration Ihrer Organisation verwaltet. Sie können die Einrichtung in Desktop abschliessen, ohne den Bericht zu veröffentlichen.

1. Melden Sie sich bei NowMetrix an.
2. Öffnen Sie Einstellungen → API.
3. Erstellen Sie einen neuen Schlüssel mit der Bezeichnung Microsoft Power BI.
4. Kopieren Sie den vollständigen Schlüssel sofort. Er wird nur einmal angezeigt.
5. Notieren Sie die Tracker-ID der Website, die Sie importieren möchten.

1. Öffnen Sie Power BI Desktop und erstellen Sie einen leeren Bericht.
2. Wählen Sie Start → Daten abrufen → Leere Abfrage. Falls der Eintrag nicht angezeigt wird, wählen Sie Daten abrufen → Mehr und suchen Sie nach Leere Abfrage.
3. Der Power Query-Editor wird mit einer neuen Abfrage geöffnet.
4. Wählen Sie Start → Erweiterter Editor.

Wählen Sie für dieses Beispiel nicht den einfachen Dialog Web. Der Erweiterte Editor wird verwendet, weil NowMetrix einen Bearer-Header zur Autorisierung erfordert und die Antwort von JSON in Tabellenzeilen umgewandelt werden muss.

1. Entfernen Sie den vorhandenen Inhalt aus dem Erweiterten Editor.
2. Fügen Sie die vollständige Abfrage unten ein.
3. Ersetzen Sie nm_YOUR_KEY und TRACKER_ID in den ersten beiden Zeilen.
4. Belassen Sie beide Werte in Anführungszeichen.
5. Wählen Sie 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

Die Abfrage verwendet eine feste Basis-URL zusammen mit RelativePath und Query. Dadurch bleibt die Quelle für spätere Aktualisierungen vorhersehbar, und der API-Schlüssel wird nur im HTTPS- Authorization-Header übertragen.

Power BI fragt möglicherweise, wie die Verbindung zu https://api.nowmetrix.com hergestellt werden soll.

1. Wählen Sie Anonym.
2. Übernehmen Sie die Einstellung für https://api.nowmetrix.com.
3. Wählen Sie Verbinden.
4. Wenn Sie nach einer Datenschutzstufe gefragt werden, wählen Sie die von Ihrer Organisation vorgeschriebene Stufe. Privat bietet die strengste Trennung von anderen Datenquellen.

1. Warten Sie, bis die Abfragevorschau date, tracker, timezone, pageviews und visits anzeigt.
2. Benennen Sie die Abfrage in NowMetrix Daily um.
3. Wählen Sie Start → Schliessen und übernehmen.
4. Öffnen Sie die Ansicht Daten und bestätigen Sie, dass Zeilen und Spaltentypen korrekt sind.

Mit einem einfachen Bericht lässt sich überprüfen, ob die importierten Felder korrekt funktionieren:

1. Wechseln Sie zurück zur Ansicht Bericht.
2. Fügen Sie ein Liniendiagramm hinzu.
3. Platzieren Sie date auf der X-Achse.
4. Platzieren Sie pageviews und visits auf der Y-Achse.
5. Fügen Sie zwei Karten für die Summen von pageviews und visits hinzu.
6. Fügen Sie optional tracker als Datenschnitt hinzu, wenn das Modell später mehrere Tracker enthält.

Wählen Sie Start → Aktualisieren, um die vollständige Aktualisierung in Desktop zu testen. Vorhandene Visualisierungen werden aktualisiert, sobald die Abfrage abgeschlossen ist.

1. Speichern Sie die PBIX-Datei an einem geschützten Ort.
2. Wählen Sie in Power BI Desktop Start → Veröffentlichen.
3. Melden Sie sich mit dem Power-BI-Konto Ihrer Organisation an.
4. Wählen Sie den vorgesehenen Arbeitsbereich.
5. Öffnen Sie den veröffentlichten Bericht über den Bestätigungsdialog.

Durch die Veröffentlichung werden ein Bericht und ein zugehöriges semantisches Modell erstellt. Die geplante Aktualisierung wird für das semantische Modell konfiguriert, nicht für ein einzelnes Diagramm oder eine einzelne Berichtsseite.

1. Öffnen Sie den Arbeitsbereich in Power BI Service.
2. Suchen Sie das durch die veröffentlichte PBIX-Datei erstellte semantische Modell.
3. Öffnen Sie Einstellungen oder wählen Sie Aktualisieren → Aktualisierung planen.
4. Bearbeiten Sie unter Anmeldedaten der Datenquelle die Anmeldedaten für https://api.nowmetrix.com.
5. Wählen Sie Anonym als Authentifizierungsmethode und die von Ihrer Organisation vorgeschriebene Datenschutzstufe.
6. Aktivieren Sie den Aktualisierungszeitplan und wählen Sie ein geeignetes Intervall und eine Zeitzone.
7. Aktivieren Sie Benachrichtigungen bei fehlgeschlagenen Aktualisierungen für die verantwortliche Person des semantischen Modells oder eine andere zuständige Person.
8. Speichern Sie die Einstellungen, wählen Sie Jetzt aktualisieren und prüfen Sie den Aktualisierungsverlauf.

Die verfügbaren Aktualisierungsintervalle hängen von der Power-BI-Lizenz und der Kapazität des Arbeitsbereichs ab. Microsoft beschreibt die aktuellen Einstellungen, Beschränkungen, das Verhalten bei Fehlern und den Aktualisierungsverlauf in seiner Anleitung zur geplanten Aktualisierung.

Mit Power-Query-Parametern können Sie den Tracker einfacher ändern oder den Schlüssel austauschen, ohne die gesamte Abfrage zu bearbeiten. Sie verbessern die Wartbarkeit, sind aber kein sicherer Speicher für Geheimnisse.

1. Wählen Sie im Power Query-Editor Start → Parameter verwalten → Neuer Parameter.
2. Erstellen Sie einen erforderlichen Textparameter mit dem Namen pNowMetrixApiKey und tragen Sie den API-Schlüssel als aktuellen Wert ein.
3. Erstellen Sie einen weiteren erforderlichen Textparameter mit dem Namen pNowMetrixTrackerId und tragen Sie die Tracker-ID ein.
4. Ersetzen Sie die ersten beiden Abfragezeilen durch die folgenden Zeilen.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Nach der Veröffentlichung können bearbeitbare Parameter in den Einstellungen des semantischen Modells erscheinen. Der Zugriff auf den Arbeitsbereich muss dennoch eingeschränkt bleiben, da Personen mit ausreichenden Berechtigungen die Parameter einsehen oder ändern können.

Erstellen Sie für jeden Datensatz eine separate Power Query und verwenden Sie bei Bedarf Beziehungen im Modell:

• Verwenden Sie für jedes semantische Power-BI-Modell einen eigenen NowMetrix API-Schlüssel.
• Gewähren Sie dem NowMetrix-Benutzer nur den für den Bericht erforderlichen Zugriff auf den Tracker.
• Speichern Sie die PBIX-Datei an einem geschützten Ort und veröffentlichen Sie sie niemals als öffentlichen Download.
• Betrachten Sie Bearbeiter der PBIX-Datei und Verantwortliche für das semantische Modell als vertrauenswürdige Benutzer, die die Abfrage einsehen können.
• Platzieren Sie den Schlüssel nicht in Visualisierungen, Berichtsfiltern, URLs, Screenshots oder Dokumentationen.
• Verwenden Sie den kleinsten Kreis von Arbeitsbereichsmitgliedern, der die Anforderungen an den Bericht erfüllt.
• Prüfen Sie vor der Verteilung die Berechtigungen zum Anzeigen, für Arbeitsbereich, App, Erstellen, erneuten Teilen und Herunterladen.
• Widerrufen Sie den Schlüssel sofort, wenn die PBIX-Datei, der Arbeitsbereich oder das Benutzerkonto der verantwortlichen Person möglicherweise kompromittiert wurde.
• Bestätigen Sie bei einem Wechsel der Zuständigkeit, dass die Anmeldedaten für die Aktualisierung und die Benachrichtigungen bei Fehlern weiterhin funktionieren.