NowMetrix डेटा से Power BI रिपोर्ट बनाएँ
Power Query से NowMetrix के मेट्रिक्स इंपोर्ट करें, Power BI Desktop में पहली रिपोर्ट बनाएँ और नियंत्रित शेयरिंग व शेड्यूल्ड अपडेट के लिए डेटासेट प्रकाशित करें।
कनेक्शन कैसे काम करता है
कनेक्शन में 2 वैकल्पिक चरण होते हैं:
NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service
- Power BI Desktop क्वेरी, डेटा मॉडल और रिपोर्ट बनाता है।
- Power BI Service ब्राउज़र से पहुँच, शेयरिंग और शेड्यूल्ड रिफ्रेश के लिए रिपोर्ट प्रकाशित करता है।
तैयार उदाहरण /v1/overview से उपलब्ध पिछले 30 दैनिक रिकॉर्ड इंपोर्ट करता है।
हर रिकॉर्ड में तारीख, ट्रैकर, ट्रैकर का टाइम ज़ोन, पेजव्यू और विज़िट शामिल होते हैं।
शुरू करने से पहले
आपके पास ये चीज़ें होनी चाहिए:
- REST API एक्सेस वाला NowMetrix अकाउंट,
- उस ट्रैकर तक पहुँच, जिसकी रिपोर्ट बनानी है,
- रिपोर्ट बनाने के लिए Microsoft Power BI Desktop, और
- रिपोर्ट प्रकाशित करने या रिफ्रेश शेड्यूल करने के लिए उपयुक्त Power BI अकाउंट और वर्कस्पेस।
Power BI लाइसेंस, वर्कस्पेस की अनुमतियाँ और उपलब्ध रिफ्रेश फ़्रीक्वेंसी Microsoft और आपके संगठन के एडमिनिस्ट्रेटर तय करते हैं। रिपोर्ट प्रकाशित किए बिना भी Desktop सेटअप पूरा किया जा सकता है।
1. अलग API कुंजी बनाएँ
- NowMetrix में साइन इन करें।
- सेटिंग्स → API खोलें।
- Microsoft Power BI नाम वाली नई कुंजी बनाएँ।
- पूरी कुंजी तुरंत कॉपी करें। यह केवल एक बार दिखाई जाती है।
- जिस वेबसाइट का डेटा इंपोर्ट करना है, उसका ट्रैकर ID नोट करें।
| प्लेसहोल्डर | इससे बदलें | उदाहरण |
|---|---|---|
nm_YOUR_KEY |
आपकी पूरी NowMetrix API कुंजी | nm_… |
TRACKER_ID |
इंपोर्ट किया जाने वाला ट्रैकर ID | news-example-com |
2. Power BI Desktop में खाली क्वेरी बनाएँ
- Power BI Desktop खोलें और खाली रिपोर्ट बनाएँ।
- होम → डेटा प्राप्त करें → खाली क्वेरी चुनें। यदि यह सूची में न हो, तो डेटा प्राप्त करें → अधिक चुनें और खाली क्वेरी खोजें।
- Power Query Editor एक नई क्वेरी के साथ खुल जाएगा।
- होम → उन्नत एडिटर चुनें।
इस उदाहरण के लिए मूल वेब डायलॉग न चुनें। उन्नत एडिटर का इस्तेमाल इसलिए किया जाता है क्योंकि NowMetrix को Bearer प्राधिकरण हेडर चाहिए और रिस्पॉन्स को JSON से टेबल की पंक्तियों में बदलना आवश्यक है।
3. तैयार Power Query पेस्ट करें
- उन्नत एडिटर की मौजूदा सामग्री हटाएँ।
- नीचे दी गई पूरी क्वेरी पेस्ट करें।
- पहली 2 पंक्तियों में
nm_YOUR_KEYऔरTRACKER_IDबदलें। - दोनों मानों को उद्धरण चिह्नों के अंदर रखें।
- पूरा हुआ चुनें।
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
क्वेरी में RelativePath और Query के साथ एक निश्चित बेस URL का इस्तेमाल
होता है। इससे बाद के रिफ्रेश के लिए स्रोत एकसमान रहता है और API कुंजी केवल HTTPS
Authorization हेडर में भेजी जाती है।
4. डेटा स्रोत के क्रेडेंशियल की पुष्टि करें
Power BI आपसे पूछ सकता है कि उसे https://api.nowmetrix.com से कैसे कनेक्ट करना चाहिए।
- अनाम चुनें।
- सेटिंग
https://api.nowmetrix.comपर लागू करें। - कनेक्ट करें चुनें।
- यदि प्राइवेसी लेवल पूछा जाए, तो अपने संगठन के अनुसार आवश्यक लेवल चुनें। अन्य डेटा स्रोतों से सबसे सख्त अलगाव के लिए निजी विकल्प चुनें।
5. सिमेंटिक मॉडल लोड और सत्यापित करें
- क्वेरी प्रीव्यू में
date,tracker,timezone,pageviewsऔरvisitsदिखाई देने तक प्रतीक्षा करें। - क्वेरी का नाम बदलकर NowMetrix Daily करें।
- होम → बंद करें और लागू करें चुनें।
- डेटा व्यू खोलें और पुष्टि करें कि पंक्तियाँ और कॉलम के प्रकार सही हैं।
| कॉलम | सुझाया गया Power BI प्रकार |
|---|---|
date | तारीख |
tracker | टेक्स्ट |
timezone | टेक्स्ट |
pageviews | पूर्णांक |
visits | पूर्णांक |
6. पहली रिपोर्ट बनाएँ
एक सरल रिपोर्ट यह पुष्टि करती है कि इंपोर्ट किए गए फ़ील्ड सही तरीके से काम कर रहे हैं:
- रिपोर्ट व्यू पर वापस जाएँ।
- लाइन चार्ट जोड़ें।
- X-अक्ष पर
dateरखें। - Y-अक्ष पर
pageviewsऔरvisitsरखें। - 2 कार्ड विज़ुअल जोड़ें, जो
pageviewsऔरvisitsके योग दिखाएँ। - बाद में मॉडल में कई ट्रैकर होने पर, वैकल्पिक रूप से
trackerको स्लाइसर के रूप में जोड़ें।
Desktop का पूरा रिफ्रेश जाँचने के लिए होम → रिफ्रेश चुनें। क्वेरी पूरी होने पर मौजूदा विज़ुअल अपडेट हो जाएँगे।
7. Power BI Service पर प्रकाशित करें
- PBIX फ़ाइल को सुरक्षित स्थान पर सेव करें।
- Power BI Desktop में होम → प्रकाशित करें चुनें।
- अपने संगठन के Power BI अकाउंट से साइन इन करें।
- इच्छित वर्कस्पेस चुनें।
- पुष्टि डायलॉग से प्रकाशित रिपोर्ट खोलें।
प्रकाशित करने पर एक रिपोर्ट और उससे जुड़ा सिमेंटिक मॉडल बनता है। शेड्यूल्ड रिफ्रेश सिमेंटिक मॉडल पर सेट किया जाता है, किसी एक चार्ट या रिपोर्ट पेज पर नहीं।
8. शेड्यूल्ड रिफ्रेश सेट करें
- Power BI Service में वर्कस्पेस खोलें।
- प्रकाशित PBIX फ़ाइल से बने सिमेंटिक मॉडल को खोजें।
- सेटिंग्स खोलें या रिफ्रेश → रिफ्रेश शेड्यूल करें चुनें।
- डेटा स्रोत के क्रेडेंशियल के अंतर्गत
https://api.nowmetrix.comके क्रेडेंशियल संपादित करें। - प्रमाणीकरण विधि के रूप में अनाम और अपने संगठन के अनुसार आवश्यक प्राइवेसी लेवल चुनें।
- रिफ्रेश शेड्यूल चालू करें और उपयुक्त फ़्रीक्वेंसी व टाइम ज़ोन चुनें।
- सिमेंटिक मॉडल के मालिक या किसी अन्य ज़िम्मेदार व्यक्ति के लिए रिफ्रेश विफलता की सूचनाएँ चालू करें।
- सेटिंग सेव करें, अभी रिफ्रेश करें चुनें और रिफ्रेश इतिहास देखें।
api.nowmetrix.com तक पहुँच सकता है, तो आम तौर पर स्थानीय डेटा गेटवे की आवश्यकता
नहीं होती। क्वेरी में जानबूझकर RelativePath और Query का इस्तेमाल किया
गया है, जिन्हें बदलने योग्य क्वेरी पैरामीटर वाली रिफ्रेश योग्य वेब क्वेरी के लिए समर्थित अपवाद माना जाता है।
उपलब्ध रिफ्रेश फ़्रीक्वेंसी Power BI लाइसेंस और वर्कस्पेस की क्षमता पर निर्भर करती है। Microsoft अपने शेड्यूल्ड रिफ्रेश गाइड में मौजूदा नियंत्रण, सीमाएँ, विफलता का व्यवहार और रिफ्रेश इतिहास दर्ज करता है।
वैकल्पिक: कुंजी और ट्रैकर को कॉन्फ़िगर करने योग्य बनाएँ
Power Query पैरामीटर पूरी क्वेरी संपादित किए बिना ट्रैकर बदलना या कुंजी बदलना आसान बनाते हैं। ये रखरखाव को सरल बनाते हैं, लेकिन गुप्त जानकारी रखने की जगह नहीं हैं।
- Power Query Editor में होम → पैरामीटर प्रबंधित करें → नया पैरामीटर चुनें।
pNowMetrixApiKeyनाम का आवश्यक टेक्स्ट पैरामीटर बनाएँ और API कुंजी को उसका मौजूदा मान दर्ज करें।pNowMetrixTrackerIdनाम का एक अन्य आवश्यक टेक्स्ट पैरामीटर बनाएँ और ट्रैकर ID दर्ज करें।- क्वेरी की पहली 2 पंक्तियों को नीचे दी गई पंक्तियों से बदलें।
ApiKey = pNowMetrixApiKey,
TrackerId = pNowMetrixTrackerId,
प्रकाशित करने के बाद संपादित किए जा सकने वाले पैरामीटर सिमेंटिक मॉडल की सेटिंग में दिखाई दे सकते हैं। फिर भी वर्कस्पेस की पहुँच सीमित रखें, क्योंकि पर्याप्त अनुमतियों वाले उपयोगकर्ता इन्हें देख या बदल सकते हैं।
अन्य NowMetrix डेटासेट जोड़ें
हर डेटासेट के लिए अलग Power Query बनाएँ और जहाँ उपयुक्त हो, मॉडल में रिलेशनशिप का इस्तेमाल करें:
| उपयोग का मामला | एंडपॉइंट | मॉडल संबंधी टिप्पणी |
|---|---|---|
| दैनिक पेजव्यू और विज़िट | /v1/overview |
हर ट्रैकर और तारीख के लिए 1 पंक्ति |
| पूरी हो चुकी अवधि के शीर्ष पेज | /v1/recap |
हर इंपोर्ट किए गए परिणाम के साथ अनुरोधित अवधि सेव करें |
| वर्तमान लाइव लेख | /v1/realtime |
अलग इतिहास स्टोरेज न बनाने पर रिफ्रेश स्नैपशॉट को बदल देता है |
| वर्तमान स्रोत | /v1/sources |
स्नैपशॉट मिलाते समय रिस्पॉन्स का टाइमस्टैम्प इस्तेमाल करें |
| टेक्स्ट जाँच की समस्याएँ | /v1/proofreading |
रिपोर्ट की पहुँच संबंधित संपादकीय टीम तक सीमित रखें |
RelativePath बदलकर उदाहरण की कॉपी
करने से नया रिस्पॉन्स सही तरीके से रूपांतरित नहीं होगा। एंडपॉइंट के दस्तावेज़ में दिए गए
रिस्पॉन्स उदाहरण के आधार पर Response के बाद के चरणों को बदलें।
सुरक्षा और शेयरिंग की चेकलिस्ट
- हर Power BI सिमेंटिक मॉडल के लिए अलग NowMetrix API कुंजी इस्तेमाल करें।
- NowMetrix उपयोगकर्ता को केवल रिपोर्ट के लिए आवश्यक ट्रैकर की पहुँच दें।
- PBIX फ़ाइल को सुरक्षित स्थान पर रखें और इसे कभी सार्वजनिक डाउनलोड के रूप में प्रकाशित न करें।
- PBIX एडिटर और सिमेंटिक मॉडल के मालिकों को ऐसे भरोसेमंद उपयोगकर्ता मानें, जो क्वेरी देख सकते हैं।
- कुंजी को विज़ुअल, रिपोर्ट फ़िल्टर, URL, स्क्रीनशॉट या दस्तावेज़ में न रखें।
- रिपोर्ट की आवश्यकता पूरी करने वाला सबसे छोटा Power BI वर्कस्पेस दर्शक समूह इस्तेमाल करें।
- वितरण से पहले रिपोर्ट, वर्कस्पेस, ऐप, बिल्ड, दोबारा शेयर करने और डाउनलोड की अनुमतियों की समीक्षा करें।
- यदि PBIX फ़ाइल, वर्कस्पेस या मालिक का अकाउंट असुरक्षित हो सकता है, तो कुंजी तुरंत रद्द करें।
- मालिकाना बदलने पर पुष्टि करें कि रिफ्रेश क्रेडेंशियल और विफलता सूचनाएँ अब भी काम कर रही हैं।
समस्याओं का समाधान
| समस्या | क्या जाँचें |
|---|---|
| Power BI बार-बार क्रेडेंशियल माँगता है | फ़ाइल → विकल्प और सेटिंग्स → डेटा स्रोत सेटिंग्स में https://api.nowmetrix.com की अनुमतियाँ हटाएँ, फिर से कनेक्ट करें और अनाम चुनें। |
401 या “संसाधन तक पहुँच प्रतिबंधित है” |
जाँचें कि पूरी कुंजी ने nm_YOUR_KEY को बदला है, उसमें कोई स्पेस नहीं है और उसे रद्द नहीं किया गया है। |
403 |
यह कुंजी कॉन्फ़िगर किए गए ट्रैकर तक पहुँच नहीं सकती। TRACKER_ID और NowMetrix उपयोगकर्ता की ट्रैकर अनुमतियाँ जाँचें। |
429 |
ट्रैकर-स्तर की API सीमा पार हो गई है। प्रतीक्षा करें और शेड्यूल्ड या मैन्युअल रिफ्रेश की फ़्रीक्वेंसी घटाएँ। |
503 |
एनालिटिक्स बैकएंड अस्थायी रूप से उपलब्ध नहीं है। मौजूदा सिमेंटिक मॉडल बनाए रखें और बाद में फिर प्रयास करें। |
| Desktop रिफ्रेश काम करता है, Service रिफ्रेश विफल होता है | सिमेंटिक मॉडल के डेटा स्रोत क्रेडेंशियल, मालिक, प्राइवेसी लेवल, रिफ्रेश इतिहास और यह जाँचें कि आपका एडमिनिस्ट्रेटर क्लाउड वेब स्रोत या स्वयं लिखी गई क्वेरी को ब्लॉक तो नहीं करता। |
| Power BI डायनेमिक डेटा स्रोत की सूचना देता है | पुष्टि करें कि क्वेरी अब भी निश्चित https://api.nowmetrix.com बेस URL के साथ RelativePath और Query का इस्तेमाल करती है। पूरा URL टेक्स्ट जोड़कर न बनाएँ। |
| शेड्यूल्ड रिफ्रेश बंद है | रिफ्रेश इतिहास खोलें, नवीनतम विफलता दूर करें, क्रेडेंशियल सत्यापित करें और शेड्यूल फिर चालू करें। बार-बार विफलता या निष्क्रियता के बाद Power BI शेड्यूल रोक सकता है। |
| गेटवे कॉन्फ़िगरेशन अनपेक्षित रूप से दिखाई देता है | पुष्टि करें कि Power BI स्रोत को पहुँच योग्य क्लाउड वेब स्रोत के रूप में पहचानता है। वर्कस्पेस एडमिनिस्ट्रेटर से गेटवे और क्लाउड कनेक्शन सेटिंग की समीक्षा करने को कहें। |