Vytváření reportů Power BI s daty NowMetrix

Připojení má dvě volitelné fáze:

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

• Power BI Desktop vytváří dotaz, datový model a report.
• Power BI Service publikuje report pro přístup v prohlížeči, sdílení a plánované aktualizace.

Připravený příklad importuje posledních 30 dostupných denních řádků z /v1/overview. Každý řádek obsahuje datum, tracker, časové pásmo trackeru, zobrazení stránek a návštěvy.

Budete potřebovat:

• účet NowMetrix s přístupem k REST API,
• přístup k trackeru, pro který chcete vytvořit report,
• Microsoft Power BI Desktop pro vytvoření reportu a
• odpovídající účet Power BI a pracovní prostor, pokud chcete report publikovat nebo plánovat aktualizace.

Licence Power BI, oprávnění k pracovním prostorům a dostupné frekvence aktualizací spravuje Microsoft a správce vaší organizace. Nastavení v Desktopu můžete dokončit i bez publikování reportu.

1. Přihlaste se do NowMetrix.
2. Otevřete Nastavení → API.
3. Vytvořte nový klíč s označením Microsoft Power BI.
4. Celý klíč ihned zkopírujte. Zobrazí se pouze jednou.
5. Poznamenejte si ID trackeru webu, který chcete importovat.

1. Otevřete Power BI Desktop a vytvořte prázdný report.
2. Vyberte Domů → Načíst data → Prázdný dotaz. Pokud položku nevidíte, vyberte Načíst data → Další a vyhledejte Prázdný dotaz.
3. Otevře se Editor Power Query s novým dotazem.
4. Vyberte Domů → Rozšířený editor.

Pro tento příklad nevybírejte základní dialog Web. Používá se Rozšířený editor, protože NowMetrix vyžaduje autorizační hlavičku Bearer a odpověď je třeba převést z JSON na řádky tabulky.

1. Odstraňte stávající obsah z Rozšířeného editoru.
2. Vložte celý níže uvedený dotaz.
3. Na prvních dvou řádcích nahraďte nm_YOUR_KEY a TRACKER_ID.
4. Obě hodnoty ponechte v uvozovkách.
5. Vyberte Hotovo.

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

Dotaz používá pevnou základní adresu spolu s parametry RelativePath a Query. Díky tomu zůstane zdroj při pozdějších aktualizacích předvídatelný a API klíč se odešle pouze v hlavičce HTTPS Authorization.

Power BI se může zeptat, jak se má připojit k https://api.nowmetrix.com.

1. Vyberte Anonymní.
2. Nastavení použijte pro https://api.nowmetrix.com.
3. Vyberte Připojit.
4. Pokud se zobrazí výzva k nastavení úrovně ochrany osobních údajů, vyberte úroveň požadovanou vaší organizací. Soukromé poskytuje nejpřísnější oddělení od ostatních zdrojů dat.

1. Počkejte, až se v náhledu dotazu zobrazí date, tracker, timezone, pageviews a visits.
2. Přejmenujte dotaz na NowMetrix Daily.
3. Vyberte Domů → Zavřít a použít.
4. Otevřete zobrazení Data a ověřte správnost řádků a typů sloupců.

Jednoduchý report ověří, že importovaná pole fungují správně:

1. Vraťte se do zobrazení Report.
2. Přidejte spojnicový graf.
3. Umístěte date na osu X.
4. Umístěte pageviews a visits na osu Y.
5. Přidejte dvě vizualizace Karta pro součty pageviews a visits.
6. Pokud model později obsahuje více trackerů, můžete volitelně přidat tracker jako průřez.

Vyberte Domů → Aktualizovat a otestujte úplnou aktualizaci v Desktopu. Stávající vizualizace se aktualizují po dokončení dotazu.

1. Uložte soubor PBIX na chráněné místo.
2. V Power BI Desktopu vyberte Domů → Publikovat.
3. Přihlaste se účtem Power BI vaší organizace.
4. Vyberte požadovaný pracovní prostor.
5. Otevřete publikovaný report z potvrzovacího dialogu.

Publikováním vznikne report a přidružený sémantický model. Plánovaná aktualizace se nastavuje pro sémantický model, nikoli pro jednotlivý graf nebo stránku reportu.

1. Otevřete pracovní prostor v Power BI Service.
2. Vyhledejte sémantický model vytvořený publikovaným souborem PBIX.
3. Otevřete Nastavení nebo vyberte Aktualizovat → Naplánovat aktualizaci.
4. V části Přihlašovací údaje zdroje dat upravte údaje pro https://api.nowmetrix.com.
5. Jako metodu ověřování vyberte Anonymní a nastavte úroveň ochrany osobních údajů požadovanou vaší organizací.
6. Povolte plán aktualizací a vyberte vhodnou frekvenci a časové pásmo.
7. Povolte upozornění na selhání aktualizace pro vlastníka sémantického modelu nebo jinou odpovědnou osobu.
8. Uložte nastavení, vyberte Aktualizovat nyní a zkontrolujte Historii aktualizací.

Dostupná frekvence aktualizací závisí na licenci Power BI a kapacitě pracovního prostoru. Microsoft popisuje aktuální ovládací prvky, limity, chování při selhání a historii aktualizací v příručce k plánované aktualizaci.

Parametry Power Query usnadňují změnu trackeru nebo obměnu klíče bez úprav celého dotazu. Zlepšují údržbu, ale nejde o úložiště tajných údajů.

1. V Editoru Power Query vyberte Domů → Spravovat parametry → Nový parametr.
2. Vytvořte povinný textový parametr s názvem pNowMetrixApiKey a jako jeho aktuální hodnotu zadejte API klíč.
3. Vytvořte další povinný textový parametr s názvem pNowMetrixTrackerId a zadejte ID trackeru.
4. Nahraďte první dva řádky dotazu níže uvedenými řádky.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Po publikování se upravitelné parametry mohou zobrazit v nastavení sémantického modelu. Přístup k pracovnímu prostoru musí být stále omezený, protože uživatelé s dostatečnými oprávněními je mohou zobrazit nebo změnit.

Pro každou datovou sadu vytvořte samostatný dotaz Power Query a podle potřeby použijte v modelu relace:

• Pro každý sémantický model Power BI používejte vyhrazený API klíč NowMetrix.
• Uživateli NowMetrix přidělte pouze přístup k trackerům, které report vyžaduje.
• Soubor PBIX ukládejte na chráněné místo a nikdy ho nepublikujte jako veřejné stažení.
• Editory PBIX a vlastníky sémantického modelu považujte za důvěryhodné uživatele, kteří mohou dotaz zobrazit.
• Klíč nevkládejte do vizualizací, filtrů reportu, adres URL, snímků obrazovky ani dokumentace.
• Použijte nejmenší okruh uživatelů pracovního prostoru Power BI, který splňuje požadavky reportingu.
• Před distribucí zkontrolujte oprávnění k reportu, pracovnímu prostoru, aplikaci, sestavení, opětovnému sdílení a stahování.
• Pokud mohlo dojít ke zneužití souboru PBIX, pracovního prostoru nebo účtu vlastníka, klíč ihned zneplatněte.
• Při změně vlastníka ověřte, že přihlašovací údaje pro aktualizaci a upozornění na selhání stále fungují.