एक्सपोर्ट · Microsoft Power BI

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 दैनिक रिकॉर्ड इंपोर्ट करता है। हर रिकॉर्ड में तारीख, ट्रैकर, ट्रैकर का टाइम ज़ोन, पेजव्यू और विज़िट शामिल होते हैं।

सिमेंटिक मॉडल रिफ्रेश होने पर Power BI एक स्नैपशॉट इंपोर्ट करता है। यह NowMetrix से स्थायी लाइव कनेक्शन बनाए नहीं रखता और NowMetrix के मान Google Analytics को नहीं भेजता।

शुरू करने से पहले

आपके पास ये चीज़ें होनी चाहिए:

  • REST API एक्सेस वाला NowMetrix अकाउंट,
  • उस ट्रैकर तक पहुँच, जिसकी रिपोर्ट बनानी है,
  • रिपोर्ट बनाने के लिए Microsoft Power BI Desktop, और
  • रिपोर्ट प्रकाशित करने या रिफ्रेश शेड्यूल करने के लिए उपयुक्त Power BI अकाउंट और वर्कस्पेस।
Power BI Desktop, Windows का ऐप्लिकेशन है। यदि आप macOS पर काम करते हैं, तो रिपोर्ट किसी प्रबंधित Windows वर्चुअल मशीन में, रिमोट Windows वातावरण के ज़रिए या Power BI Desktop वाले सहकर्मी की मदद से बनाएँ। इसके बाद प्रकाशित रिपोर्ट वेब ब्राउज़र में देखी जा सकती हैं।

Power BI लाइसेंस, वर्कस्पेस की अनुमतियाँ और उपलब्ध रिफ्रेश फ़्रीक्वेंसी Microsoft और आपके संगठन के एडमिनिस्ट्रेटर तय करते हैं। रिपोर्ट प्रकाशित किए बिना भी Desktop सेटअप पूरा किया जा सकता है।

1. अलग API कुंजी बनाएँ

  1. NowMetrix में साइन इन करें।
  2. सेटिंग्स → API खोलें।
  3. Microsoft Power BI नाम वाली नई कुंजी बनाएँ।
  4. पूरी कुंजी तुरंत कॉपी करें। यह केवल एक बार दिखाई जाती है।
  5. जिस वेबसाइट का डेटा इंपोर्ट करना है, उसका ट्रैकर ID नोट करें।
प्लेसहोल्डर इससे बदलें उदाहरण
nm_YOUR_KEY आपकी पूरी NowMetrix API कुंजी nm_…
TRACKER_ID इंपोर्ट किया जाने वाला ट्रैकर ID news-example-com
इस रिपोर्ट के लिए अलग कुंजी इस्तेमाल करें। यदि PBIX फ़ाइल या Power BI वर्कस्पेस कभी उजागर हो जाए, तो Excel, Google Sheets या किसी अन्य इंटीग्रेशन को बाधित किए बिना इस कुंजी को रद्द कर सकते हैं।

2. Power BI Desktop में खाली क्वेरी बनाएँ

  1. Power BI Desktop खोलें और खाली रिपोर्ट बनाएँ।
  2. होम → डेटा प्राप्त करें → खाली क्वेरी चुनें। यदि यह सूची में न हो, तो डेटा प्राप्त करें → अधिक चुनें और खाली क्वेरी खोजें।
  3. Power Query Editor एक नई क्वेरी के साथ खुल जाएगा।
  4. होम → उन्नत एडिटर चुनें।

इस उदाहरण के लिए मूल वेब डायलॉग न चुनें। उन्नत एडिटर का इस्तेमाल इसलिए किया जाता है क्योंकि NowMetrix को Bearer प्राधिकरण हेडर चाहिए और रिस्पॉन्स को JSON से टेबल की पंक्तियों में बदलना आवश्यक है।

3. तैयार Power Query पेस्ट करें

  1. उन्नत एडिटर की मौजूदा सामग्री हटाएँ।
  2. नीचे दी गई पूरी क्वेरी पेस्ट करें।
  3. पहली 2 पंक्तियों में nm_YOUR_KEY और TRACKER_ID बदलें।
  4. दोनों मानों को उद्धरण चिह्नों के अंदर रखें।
  5. पूरा हुआ चुनें।
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 से कैसे कनेक्ट करना चाहिए।

  1. अनाम चुनें।
  2. सेटिंग https://api.nowmetrix.com पर लागू करें।
  3. कनेक्ट करें चुनें।
  4. यदि प्राइवेसी लेवल पूछा जाए, तो अपने संगठन के अनुसार आवश्यक लेवल चुनें। अन्य डेटा स्रोतों से सबसे सख्त अलगाव के लिए निजी विकल्प चुनें।
NowMetrix के लिए कनेक्शन अनाम नहीं है। अनाम चुनने से Power BI को दूसरा Microsoft क्रेडेंशियल तरीका जोड़ने से रोका जाता है; क्वेरी पहले से ही अपने Bearer हेडर में NowMetrix API कुंजी के ज़रिए प्रमाणीकरण करती है।

5. सिमेंटिक मॉडल लोड और सत्यापित करें

  1. क्वेरी प्रीव्यू में date, tracker, timezone, pageviews और visits दिखाई देने तक प्रतीक्षा करें।
  2. क्वेरी का नाम बदलकर NowMetrix Daily करें।
  3. होम → बंद करें और लागू करें चुनें।
  4. डेटा व्यू खोलें और पुष्टि करें कि पंक्तियाँ और कॉलम के प्रकार सही हैं।
कॉलम सुझाया गया Power BI प्रकार
dateतारीख
trackerटेक्स्ट
timezoneटेक्स्ट
pageviewsपूर्णांक
visitsपूर्णांक

6. पहली रिपोर्ट बनाएँ

एक सरल रिपोर्ट यह पुष्टि करती है कि इंपोर्ट किए गए फ़ील्ड सही तरीके से काम कर रहे हैं:

  1. रिपोर्ट व्यू पर वापस जाएँ।
  2. लाइन चार्ट जोड़ें।
  3. X-अक्ष पर date रखें।
  4. Y-अक्ष पर pageviews और visits रखें।
  5. 2 कार्ड विज़ुअल जोड़ें, जो pageviews और visits के योग दिखाएँ।
  6. बाद में मॉडल में कई ट्रैकर होने पर, वैकल्पिक रूप से tracker को स्लाइसर के रूप में जोड़ें।

Desktop का पूरा रिफ्रेश जाँचने के लिए होम → रिफ्रेश चुनें। क्वेरी पूरी होने पर मौजूदा विज़ुअल अपडेट हो जाएँगे।

7. Power BI Service पर प्रकाशित करें

  1. PBIX फ़ाइल को सुरक्षित स्थान पर सेव करें।
  2. Power BI Desktop में होम → प्रकाशित करें चुनें।
  3. अपने संगठन के Power BI अकाउंट से साइन इन करें।
  4. इच्छित वर्कस्पेस चुनें।
  5. पुष्टि डायलॉग से प्रकाशित रिपोर्ट खोलें।
रिपोर्ट को सार्वजनिक वेब लिंक पर प्रकाशित न करें। प्रकाशित करने पर क्वेरी और इंपोर्ट किया गया डेटा आपके संगठन के Power BI वातावरण में रखा जाता है। वर्कस्पेस सदस्यों और सिमेंटिक मॉडल के मालिकों पर इस डेटा और इसकी API पहुँच को सुरक्षित ढंग से संभालने का भरोसा होना चाहिए।

प्रकाशित करने पर एक रिपोर्ट और उससे जुड़ा सिमेंटिक मॉडल बनता है। शेड्यूल्ड रिफ्रेश सिमेंटिक मॉडल पर सेट किया जाता है, किसी एक चार्ट या रिपोर्ट पेज पर नहीं।

8. शेड्यूल्ड रिफ्रेश सेट करें

  1. Power BI Service में वर्कस्पेस खोलें।
  2. प्रकाशित PBIX फ़ाइल से बने सिमेंटिक मॉडल को खोजें।
  3. सेटिंग्स खोलें या रिफ्रेश → रिफ्रेश शेड्यूल करें चुनें।
  4. डेटा स्रोत के क्रेडेंशियल के अंतर्गत https://api.nowmetrix.com के क्रेडेंशियल संपादित करें।
  5. प्रमाणीकरण विधि के रूप में अनाम और अपने संगठन के अनुसार आवश्यक प्राइवेसी लेवल चुनें।
  6. रिफ्रेश शेड्यूल चालू करें और उपयुक्त फ़्रीक्वेंसी व टाइम ज़ोन चुनें।
  7. सिमेंटिक मॉडल के मालिक या किसी अन्य ज़िम्मेदार व्यक्ति के लिए रिफ्रेश विफलता की सूचनाएँ चालू करें।
  8. सेटिंग सेव करें, अभी रिफ्रेश करें चुनें और रिफ्रेश इतिहास देखें।
NowMetrix एक सार्वजनिक HTTPS क्लाउड स्रोत है। जब Power BI Service api.nowmetrix.com तक पहुँच सकता है, तो आम तौर पर स्थानीय डेटा गेटवे की आवश्यकता नहीं होती। क्वेरी में जानबूझकर RelativePath और Query का इस्तेमाल किया गया है, जिन्हें बदलने योग्य क्वेरी पैरामीटर वाली रिफ्रेश योग्य वेब क्वेरी के लिए समर्थित अपवाद माना जाता है।
यदि Power BI केवल API बेस URL की जाँच करता है और कनेक्शन जाँच छोड़ें विकल्प देता है, तो उसे चालू करें। अकेला बेस URL पूरा NowMetrix API अनुरोध नहीं है। यदि आपका संगठन स्वयं लिखी गई वेब क्वेरी या बाहरी क्लाउड स्रोतों को बंद रखता है, तो Power BI एडमिनिस्ट्रेटर से सिमेंटिक मॉडल की सेटिंग की समीक्षा करने को कहें।

उपलब्ध रिफ्रेश फ़्रीक्वेंसी Power BI लाइसेंस और वर्कस्पेस की क्षमता पर निर्भर करती है। Microsoft अपने शेड्यूल्ड रिफ्रेश गाइड में मौजूदा नियंत्रण, सीमाएँ, विफलता का व्यवहार और रिफ्रेश इतिहास दर्ज करता है।

वैकल्पिक: कुंजी और ट्रैकर को कॉन्फ़िगर करने योग्य बनाएँ

Power Query पैरामीटर पूरी क्वेरी संपादित किए बिना ट्रैकर बदलना या कुंजी बदलना आसान बनाते हैं। ये रखरखाव को सरल बनाते हैं, लेकिन गुप्त जानकारी रखने की जगह नहीं हैं

  1. Power Query Editor में होम → पैरामीटर प्रबंधित करें → नया पैरामीटर चुनें।
  2. pNowMetrixApiKey नाम का आवश्यक टेक्स्ट पैरामीटर बनाएँ और API कुंजी को उसका मौजूदा मान दर्ज करें।
  3. pNowMetrixTrackerId नाम का एक अन्य आवश्यक टेक्स्ट पैरामीटर बनाएँ और ट्रैकर ID दर्ज करें।
  4. क्वेरी की पहली 2 पंक्तियों को नीचे दी गई पंक्तियों से बदलें।
    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

प्रकाशित करने के बाद संपादित किए जा सकने वाले पैरामीटर सिमेंटिक मॉडल की सेटिंग में दिखाई दे सकते हैं। फिर भी वर्कस्पेस की पहुँच सीमित रखें, क्योंकि पर्याप्त अनुमतियों वाले उपयोगकर्ता इन्हें देख या बदल सकते हैं।

अन्य NowMetrix डेटासेट जोड़ें

हर डेटासेट के लिए अलग Power Query बनाएँ और जहाँ उपयुक्त हो, मॉडल में रिलेशनशिप का इस्तेमाल करें:

उपयोग का मामला एंडपॉइंट मॉडल संबंधी टिप्पणी
दैनिक पेजव्यू और विज़िट /v1/overview हर ट्रैकर और तारीख के लिए 1 पंक्ति
पूरी हो चुकी अवधि के शीर्ष पेज /v1/recap हर इंपोर्ट किए गए परिणाम के साथ अनुरोधित अवधि सेव करें
वर्तमान लाइव लेख /v1/realtime अलग इतिहास स्टोरेज न बनाने पर रिफ्रेश स्नैपशॉट को बदल देता है
वर्तमान स्रोत /v1/sources स्नैपशॉट मिलाते समय रिस्पॉन्स का टाइमस्टैम्प इस्तेमाल करें
टेक्स्ट जाँच की समस्याएँ /v1/proofreading रिपोर्ट की पहुँच संबंधित संपादकीय टीम तक सीमित रखें
हर एंडपॉइंट अलग JSON संरचना लौटाता है। केवल RelativePath बदलकर उदाहरण की कॉपी करने से नया रिस्पॉन्स सही तरीके से रूपांतरित नहीं होगा। एंडपॉइंट के दस्तावेज़ में दिए गए रिस्पॉन्स उदाहरण के आधार पर Response के बाद के चरणों को बदलें।

सुरक्षा और शेयरिंग की चेकलिस्ट

  • हर Power BI सिमेंटिक मॉडल के लिए अलग NowMetrix API कुंजी इस्तेमाल करें।
  • NowMetrix उपयोगकर्ता को केवल रिपोर्ट के लिए आवश्यक ट्रैकर की पहुँच दें।
  • PBIX फ़ाइल को सुरक्षित स्थान पर रखें और इसे कभी सार्वजनिक डाउनलोड के रूप में प्रकाशित न करें।
  • PBIX एडिटर और सिमेंटिक मॉडल के मालिकों को ऐसे भरोसेमंद उपयोगकर्ता मानें, जो क्वेरी देख सकते हैं।
  • कुंजी को विज़ुअल, रिपोर्ट फ़िल्टर, URL, स्क्रीनशॉट या दस्तावेज़ में न रखें।
  • रिपोर्ट की आवश्यकता पूरी करने वाला सबसे छोटा Power BI वर्कस्पेस दर्शक समूह इस्तेमाल करें।
  • वितरण से पहले रिपोर्ट, वर्कस्पेस, ऐप, बिल्ड, दोबारा शेयर करने और डाउनलोड की अनुमतियों की समीक्षा करें।
  • यदि PBIX फ़ाइल, वर्कस्पेस या मालिक का अकाउंट असुरक्षित हो सकता है, तो कुंजी तुरंत रद्द करें।
  • मालिकाना बदलने पर पुष्टि करें कि रिफ्रेश क्रेडेंशियल और विफलता सूचनाएँ अब भी काम कर रही हैं।
Power Query पैरामीटर कॉन्फ़िगरेशन मान हैं, गुप्त जानकारी नहीं। कुंजी क्वेरी में सीधे लिखी गई हो या पैरामीटर के ज़रिए दी गई हो, 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 स्रोत को पहुँच योग्य क्लाउड वेब स्रोत के रूप में पहचानता है। वर्कस्पेस एडमिनिस्ट्रेटर से गेटवे और क्लाउड कनेक्शन सेटिंग की समीक्षा करने को कहें।