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.
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 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
- Piesakieties NowMetrix.
- Atveriet Iestatījumi → API.
- Izveidojiet jaunu atslēgu ar nosaukumu Microsoft Power BI.
- Nekavējoties nokopējiet visu atslēgu. Tā tiek parādīta tikai vienu reizi.
- 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 |
2. Izveidojiet tukšu vaicājumu Power BI Desktop
- Atveriet Power BI Desktop un izveidojiet tukšu pārskatu.
- 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.
- Tiek atvērts Power Query redaktors ar jaunu vaicājumu.
- 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
- Izdzēsiet esošo saturu papildu redaktorā.
- Ielīmējiet tālāk redzamo pilno vaicājumu.
- Pirmajās divās rindās aizstājiet
nm_YOUR_KEYunTRACKER_ID. - Abas vērtības atstājiet pēdiņās.
- 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.
- Izvēlieties Anonīms.
- Attieciniet iestatījumu uz
https://api.nowmetrix.com. - Izvēlieties Savienot.
- 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.
5. Ielādējiet un pārbaudiet semantisko modeli
- Uzgaidiet, līdz vaicājuma priekšskatījumā tiek parādīti
date,tracker,timezone,pageviewsunvisits. - Pārdēvējiet vaicājumu par NowMetrix Daily.
- Izvēlieties Sākums → Aizvērt un lietot.
- Atveriet skatu Dati un pārbaudiet, vai rindas un kolonnu tipi ir pareizi.
| Kolonna | Ieteicamais Power BI tips |
|---|---|
date | Datums |
tracker | Teksts |
timezone | Teksts |
pageviews | Vesels skaitlis |
visits | Vesels skaitlis |
6. Izveidojiet pirmo pārskatu
Vienkāršs pārskats ļauj pārliecināties, ka importētie lauki darbojas pareizi:
- Atgriezieties skatā Pārskats.
- Pievienojiet Līniju diagrammu.
- Novietojiet
dateuz X ass. - Novietojiet
pageviewsunvisitsuz Y ass. - Pievienojiet divus kartītes vizuālos elementus
pageviewsunvisitssummām. - Ja modelī vēlāk būs vairāki tracker, pēc izvēles pievienojiet
trackerkā 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
- Saglabājiet PBIX failu aizsargātā vietā.
- Programmā Power BI Desktop izvēlieties Sākums → Publicēt.
- Piesakieties ar savas organizācijas Power BI kontu.
- Izvēlieties paredzēto darbvietu.
- Atveriet publicēto pārskatu apstiprinājuma dialoglodziņā.
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
- Atveriet darbvietu Power BI Service.
- Atrodiet publicētā PBIX faila izveidoto semantisko modeli.
- Atveriet Iestatījumi vai izvēlieties Atjaunināt → Plānot atjaunināšanu.
- Sadaļā Datu avota piekļuves dati rediģējiet
https://api.nowmetrix.compiekļuves datus. - Kā autentifikācijas metodi izvēlieties Anonīms un Jūsu organizācijai nepieciešamo konfidencialitātes līmeni.
- Iespējojiet atjaunināšanas grafiku un izvēlieties piemērotu biežumu un laika joslu.
- Iespējojiet paziņojumus par atjaunināšanas kļūmēm semantiskā modeļa īpašniekam vai citai atbildīgajai personai.
- Saglabājiet iestatījumus, izvēlieties Atjaunināt tūlīt un pārskatiet Atjaunināšanas vēsturi.
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.
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.
- Power Query redaktorā izvēlieties Sākums → Pārvaldīt parametrus → Jauns parametrs.
- Izveidojiet obligātu teksta parametru ar nosaukumu
pNowMetrixApiKeyun kā pašreizējo vērtību ievadiet API atslēgu. - Izveidojiet vēl vienu obligātu teksta parametru ar nosaukumu
pNowMetrixTrackerIdun ievadiet tracker ID. - 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 |
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.
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. |