Eksports · Microsoft Power BI

Izveidojiet Power BI pārskatus ar NowMetrix datiem

Importējiet NowMetrix metriku, izmantojot Power Query, izveidojiet pirmo pārskatu Power BI Desktop un publicējiet datu kopu kontrolētai kopīgošanai un plānotai atjaunināšanai.

Kā darbojas savienojums

Savienojumam ir divi neobligāti posmi:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service
  • Power BI Desktop izveido vaicājumu, datu modeli un pārskatu.
  • Power BI Service publicē pārskatu, lai tam varētu piekļūt pārlūkprogrammā, to kopīgot un iestatīt plānotu atjaunināšanu.

Sagatavotais piemērs importē pēdējās 30 pieejamās dienas rindas no /v1/overview. Katrā rindā ir datums, tracker, tracker laika josla, lapu skatījumi un apmeklējumi.

Power BI importē momentuzņēmumu, kad tiek atjaunināts semantiskais modelis. Tas neuztur pastāvīgu tiešo savienojumu ar NowMetrix un nenosūta NowMetrix vērtības uz Google Analytics.

Pirms sākat

Nepieciešams:

  • NowMetrix konts ar REST API piekļuvi,
  • piekļuve tracker, par kuru vēlaties veidot pārskatu,
  • Microsoft Power BI Desktop pārskata izveidei,
  • atbilstošs Power BI konts un darbvieta, ja vēlaties publicēt pārskatu vai iestatīt plānotu atjaunināšanu.
Power BI Desktop ir Windows lietotne. Ja strādājat ar macOS, izveidojiet pārskatu pārvaldītā Windows virtuālajā mašīnā, attālinātā Windows vidē vai lūdziet palīdzību kolēģim, kuram ir Power BI Desktop. Pēc publicēšanas pārskatus var skatīt tīmekļa pārlūkprogrammā.

Power BI licences, darbvietas atļaujas un pieejamās atjaunināšanas frekvences pārvalda Microsoft un Jūsu organizācijas administrators. Power BI Desktop iestatīšanu var pabeigt, nepublicējot pārskatu.

1. Izveidojiet atsevišķu API atslēgu

  1. Piesakieties NowMetrix.
  2. Atveriet Iestatījumi → API.
  3. Izveidojiet jaunu atslēgu ar nosaukumu Microsoft Power BI.
  4. Nekavējoties nokopējiet visu atslēgu. Tā tiek parādīta tikai vienu reizi.
  5. Pierakstiet tās tīmekļa vietnes tracker ID, kuru vēlaties importēt.
Aizstājējteksts Aizstājiet ar Piemērs
nm_YOUR_KEY Jūsu pilnā NowMetrix API atslēga nm_…
TRACKER_ID Importējamā tracker ID news-example-com
Šim pārskatam izmantojiet atsevišķu atslēgu. Ja PBIX fails vai Power BI darbvieta kādreiz nonāk atklātībā, varēsiet atsaukt šo atslēgu, nepārtraucot Excel, Google Sheets vai citas integrācijas darbību.

2. Izveidojiet tukšu vaicājumu Power BI Desktop

  1. Atveriet Power BI Desktop un izveidojiet tukšu pārskatu.
  2. Izvēlieties Sākums → Iegūt datus → Tukšs vaicājums. Ja šī opcija nav redzama, izvēlieties Iegūt datus → Vairāk un meklējiet Tukšs vaicājums.
  3. Tiek atvērts Power Query redaktors ar jaunu vaicājumu.
  4. Izvēlieties Sākums → Papildu redaktors.

Šajā piemērā neizvēlieties pamata dialoglodziņu Tīmeklis. Tiek izmantots papildu redaktors, jo NowMetrix pieprasa Bearer autorizācijas galveni, bet atbilde no JSON formāta jāpārveido tabulas rindās.

3. Ielīmējiet sagatavoto Power Query

  1. Izdzēsiet esošo saturu papildu redaktorā.
  2. Ielīmējiet tālāk redzamo pilno vaicājumu.
  3. Pirmajās divās rindās aizstājiet nm_YOUR_KEY un TRACKER_ID.
  4. Abas vērtības atstājiet pēdiņās.
  5. Izvēlieties Gatavs.
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

Vaicājumā tiek izmantots nemainīgs pamata URL kopā ar RelativePath un Query. Tādējādi avots turpmākajiem atjauninājumiem ir paredzams, bet API atslēga tiek nosūtīta tikai HTTPS Authorization galvenē.

4. Apstipriniet datu avota piekļuves datus

Power BI var jautāt, kā izveidot savienojumu ar https://api.nowmetrix.com.

  1. Izvēlieties Anonīms.
  2. Attieciniet iestatījumu uz https://api.nowmetrix.com.
  3. Izvēlieties Savienot.
  4. Ja tiek prasīts norādīt konfidencialitātes līmeni, izvēlieties Jūsu organizācijai nepieciešamo līmeni. Privāts nodrošina visstingrāko nošķiršanu no citiem datu avotiem.
Savienojums ar NowMetrix nav anonīms. Anonīms norāda Power BI neizmantot otru Microsoft autentifikācijas metodi; vaicājums jau autentificējas ar NowMetrix API atslēgu Bearer galvenē.

5. Ielādējiet un pārbaudiet semantisko modeli

  1. Uzgaidiet, līdz vaicājuma priekšskatījumā tiek parādīti date, tracker, timezone, pageviews un visits.
  2. Pārdēvējiet vaicājumu par NowMetrix Daily.
  3. Izvēlieties Sākums → Aizvērt un lietot.
  4. Atveriet skatu Dati un pārbaudiet, vai rindas un kolonnu tipi ir pareizi.
Kolonna Ieteicamais Power BI tips
dateDatums
trackerTeksts
timezoneTeksts
pageviewsVesels skaitlis
visitsVesels skaitlis

6. Izveidojiet pirmo pārskatu

Vienkāršs pārskats ļauj pārliecināties, ka importētie lauki darbojas pareizi:

  1. Atgriezieties skatā Pārskats.
  2. Pievienojiet Līniju diagrammu.
  3. Novietojiet date uz X ass.
  4. Novietojiet pageviews un visits uz Y ass.
  5. Pievienojiet divus kartītes vizuālos elementus pageviews un visits summām.
  6. Ja modelī vēlāk būs vairāki tracker, pēc izvēles pievienojiet tracker kā datu griezumu.

Izvēlieties Sākums → Atjaunināt, lai pārbaudītu pilnu atjaunināšanu programmā Power BI Desktop. Esošie vizuālie elementi tiek atjaunināti, kad vaicājums ir pabeigts.

7. Publicējiet Power BI Service

  1. Saglabājiet PBIX failu aizsargātā vietā.
  2. Programmā Power BI Desktop izvēlieties Sākums → Publicēt.
  3. Piesakieties ar savas organizācijas Power BI kontu.
  4. Izvēlieties paredzēto darbvietu.
  5. Atveriet publicēto pārskatu apstiprinājuma dialoglodziņā.
Nepublicējiet pārskatu publiskā tīmekļa saitē. Publicējot vaicājums un importētie dati tiek ievietoti Jūsu organizācijas Power BI vidē. Darbvietas dalībniekiem un semantiskā modeļa īpašniekiem ir jābūt uzticamiem lietotājiem, kuri drīkst rīkoties ar šiem datiem un API piekļuvi.

Publicējot tiek izveidots pārskats un ar to saistīts semantiskais modelis. Plānotā atjaunināšana tiek konfigurēta semantiskajam modelim, nevis atsevišķai diagrammai vai pārskata lapai.

8. Iestatiet plānoto atjaunināšanu

  1. Atveriet darbvietu Power BI Service.
  2. Atrodiet publicētā PBIX faila izveidoto semantisko modeli.
  3. Atveriet Iestatījumi vai izvēlieties Atjaunināt → Plānot atjaunināšanu.
  4. Sadaļā Datu avota piekļuves dati rediģējiet https://api.nowmetrix.com piekļuves datus.
  5. Kā autentifikācijas metodi izvēlieties Anonīms un Jūsu organizācijai nepieciešamo konfidencialitātes līmeni.
  6. Iespējojiet atjaunināšanas grafiku un izvēlieties piemērotu biežumu un laika joslu.
  7. Iespējojiet paziņojumus par atjaunināšanas kļūmēm semantiskā modeļa īpašniekam vai citai atbildīgajai personai.
  8. Saglabājiet iestatījumus, izvēlieties Atjaunināt tūlīt un pārskatiet Atjaunināšanas vēsturi.
NowMetrix ir publisks HTTPS mākoņa avots. Vietējais datu vārtejas risinājums parasti nav nepieciešams, ja Power BI Service var sasniegt api.nowmetrix.com. Vaicājumā apzināti tiek izmantoti RelativePath un Query, kas ir atbalstīti izņēmumi atjaunināmiem tīmekļa vaicājumiem ar mainīgiem vaicājuma parametriem.
Ja Power BI pārbauda tikai API pamata URL un piedāvā Izlaist savienojuma pārbaudi, iespējojiet šo opciju. Pamata URL pats par sevi nav pilnīgs NowMetrix API pieprasījums. Ja Jūsu organizācija neļauj izmantot paša veidotus tīmekļa vaicājumus vai ārējus mākoņa avotus, lūdziet Power BI administratoram pārskatīt semantiskā modeļa iestatījumus.

Pieejamās atjaunināšanas frekvences ir atkarīgas no Power BI licences un darbvietas kapacitātes. Microsoft pašreizējās vadīklas, ierobežojumus, kļūmju apstrādi un atjaunināšanas vēsturi apraksta savā plānotās atjaunināšanas rokasgrāmatā.

Neobligāti: padariet atslēgu un tracker konfigurējamus

Power Query parametri atvieglo tracker maiņu vai atslēgas nomaiņu, nerediģējot visu vaicājumu. Tie uzlabo uzturamību, taču nav slepenās informācijas glabātuve.

  1. Power Query redaktorā izvēlieties Sākums → Pārvaldīt parametrus → Jauns parametrs.
  2. Izveidojiet obligātu teksta parametru ar nosaukumu pNowMetrixApiKey un kā pašreizējo vērtību ievadiet API atslēgu.
  3. Izveidojiet vēl vienu obligātu teksta parametru ar nosaukumu pNowMetrixTrackerId un ievadiet tracker ID.
  4. Aizstājiet pirmās divas vaicājuma rindas ar tālāk redzamajām rindām.
    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Pēc publicēšanas rediģējamie parametri var būt pieejami semantiskā modeļa iestatījumos. Piekļuve darbvietai joprojām ir jāierobežo, jo lietotāji ar pietiekamām atļaujām var tos apskatīt vai mainīt.

Pievienojiet citas NowMetrix datu kopas

Izveidojiet atsevišķu Power Query katrai datu kopai un, ja nepieciešams, modelī izmantojiet relācijas:

Izmantošanas gadījums Endpoint Piezīme par modelēšanu
Ikdienas lapu skatījumi un apmeklējumi /v1/overview Viena rinda katram tracker un datumam
Pabeigta perioda populārākās lapas /v1/recap Kopā ar katru importēto rezultātu saglabājiet pieprasīto periodu
Pašlaik aktīvie raksti /v1/realtime Atjaunināšana aizstāj momentuzņēmumu, ja neveidojat atsevišķu vēsturisko datu krātuvi
Pašreizējie avoti /v1/sources Apvienojot momentuzņēmumus, izmantojiet atbildes laika zīmogu
Korektūras problēmas /v1/proofreading Ierobežojiet pārskata piekļuvi attiecīgajai redakcijas komandai
Katrs endpoint atgriež atšķirīgu JSON struktūru. Nokopējot piemēru un mainot tikai RelativePath, jaunā atbilde netiks pareizi pārveidota. Pielāgojiet darbības pēc Response, izmantojot endpoint dokumentēto atbildes piemēru.

Drošības un kopīgošanas kontrolsaraksts

  • Katram Power BI semantiskajam modelim izmantojiet atsevišķu NowMetrix API atslēgu.
  • NowMetrix lietotājam piešķiriet tikai pārskatam nepieciešamo tracker piekļuvi.
  • Glabājiet PBIX failu aizsargātā vietā un nekad nepublicējiet to kā publiski lejupielādējamu failu.
  • Uzskatiet PBIX redaktorus un semantiskā modeļa īpašniekus par uzticamiem lietotājiem, kuri var pārbaudīt vaicājumu.
  • Neievietojiet atslēgu vizuālajos elementos, pārskata filtros, URL, ekrānuzņēmumos vai dokumentācijā.
  • Izmantojiet mazāko Power BI darbvietas lietotāju loku, kas atbilst pārskata vajadzībām.
  • Pirms izplatīšanas pārskatiet pārskata, darbvietas, lietotnes, veidošanas, atkārtotas kopīgošanas un lejupielādes atļaujas.
  • Nekavējoties atsauciet atslēgu, ja pastāv risks, ka PBIX fails, darbvieta vai īpašnieka konts ir apdraudēts.
  • Mainoties īpašniekam, pārliecinieties, ka atjaunināšanas piekļuves dati un paziņojumi par kļūmēm joprojām darbojas.
Power Query parametri ir konfigurācijas vērtības, nevis slepeni dati. Neatkarīgi no tā, vai atslēga ir ierakstīta tieši vaicājumā vai ievadīta ar parametru, piekļuve PBIX failam un semantiskajam modelim ir jāierobežo.

Problēmu novēršana

Problēma Ko pārbaudīt
Power BI atkārtoti pieprasa piekļuves datus Sadaļā Fails → Opcijas un iestatījumi → Datu avota iestatījumi notīriet https://api.nowmetrix.com atļaujas, izveidojiet savienojumu vēlreiz un izvēlieties Anonīms.
401 vai “piekļuve resursam ir aizliegta” Pārbaudiet, vai pilnā atslēga aizstāja nm_YOUR_KEY, tajā nav atstarpju un tā nav atsaukta.
403 Atslēga nevar piekļūt konfigurētajam tracker. Pārbaudiet TRACKER_ID un NowMetrix lietotāja tracker atļaujas.
429 Pārsniegts visam tracker noteiktais API ierobežojums. Uzgaidiet un samaziniet plānoto vai manuālo atjaunināšanu biežumu.
503 Analītikas aizmugursistēma īslaicīgi nav pieejama. Saglabājiet esošo semantisko modeli un vēlāk mēģiniet vēlreiz.
Power BI Desktop atjaunināšana darbojas, bet Power BI Service atjaunināšana neizdodas Pārbaudiet semantiskā modeļa datu avota piekļuves datus, īpašnieku, konfidencialitātes līmeni, atjaunināšanas vēsturi un to, vai administrators nebloķē mākoņa tīmekļa avotus vai paša veidotus vaicājumus.
Power BI ziņo par dinamisku datu avotu Pārliecinieties, ka vaicājumā joprojām tiek izmantots fiksēts https://api.nowmetrix.com pamata URL ar RelativePath un Query. Neveidojiet pilno URL, savienojot tekstu.
Plānotā atjaunināšana ir atspējota Atveriet atjaunināšanas vēsturi, novērsiet jaunāko kļūmi, pārbaudiet piekļuves datus un vēlreiz iespējojiet grafiku. Pēc atkārtotām kļūmēm vai neaktivitātes Power BI var apturēt grafikus.
Negaidīti tiek parādīta vārtejas konfigurācija Pārbaudiet, vai Power BI klasificē avotu kā sasniedzamu mākoņa Web avotu. Lūdziet darbvietas administratoram pārskatīt vārtejas un mākoņa savienojuma iestatījumus.