NowMetrix के मेट्रिक्स Google Sheets में रखें

स्प्रेडशीट ग्राहक के नियंत्रण वाला एक छोटा डेटा सेतु होती है:

NowMetrix REST API → Google Apps Script → Google Sheet → optional Looker Studio report

डेटा Google Analytics में आयात नहीं किया जाता। Apps Script आपकी API कुंजी के साथ चुने गए NowMetrix एंडपॉइंट को अनुरोध भेजता है और प्राप्त पंक्तियों को स्प्रेडशीट में लिखता है। इसके बाद Looker Studio उस वर्कशीट को अलग डेटा स्रोत के रूप में इस्तेमाल कर सकता है।

1. NowMetrix में सेटिंग्स → API खोलें और Google Sheets नाम वाली अलग कुंजी बनाएँ।
2. कुंजी दिखाई देने पर उसे पूरा कॉपी करें। बाद में इसे दोबारा प्रदर्शित नहीं किया जा सकता।
3. जिस वेबसाइट का डेटा निर्यात करना है, उसका ट्रैकर ID नोट करें।
4. नई Google Sheet बनाएँ, जैसे NowMetrix Export।
5. स्प्रेडशीट का समय क्षेत्र NowMetrix ट्रैकर के समय क्षेत्र के समान रखें।

नीचे दिया गया उदाहरण /v1/overview से पिछली 30 दैनिक पंक्तियाँ निर्यात करता है। प्रत्येक पंक्ति में तारीख, ट्रैकर, ट्रैकर का समय क्षेत्र, पृष्ठदृश्य और विज़िट होते हैं।

Google Sheet में एक्सटेंशन → Apps Script चुनें। फिर:

1. गियर आइकन से प्रोजेक्ट सेटिंग्स खोलें।
2. स्क्रिप्ट प्रॉपर्टीज़ के अंतर्गत स्क्रिप्ट प्रॉपर्टी जोड़ें चुनें।
3. नीचे दी गई दो प्रॉपर्टीज़ जोड़ें:

Code.gs की सामग्री को इस स्क्रिप्ट से बदलें। यह कॉन्फ़िगरेशन की जाँच करती है, स्प्रेडशीट की पहुँच को वर्तमान दस्तावेज़ तक सीमित रखती है, API त्रुटियों को संभालती है और सफल रिस्पॉन्स मिलने के बाद ही वर्कशीट को बदलती है।

/**
 * @OnlyCurrentDoc
 */

const NOWMETRIX_BASE_URL = 'https://api.nowmetrix.com';

function fetchNowMetrix(path) {
  const properties = PropertiesService.getScriptProperties();
  const apiKey = properties.getProperty('NOWMETRIX_API_KEY');
  const trackerId = properties.getProperty('NOWMETRIX_TRACKER_ID');

  if (!apiKey || !trackerId) {
    throw new Error('NOWMETRIX_API_KEY or NOWMETRIX_TRACKER_ID is missing.');
  }

  const separator = path.includes('?') ? '&' : '?';
  const url = NOWMETRIX_BASE_URL
    + path
    + separator
    + 'site=' + encodeURIComponent(trackerId);

  const response = UrlFetchApp.fetch(url, {
    method: 'get',
    headers: {
      Authorization: 'Bearer ' + apiKey,
      Accept: 'application/json'
    },
    muteHttpExceptions: true
  });

  const status = response.getResponseCode();
  const body = response.getContentText();

  if (status < 200 || status >= 300) {
    throw new Error('NowMetrix API returned HTTP ' + status + ': ' + body);
  }

  return JSON.parse(body);
}

function toSheetDate(value) {
  const parts = value.split('-').map(Number);
  return new Date(parts[0], parts[1] - 1, parts[2]);
}

function syncNowMetrixDaily() {
  const result = fetchNowMetrix('/v1/overview?days=30');
  const rows = result.daily.map(day => [
    toSheetDate(day.date),
    result.site,
    result.timezone,
    day.pageviews,
    day.visits
  ]);

  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getSheetByName('Daily')
    || spreadsheet.insertSheet('Daily');
  const values = [
    ['date', 'tracker', 'timezone', 'pageviews', 'visits'],
    ...rows
  ];

  sheet.clearContents();
  sheet.getRange(1, 1, values.length, values[0].length).setValues(values);
  sheet.setFrozenRows(1);
  sheet.getRange(1, 1, 1, values[0].length).setFontWeight('bold');

  if (rows.length > 0) {
    sheet.getRange(2, 1, rows.length, 1).setNumberFormat('yyyy-mm-dd');
    sheet.getRange(2, 4, rows.length, 2).setNumberFormat('#,##0');
  }

  sheet.autoResizeColumns(1, values[0].length);
}

स्रोत में NOWMETRIX_API_KEY को वास्तविक कुंजी से न बदलें। स्क्रिप्ट इसे रनटाइम पर स्क्रिप्ट प्रॉपर्टीज़ से पढ़ती है। सबसे ऊपर @OnlyCurrentDoc रखें: इससे Google आपके खाते की सभी स्प्रेडशीट के बजाय इसी स्प्रेडशीट की पहुँच माँगता है।

1. ऊपर बाएँ कोने में प्रोजेक्ट का नाम NowMetrix Google Sheets Export रखें।
2. डिस्क आइकन या कीबोर्ड शॉर्टकट से Apps Script प्रोजेक्ट सहेजें।
3. संपादक के टूलबार में फ़ंक्शन मेनू से syncNowMetrixDaily चुनें।
4. फ़ंक्शन मेनू के पास चलाएँ चुनें।

स्क्रिप्ट पहली बार चलने पर Google अनुमति माँगता है। अनुमतियों की समीक्षा करें चुनें और वह Google खाता चुनें जिसका स्प्रेडशीट पर स्वामित्व है।

निजी, स्वयं बनाए गए Apps Script प्रोजेक्ट के लिए Google ने इस ऐप का सत्यापन नहीं किया है जैसी चेतावनी सामान्य है। Google द्वारा दिखाया गया डेवलपर ईमेल आपका अपना Google खाता होना चाहिए। यह प्रोजेक्ट NowMetrix का Google ऐप नहीं है और NowMetrix को आपके Google खाते की पहुँच नहीं देता।

1. पुष्टि करें कि Apps Script प्रोजेक्ट आपने बनाया है और डेवलपर ईमेल आपका है।
2. चेतावनी स्क्रीन पर उन्नत चुनें।
3. अपने नाम वाले प्रोजेक्ट पर जाएँ। निजी प्रोजेक्ट का सत्यापन न होने के कारण Google इस लिंक को असुरक्षित बता सकता है।
4. माँगी गई अनुमतियों की समीक्षा करें और अनुमति दें या जारी रखें चुनें।

यदि आपने पहले व्यापक स्प्रेडशीट पहुँच को स्वीकृति दे दी है, तो Google खाता → सुरक्षा → तृतीय-पक्ष ऐप्स और सेवाओं के कनेक्शन में प्रोजेक्ट हटाएँ। इसके बाद कम अनुमतियाँ माँगने के लिए सहेजी गई स्क्रिप्ट फिर चलाएँ।

Google इस प्राधिकरण प्रक्रिया और @OnlyCurrentDoc प्रतिबंध को अपनी Apps Script प्राधिकरण मार्गदर्शिका में समझाता है।

प्राधिकरण के बाद Apps Script का रन जारी रहता है। निष्पादन लॉग में निष्पादन पूरा हुआ दिखने तक प्रतीक्षा करें, फिर स्प्रेडशीट पर लौटकर नई Daily वर्कशीट खोलें। परिणाम कुछ ऐसा दिखना चाहिए:

Apps Script में घड़ी आइकन से ट्रिगर खोलें और एक ट्रिगर जोड़ें:

ट्रिगर उसे बनाने वाले Google खाते के अंतर्गत चलता है। उस खाते को सक्रिय रखें और Apps Script की विफलता सूचनाओं की समीक्षा करें। अनावश्यक रूप से बार-बार अनुरोध न भेजें: NowMetrix सार्वजनिक API वर्तमान में प्रत्येक ट्रैकर के लिए प्रति मिनट 20 अनुरोधों की अनुमति देती है, जो सभी कुंजियों और उपयोगकर्ताओं के बीच साझा होती है।

उदाहरण प्रत्येक सफल रन पर पिछले 30 दिनों की तालिका को बदल देता है। इससे दोहराई गई तारीखें नहीं आतीं और शीट संक्षिप्त रहती है।

1. Looker Studio में रिपोर्ट बनाएँ या खोलें।
2. डेटा जोड़ें → Google Sheets चुनें।
3. स्प्रेडशीट और Daily वर्कशीट चुनें।
4. पहली पंक्ति को हेडर के रूप में इस्तेमाल करें और डेटा स्रोत कनेक्ट करें।
5. पुष्टि करें कि date एक तारीख है और pageviews तथा visits संख्यात्मक मेट्रिक्स हैं।

अब आप समय-श्रृंखला चार्ट, स्कोरकार्ड, तालिकाएँ और pageviews / visits जैसे परिकलित फ़ील्ड बना सकते हैं। Looker Studio इसे अलग डेटा स्रोत के रूप में पढ़ता है; यह NowMetrix के मानों को Google Analytics इवेंट में नहीं बदलता।

Google शेष रिपोर्ट सेटिंग्स को अपनी Google Sheets कनेक्टर मार्गदर्शिका में समझाता है।

• निर्यात के लिए अलग NowMetrix API कुंजी इस्तेमाल करें और केवल आवश्यक ट्रैकर की पहुँच दें।
• कुंजी को केवल स्क्रिप्ट प्रॉपर्टीज़ या किसी अन्य सर्वर-पक्षीय गुप्त संग्रह में रखें।
• Google Sheets की पहुँच को इसी दस्तावेज़ तक सीमित रखने के लिए स्क्रिप्ट में @OnlyCurrentDoc रखें।
• कुंजी को सेल, फ़ॉर्मूला, रिपोर्ट पैरामीटर, URL, स्क्रीनशॉट या लॉग में कभी शामिल न करें।
• Apps Script प्रोजेक्ट में संपादन की पहुँच सीमित रखें। संपादन की अनुमति वाले लोगों को विश्वसनीय उपयोगकर्ता मानना चाहिए।
• स्क्रिप्ट को तभी अधिकृत करें जब Google डेवलपर के रूप में आपका अपना खाता दिखाए।
• प्रत्येक NowMetrix खाते के लिए अलग ग्राहक-स्वामित्व वाली स्प्रेडशीट इस्तेमाल करें।
• रिपोर्ट प्रकाशित करने से पहले Google Sheet और Looker Studio, दोनों की साझा करने की सेटिंग्स की समीक्षा करें।
• यदि शीट, स्क्रिप्ट या Google खाते के साथ छेड़छाड़ होने की आशंका हो, तो API कुंजी तुरंत निरस्त करें।