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

Google Analytics मैनेजमेंट एपीआई की मदद से, प्रोग्राम के तौर पर बनी नमूनारहित रिपोर्ट बनाई जा सकती हैं.

इसके बारे में जानकारी

नमूनारहित रिपोर्ट, 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 में सेव है, तो आप फ़ाइल और # 39; के रिसॉर्स यूआरएल के लिए एचटीटीपी एचटीटीपी अनुरोध पाने का अनुरोध कर सकते हैं. साथ ही, 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 एपीआई की पुष्टि करने का दायरा भी शामिल है. इससे, दोनों एपीआई के लिए पुष्टि करने वाले एक ही टोकन का इस्तेमाल किया जा सकेगा.

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

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

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

बिना सैंपल वाली रिपोर्ट बनाने के लिए, ये पाबंदियां लागू होती हैं:

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

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

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

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

नमूनारहित रिपोर्ट और कोर रिपोर्टिंग API

अगर आप रिपोर्ट डेटा फिर से पाने के लिए कोर रिपोर्टिंग एपीआई का इस्तेमाल करते हैं और उसमें सैंपल किया गया डेटा होता है, तो आप इस तरह की क्वेरी के लिए सैंपल के बिना तैयार की गई रिपोर्ट बना सकते हैं:

  1. कोर रिपोर्टिंग एपीआई अनुरोध करें.
  2. जवाब में, इसमें शामिल किए गएडेटा के सैंपल वाला प्रॉपर्टी देखें और देखें कि डेटा का सैंपल लिया गया है या नहीं.
  3. अगर यह प्रॉपर्टी सही पर सेट है, तो आप बिना सैंपल वाली रिपोर्ट के लिए, अनुरोध करने के लिए एक ही जवाब से क्वेरी और profileInfo फ़ील्ड का इस्तेमाल कर सकते हैं.

कोर रिपोर्टिंग एपीआई रिस्पॉन्स का सैंपल क्वेरी फ़ील्ड:

"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
}

कोर रिपोर्टिंग एपीआई रिस्पॉन्स से profileInfo फ़ील्ड का सैंपल:

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

यहां एक उदाहरण है. इसमें मुख्य रिपोर्टिंग एपीआई रिस्पॉन्स से बिना सैंपल वाली रिपोर्ट बनाने का तरीका बताया गया है:

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();
}

एक से ज़्यादा दिनों के लिए, बिना सैंपल वाला डेटा स्टिच करना

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

कोटा नीति

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