Tworzenie raportów Power BI z danymi NowMetrix

Połączenie składa się z dwóch opcjonalnych etapów:

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

• Power BI Desktop tworzy zapytanie, model danych i raport.
• Power BI Service publikuje raport, aby można było korzystać z niego w przeglądarce, udostępniać go i planować jego odświeżanie.

Przygotowany przykład importuje 30 ostatnich dostępnych wierszy dziennych z endpointu /v1/overview. Każdy wiersz zawiera datę, tracker, strefę czasową trackera, liczbę odsłon i wizyt.

Potrzebne są:

• konto NowMetrix z dostępem do REST API,
• dostęp do trackera, którego ma dotyczyć raport,
• Microsoft Power BI Desktop do utworzenia raportu oraz
• odpowiednie konto i obszar roboczy Power BI, jeśli raport ma zostać opublikowany lub ma być odświeżany zgodnie z harmonogramem.

Licencjonowanie Power BI, uprawnienia do obszaru roboczego i dostępne częstotliwości odświeżania są zarządzane przez firmę Microsoft oraz administratora organizacji. Konfigurację w Power BI Desktop można ukończyć bez publikowania raportu.

1. Zalogować się do NowMetrix.
2. Otworzyć Ustawienia → API.
3. Utworzyć nowy klucz o etykiecie Microsoft Power BI.
4. Niezwłocznie skopiować cały klucz. Jest wyświetlany tylko raz.
5. Zapisać identyfikator trackera witryny, z której dane mają zostać zaimportowane.

1. Otworzyć Power BI Desktop i utworzyć pusty raport.
2. Wybrać Strona główna → Pobierz dane → Puste zapytanie. Jeśli ta opcja nie jest widoczna, wybrać Pobierz dane → Więcej i wyszukać Puste zapytanie.
3. Otworzy się Edytor Power Query z nowym zapytaniem.
4. Wybrać Strona główna → Edytor zaawansowany.

W tym przykładzie nie należy wybierać podstawowego okna dialogowego Web. Edytor zaawansowany jest potrzebny, ponieważ NowMetrix wymaga nagłówka autoryzacji Bearer, a odpowiedź musi zostać przekształcona z formatu JSON na wiersze tabeli.

1. Usunąć bieżącą zawartość z Edytora zaawansowanego.
2. Wkleić całe poniższe zapytanie.
3. Zastąpić nm_YOUR_KEY i TRACKER_ID w dwóch pierwszych wierszach.
4. Pozostawić obie wartości w cudzysłowach.
5. Wybrać Gotowe.

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

Zapytanie korzysta ze stałego bazowego adresu URL oraz właściwości RelativePath i Query. Dzięki temu źródło pozostaje przewidywalne podczas kolejnych odświeżeń, a klucz API jest przesyłany wyłącznie w nagłówku HTTPS Authorization.

Power BI może zapytać, jak ma łączyć się z adresem https://api.nowmetrix.com.

1. Wybrać Anonimowe.
2. Zastosować ustawienie do adresu https://api.nowmetrix.com.
3. Wybrać Połącz.
4. Jeśli pojawi się prośba o określenie poziomu prywatności, wybrać poziom wymagany przez organizację. Prywatne zapewnia najbardziej rygorystyczne oddzielenie od innych źródeł danych.

1. Poczekać, aż podgląd zapytania wyświetli kolumny date, tracker, timezone, pageviews i visits.
2. Zmienić nazwę zapytania na NowMetrix Daily.
3. Wybrać Strona główna → Zamknij i zastosuj.
4. Otworzyć widok Dane i potwierdzić poprawność wierszy oraz typów kolumn.

Prosty raport pozwala potwierdzić prawidłowe działanie zaimportowanych pól:

1. Wrócić do widoku Raport.
2. Dodać wykres liniowy.
3. Umieścić date na osi X.
4. Umieścić pageviews i visits na osi Y.
5. Dodać dwie wizualizacje typu Karta przedstawiające sumy pageviews i visits.
6. Opcjonalnie dodać tracker jako fragmentator, gdy model będzie zawierał wiele trackerów.

Wybrać Strona główna → Odśwież, aby przetestować pełne odświeżanie w Power BI Desktop. Istniejące wizualizacje zostaną zaktualizowane po zakończeniu zapytania.

1. Zapisać plik PBIX w chronionej lokalizacji.
2. W Power BI Desktop wybrać Strona główna → Publikuj.
3. Zalogować się za pomocą firmowego konta Power BI.
4. Wybrać właściwy obszar roboczy.
5. Otworzyć opublikowany raport z okna potwierdzenia.

Publikacja tworzy raport i powiązany z nim model semantyczny. Planowane odświeżanie konfiguruje się dla modelu semantycznego, a nie dla pojedynczego wykresu ani strony raportu.

1. Otworzyć obszar roboczy w Power BI Service.
2. Odszukać model semantyczny utworzony na podstawie opublikowanego pliku PBIX.
3. Otworzyć Ustawienia lub wybrać Odśwież → Zaplanuj odświeżanie.
4. W sekcji Dane logowania do źródła danych edytować dane logowania dla adresu https://api.nowmetrix.com.
5. Wybrać Anonimowe jako metodę uwierzytelniania oraz poziom prywatności wymagany przez organizację.
6. Włączyć harmonogram odświeżania i wybrać odpowiednią częstotliwość oraz strefę czasową.
7. Włączyć powiadomienia o błędach odświeżania dla właściciela modelu semantycznego lub innej odpowiedzialnej osoby.
8. Zapisać ustawienia, wybrać Odśwież teraz i sprawdzić Historię odświeżania.

Dostępne częstotliwości odświeżania zależą od licencji Power BI i pojemności obszaru roboczego. Firma Microsoft opisuje aktualne opcje, limity, sposób postępowania w razie błędów i historię odświeżania w przewodniku po planowanym odświeżaniu.

Parametry Power Query ułatwiają zmianę trackera lub wymianę klucza bez edytowania całego zapytania. Zwiększają łatwość utrzymania, ale nie są magazynem sekretów.

1. W Edytorze Power Query wybrać Strona główna → Zarządzaj parametrami → Nowy parametr.
2. Utworzyć wymagany parametr typu Tekst o nazwie pNowMetrixApiKey i wprowadzić klucz API jako jego bieżącą wartość.
3. Utworzyć drugi wymagany parametr typu Tekst o nazwie pNowMetrixTrackerId i wprowadzić identyfikator trackera.
4. Zastąpić dwa pierwsze wiersze zapytania poniższymi wierszami.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Po publikacji edytowalne parametry mogą być dostępne w ustawieniach modelu semantycznego. Dostęp do obszaru roboczego nadal musi być ograniczony, ponieważ osoby z odpowiednimi uprawnieniami mogą je wyświetlać lub zmieniać.

Dla każdego zbioru danych utworzyć osobne zapytanie Power Query i w razie potrzeby zastosować relacje w modelu:

• Używać osobnego klucza API NowMetrix dla każdego modelu semantycznego Power BI.
• Przyznawać użytkownikowi NowMetrix wyłącznie dostęp do trackerów wymaganych przez raport.
• Przechowywać plik PBIX w chronionej lokalizacji i nigdy nie publikować go jako publicznego pliku do pobrania.
• Traktować osoby edytujące pliki PBIX i właścicieli modeli semantycznych jako zaufanych użytkowników, którzy mogą sprawdzać zapytanie.
• Nie umieszczać klucza w wizualizacjach, filtrach raportu, adresach URL, zrzutach ekranu ani dokumentacji.
• Używać najmniejszego grona odbiorców obszaru roboczego Power BI, które spełnia wymagania raportu.
• Przed udostępnieniem sprawdzić uprawnienia do raportu, obszaru roboczego, aplikacji, tworzenia zawartości, ponownego udostępniania i pobierania.
• Niezwłocznie unieważnić klucz, jeśli istnieje ryzyko przejęcia pliku PBIX, obszaru roboczego lub konta właściciela.
• Po zmianie właściciela potwierdzić, że dane logowania do odświeżania i powiadomienia o błędach nadal działają.