नमूनारहित रिपोर्ट की डेवलपर गाइड

Google Analytics Management API से आप प्रोग्राम के हिसाब से नमूनारहित रिपोर्ट बना सकते हैं.

शुरुआती जानकारी

पूरे डेटा पर आधारित रिपोर्ट, Google Analytics की वे रिपोर्ट होती हैं जो पूरे डेटा का इस्तेमाल करके जनरेट की जाती हैं. फ़िलहाल, नमूनारहित रिपोर्ट सिर्फ़ Google Analytics 360 के उपयोगकर्ताओं के लिए उपलब्ध हैं.

इस एपीआई की मदद से:

  • अपनी सभी मौजूदा नमूनारहित रिपोर्ट के बारे में कॉन्फ़िगरेशन जानकारी फिर से पाएं. एक-बार नमूनारहित रिपोर्ट बनाएं.
  • नमूनारहित रिपोर्ट की प्रोसेसिंग स्थिति देखें.
  • प्रोसेसिंग पूरी हो जाने के बाद, नमूनारहित रिपोर्ट की डेटा फ़ाइल का लिंक पाएं.
  • नमूनारहित रिपोर्ट मिटाएं.

नमूनारहित रिपोर्ट के लिए डेटा वापस पाना

जब कोई नमूनारहित रिपोर्ट बनाई जाती है, तो रिपोर्ट उपलब्ध होने और डाउनलोड होने में कुछ समय लग सकता है. नमूनारहित रिपोर्ट का status फ़ील्ड बताता है कि उस रिपोर्ट की प्रोसेसिंग पूरी हो चुकी है या नहीं. स्टेटस को COMPLETED के तौर पर मार्क करने के बाद, downloadType और उससे जुड़े डाउनलोड की जानकारी वाले फ़ील्ड का इस्तेमाल करके, रिपोर्ट के डेटा वाली फ़ाइल को वापस लाया जा सकता है. उदाहरण के लिए:

  • अगर downloadType की वैल्यू GOOGLE_DRIVE है, तो driveDownloadDetails फ़ील्ड का इस्तेमाल करें.
  • अगर downloadType की वैल्यू GOOGLE_CLOUD_STORAGE है, तो cloudStorageDownloadDetails फ़ील्ड का इस्तेमाल करें.

इन रिपोर्ट की स्थिति जांचने के लिए लगातार, ज़्यादा दर वाले, पोल का इस्तेमाल न करें, क्योंकि आपका रोज़ का कोटा जल्दी खत्म हो सकता है. नमूनारहित रिपोर्ट की स्थिति की जांच करते समय, आपको अनुरोधों के बीच कुछ समय का अंतर दिखना चाहिए.

Google Drive / Google Cloud Storage API का इस्तेमाल करना

आपकी फ़ाइलें कहां डिलीवर की जा रही हैं (Google Drive या Google Cloud Storage), इसके हिसाब से आपको उस फ़ाइल का एक लिंक मिलेगा. इस लिंक का इस्तेमाल करके, फ़ाइल डाउनलोड करने के लिए Drive API या Cloud Storage API का इस्तेमाल किया जा सकता है. फ़ाइल को वापस पाने के तरीके के बारे में ज़्यादा जानकारी के लिए, Google Drive API या Google Cloud Storage API से जुड़ा दस्तावेज़ देखें.

उदाहरण के लिए, अगर आपकी नमूनारहित रिपोर्ट Google Drive में सेव है, तो आपके पास फ़ाइल के रिसॉर्स यूआरएल में, अनुमति वाला एचटीटीपी GET अनुरोध भेजने और क्वेरी पैरामीटर alt=media को शामिल करने का विकल्प है.

GET /drive/v2/files/XXXXXX?alt=media
Host: www.googleapis.com
Content-length: 0
Authorization: Bearer ya29.AHESVbXTUv5mHMo3RYfmS1YJonjzzdTOFZwvyOAUVhrs

XXXXXX, नमूनारहित रिपोर्ट कहां है driveDownloadDetails.documentId

पुष्टि करना

अगर आपको फ़ाइल डाउनलोड के लिए Drive या Cloud Storage API के साथ नमूनारहित रिपोर्ट का इस्तेमाल करना है, तो OAuth 2.0 टोकन का अनुरोध करते समय आपको उस एपीआई से जुड़े पुष्टि करने का दायरा (Analytics API की पुष्टि करने के दायरे के अलावा) भी शामिल करना होगा. इससे दोनों एपीआई के लिए, पुष्टि करने वाले एक ही टोकन का इस्तेमाल किया जा सकेगा.

नमूनारहित रिपोर्ट मिटाना

शेड्यूल की गई या पूरी की गई नमूनारहित रिपोर्ट मिटाई जा सकती हैं. हालांकि, रिपोर्ट जनरेट होने के दौरान delete को कॉल करने पर, आपको गड़बड़ी का मैसेज मिलेगा. नमूनारहित रिपोर्ट मिटाने से सिर्फ़ आपके GA व्यू (प्रोफ़ाइल) से संसाधन हटता है. साथ ही, Google Drive या Google Cloud Storage में एक्सपोर्ट किया गया डेटा पहले जैसा ही रहेगा.

ज़रूरी शर्तें

नमूनारहित रिपोर्ट बनाने पर ये पाबंदियां लागू होती हैं:

  • सिर्फ़ चार डाइमेंशन तय किए जा सकते हैं.
  • कुछ टाइप के रिपोर्टिंग डेटा का इस्तेमाल नहीं किया जा सकता, जैसे कि Google Ads का डेटा.
  • उन क्वेरी का इस्तेमाल नहीं किया जा सकता जो बहुत महंगी हैं.
  • अगर आपने बहुत ज़्यादा नमूनारहित रिपोर्ट बनाई हैं और सीमा तक पहुंच गए हैं, तो आपके पास बिना सैंपल वाली रिपोर्ट के संसाधनों को सुरक्षित तरीके से मिटाने का विकल्प है. ऐसा करने से, जनरेट किए गए रिपोर्ट डेटा को Google Drive या Google Cloud में वैसे ही छोड़ दिया जाएगा.

अगर यह पाया जाता है कि आपका अनुरोध बहुत महंगा है, तो 'बनाएं' कार्रवाई करने पर सही मैसेज के साथ गड़बड़ी का मैसेज दिखेगा. अगर ऐसा होता है, तो:

  • कम डाइमेंशन का अनुरोध करें.
  • क्वेरी को तारीख की छोटी सीमाओं के साथ कई क्वेरी में बांटें. साथ ही, तैयार होने वाली सभी रिपोर्ट को एक साथ जोड़ें.

इस्तेमाल के उदाहरण

नमूनारहित रिपोर्ट और Core Reporting API

अगर रिपोर्ट का डेटा वापस पाने के लिए, Core Reporting API का इस्तेमाल किया जाता है और उसमें सैंपल डेटा मौजूद है, तो उसी क्वेरी के लिए इस तरह से नमूनारहित रिपोर्ट बनाई जा सकती है:

  1. Core Reporting API के लिए अनुरोध करें.
  2. इस रिस्पॉन्स में, isSampledData प्रॉपर्टी की जांच करके देखें कि डेटा का सैंपल लिया गया है या नहीं.
  3. अगर इस प्रॉपर्टी को 'सही है' पर सेट किया जाता है, तो एक ही रिस्पॉन्स से क्वेरी और ProfileInfo फ़ील्ड का इस्तेमाल करके, पूरे डेटा वाली रिपोर्ट का अनुरोध किया जा सकता है.

Core Reporting API से मिले रिस्पॉन्स का सैंपल क्वेरी फ़ील्ड:

"query": {
  "start-date": "2011-01-01",
  "end-date": "2011-01-31",
  "ids": "ga:1234",
  "dimensions": "ga:browser",
  "metrics": [
  "ga:visits"
  ],
  "filters": "ga:country==US",
  "start-index": 1,
  "max-results": 1000
}

Core Reporting API से मिले रिस्पॉन्स का profileInfo फ़ील्ड:

"profileInfo": {
  "profileId": "1234",
  "accountId": "12345",
  "webPropertyId": "UA-12345-1",
  "internalWebPropertyId": "11254",
  "profileName": "Name of the profile",
  "tableId": "ga:1234"
}

Core Reporting API के रिस्पॉन्स से नमूनारहित रिपोर्ट बनाने का उदाहरण नीचे दिया गया है:

Java

// Make a Core Reporting API call.
GaData reportingApiData = v3.data().ga().get(...).execute();

// Check if the response is sampled.
if (reportingApiData.getContainsSampledData()) {

  // Use the “query” object to construct an unsampled report object.
  Query query = reportingApiData.getQuery();
  UnsampledReport report = new UnsampledReport()
      .setDimensions(query.getDimensions())
      .setMetrics(Joiner.on(',').join(query.getMetrics()))
      .setStartDate(startDate)
      .setEndDate(endDate)
      .setSegment(query.getSegment())
      .setFilters(query.getFilters())
      .setTitle(“My unsampled report”);

  // Use “profileInfo” to create an InsertRequest for creating an
  // unsampled report.
  ProfileInfo profileInfo = reportingApiData.getProfileInfo();
  Insert insertRequest = analytics.management().unsampledReports()
  .insert(profileInfo.getAccountId(),
          profileInfo.getWebPropertyId(),
          profileInfo.getProfileId(),
          report);
  UnsampledReport createdReport = insertRequest.execute();
}

पूरे डेटा पर आधारित डेटा को कई दिनों तक स्टिचिंग करना

किसी खास तारीख की सीमा के लिए, बिना सैंपल वाला डेटा पाने के लिए, कई दिनों तक रिपोर्ट को एक साथ जोड़ा या जोड़ा जा सकता है. यह तब काम आता है, जब पूरे डेटा के लिए किए गए अनुरोध का साइज़ बहुत बड़ा हो. ऐसे मामलों में, अनुरोध को एक से ज़्यादा अनुरोधों में बांटा जा सकता है. हालांकि, इसके लिए तारीख की सीमा कम होनी चाहिए और फिर नतीजों को एक साथ जोड़ा जा सकता है.

कोटा नीति

नमूनारहित रिपोर्ट बनाते समय लागू होने वाली सीमाओं और कोटा की पूरी सूची के लिए, कॉन्फ़िगरेशन और रिपोर्टिंग API की सीमाएं और कोटा देखें.