YouTube Analytics API की मदद से, YouTube Analytics के डेटा वाली कस्टम रिपोर्ट जनरेट की जा सकती हैं. यह API, चैनलों और कॉन्टेंट के मालिकों के लिए रिपोर्ट जनरेट करता है. रिपोर्ट फ़ील्ड को डाइमेंशन या मेट्रिक के तौर पर कैटगरी में बांटा जाता है:
-
डाइमेंशन, डेटा को एग्रीगेट करने के लिए इस्तेमाल किए जाने वाले सामान्य मानदंड होते हैं. जैसे, कार्रवाई होने की तारीख या वह देश जहां उपयोगकर्ता मौजूद थे.
रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का यूनीक कॉम्बिनेशन होता है. इसलिए, रिपोर्ट के लिए चुने गए डाइमेंशन से यह तय होता है कि YouTube, उस रिपोर्ट में मेट्रिक की वैल्यू कैसे कैलकुलेट करेगा.
- मेट्रिक, उपयोगकर्ता की गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित रेवेन्यू से जुड़े अलग-अलग मेज़रमेंट होते हैं. उपयोगकर्ता की गतिविधि से जुड़ी मेट्रिक में, वीडियो के व्यू की संख्या और रेटिंग (पसंद और नापसंद) जैसी चीज़ें शामिल होती हैं.
Analytics API, फ़िल्टर करने और क्रम से लगाने के पैरामीटर उपलब्ध कराता है. इसलिए, कॉल करने वाले ऐप्लिकेशन को उन फ़ंक्शन के लिए नेटिव तौर पर सहायता देने की ज़रूरत नहीं होती. इस एपीआई की मदद से, YouTube Analytics ग्रुप का डेटा भी वापस पाया जा सकता है. ग्रुप, पसंद के मुताबिक बनाया गया एक संग्रह होता है. इसमें ज़्यादा से ज़्यादा 500 वीडियो, प्लेलिस्ट, चैनल या ऐसेट शामिल हो सकते हैं.
रिपोर्ट के पैरामीटर चुनना
एपीआई की reports.query तरीके का इस्तेमाल करके रिपोर्ट का अनुरोध करने पर, एपीआई के अनुरोध में पांच पैरामीटर शामिल होते हैं. इनसे यह तय होता है कि रिपोर्ट की वैल्यू की गिनती कैसे की जाएगी:
-
startDateऔरendDateपैरामीटर, उस समयावधि के बारे में बताते हैं जिसके लिए रिपोर्ट में डेटा शामिल किया जाएगा. एपीआई के जवाब में, उस आखिरी दिन तक का डेटा शामिल होता है जिसके लिए क्वेरी के समय, क्वेरी में शामिल सभी मेट्रिक उपलब्ध होती हैं. -
metricsपैरामीटर, उन मेज़रमेंट के बारे में बताता है जिन्हें रिपोर्ट में शामिल किया जाएगा. चैनल की रिपोर्ट में, मेट्रिक से उपयोगकर्ता की गतिविधि का पता चलता है. इनमें व्यू और पसंद किए गए वीडियो जैसी वैल्यू शामिल होती हैं. कुछ मेट्रिक, विज्ञापन की परफ़ॉर्मेंस या अनुमानित रेवेन्यू का भी आकलन करती हैं. -
dimensionsपैरामीटर से पता चलता है कि मेट्रिक को कैसे ग्रुप किया जाएगा. -
filtersपैरामीटर से पता चलता है कि रिपोर्ट के डेटा को कैसे फ़िल्टर किया जाएगा. इसलिए, उदाहरण के लिए, किसी चैनल का पूरा डेटा दिखाने के बजाय, रिपोर्ट को फ़िल्टर करके सिर्फ़ किसी देश, वीडियो या वीडियो के ग्रुप की मेट्रिक दिखाई जा सकती हैं.ध्यान दें: एपीआई की मदद से, वीडियो, प्लेलिस्ट, और चैनल फ़िल्टर के लिए एक से ज़्यादा वैल्यू तय की जा सकती हैं. ऐसा करने पर, डाइमेंशन की सूची में उस फ़िल्टर को भी शामिल किया जा सकता है. इससे, दिखाई गई मेट्रिक को वीडियो, प्लेलिस्ट या चैनल के हिसाब से ग्रुप किया जा सकेगा.
रिपोर्टिंग के सैंपल विकल्प
उदाहरण के लिए, मान लें कि किसी चैनल के मालिक को वीडियो डिवाइस टाइप रिपोर्ट वापस लानी है. इससे वह यह पता लगा पाएगा कि चैनल के वीडियो को मोबाइल डिवाइसों, गेम कंसोल, टीवी वगैरह पर कितनी बार देखा गया.
-
चैनल का मालिक,
startDateपैरामीटर को2015-06-01औरendDateपैरामीटर को2015-07-31पर सेट करता है. इन वैल्यू के आधार पर, रिपोर्ट में दो महीने का डेटा शामिल होगा. -
डिवाइस टाइप रिपोर्ट में व्यू और estimatedMinutesWatched मेट्रिक काम करती हैं. इसलिए, चैनल का मालिक
metricsपैरामीटर कोviews,estimatedMinutesWatchedपर सेट करता है. -
dimensionsपैरामीटर के लिए, चैनल के मालिक के पास कई विकल्प होते हैं. इनमें से दो को यहां दी गई सूची में दिखाया गया है. तीसरे के बारे में इस सेक्शन में बाद में,filtersपैरामीटर की वैल्यू के बारे में बताया गया है.-
पैरामीटर वैल्यू को
deviceTypeपर सेट करने का मतलब है कि रिपोर्ट में शामिल पूरी अवधि के लिए, व्यू की संख्या और देखने के समय की संख्या को डिवाइस टाइप के हिसाब से ग्रुप किया जाएगा. इसलिए, इस वैल्यू के साथ रिपोर्ट का डेटा इन सवालों के जवाब देगा:- चैनल के वीडियो को 1 जून, 2015 से 31 जुलाई, 2015 के बीच मोबाइल डिवाइसों पर कितनी बार देखा गया?
- 1 जून, 2015 से 31 जुलाई, 2015 के बीच, गेम कंसोल पर चैनल के वीडियो कितनी बार देखे गए?
इस रिपोर्ट में, हर डिवाइस टाइप के लिए कुल व्यू और वीडियो देखने के कुल समय की जानकारी होगी.
-
पैरामीटर वैल्यू को
day,deviceTypeपर सेट करने का मतलब है कि रिपोर्टिंग की अवधि के दौरान, हर दिन के लिए डिवाइस टाइप के हिसाब से व्यू और देखने के समय की गिनती की जाएगी. इसलिए, इस वैल्यू के साथ रिपोर्ट का डेटा इन सवालों के जवाब देगा:- 1 जून, 2015 को मोबाइल डिवाइसों पर चैनल के वीडियो कितनी बार देखे गए?
- 14 जुलाई, 2015 को टीवी पर चैनल के वीडियो कितनी बार देखे गए?
-
-
आखिर में,
filtersपैरामीटर की मदद से चैनल का मालिक, रिपोर्ट में सिर्फ़ फ़िल्टर की खास वैल्यू से मैच करने वाला डेटा शामिल कर सकता है. रिपोर्ट में फ़िल्टर करने के कई विकल्प उपलब्ध हैं. इसलिए, उन सभी के बारे में बताना मुश्किल है. यहां दिए गए उदाहरण, जनरेट की जा सकने वाली रिपोर्ट का सिर्फ़ एक हिस्सा हैं.-
चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ Android ऑपरेटिंग सिस्टम के लिए वैल्यू दिखा सकता है. (रिपोर्टिंग की अवधि के दौरान, Android मोबाइल डिवाइसों पर कितने व्यू मिले?)
-
चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ किसी देश के लिए वैल्यू दिखा सकता है. (रिपोर्टिंग की अवधि के दौरान, कनाडा में हर दिन वीडियो कितनी बार देखे गए?)
-
चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ कुछ वीडियो के लिए वैल्यू वापस पाने का अनुरोध कर सकता है. हालांकि, वीडियो फ़िल्टर में कॉमा लगाकर अलग की गई वैल्यू की सूची का इस्तेमाल किया जा सकता है. इसलिए, रिपोर्ट में कई वीडियो का डेटा शामिल हो सकता है.
इसके अलावा, अगर वीडियो फ़िल्टर में एक से ज़्यादा वैल्यू दी गई हैं, तो वीडियो को डाइमेंशन के तौर पर भी सेट किया जा सकता है. इसका मतलब है कि
dimensionsपैरामीटर के लिए,deviceType,videoऔरday,deviceType,videoवैल्यू का भी इस्तेमाल किया जा सकता है.- अगर चैनल का मालिक, डाइमेंशन की सूची में वीडियो को शामिल करता है, तो मेट्रिक हर वीडियो के लिए अलग-अलग वैल्यू दिखाती हैं. (1 जून, 2015 को गेम कंसोल पर, वीडियो XYZ को कितनी बार देखा गया?)
- अगर चैनल का मालिक, डाइमेंशन की सूची में वीडियो को शामिल नहीं करता है, तो मेट्रिक में, बताए गए सभी वीडियो की कुल वैल्यू दिखती हैं. (1 जून, 2015 को गेम कंसोल पर, वीडियो ABC, DEF, और XYZ को कितनी बार देखा गया?)
-
रिपोर्ट वापस लाई जा रही हैं
रिपोर्ट वापस पाने के लिए, एपीआई के reports.query तरीके को अनुमति वाला GET अनुरोध भेजें. इसमें उन पैरामीटर के बारे में बताएं जिनसे आपको वापस पानी है.
एपीआई के साथ काम करने वाली रिपोर्ट की सूची देखने के लिए, चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट से जुड़े दस्तावेज़ देखें. हर रिपोर्ट डेफ़िनिशन से पता चलता है कि रिपोर्ट में metrics, dimensions, और filters पैरामीटर के लिए कौनसी वैल्यू इस्तेमाल की जा सकती हैं.
सबसे सही तरीके
YouTube Analytics API का इस्तेमाल करने वाले ऐप्लिकेशन को हमेशा इन तरीकों का पालन करना चाहिए:
- रिपोर्ट के कॉलम का क्रम तय करने के लिए, जवाब की हेडर लाइन का इस्तेमाल करें. उदाहरण के लिए, यह न मान लें कि व्यू, जवाब में दिखाई जाने वाली पहली मेट्रिक होगी. ऐसा इसलिए, क्योंकि रिपोर्ट के ब्यौरे में यह पहली मेट्रिक के तौर पर शामिल है. इसके बजाय, जवाब की हेडर लाइन का इस्तेमाल करके यह पता लगाएं कि उस डेटा को किस कॉलम में शामिल किया गया है.
- YouTube Analytics API की प्रतिक्रियाओं में पहचाने गए संसाधनों के लिए, अतिरिक्त मेटाडेटा पाने के लिए YouTube Data API का इस्तेमाल करें. YouTube API की सेवाओं के लिए डेवलपर से जुड़ी नीतियों (सेक्शन III.E.4.b से III.E.4.d) में बताया गया है कि API क्लाइंट को 30 दिनों के बाद, उस API से सेव किए गए संसाधन के मेटाडेटा को मिटाना या रीफ़्रेश करना होगा.
कुल मेट्रिक और मिटाए गए आइटम
YouTube Analytics API के जवाबों में, मिटाए गए आइटम के लिए मेट्रिक ब्रेकडाउन शामिल नहीं होते. उदाहरण के लिए, अगर चैनल का मालिक किसी वीडियो को मिटा देता है, तो वह वीडियो अब एपीआई के उस जवाब में नहीं दिखेगा जिसमें वीडियो के हिसाब से मेट्रिक दिखाई जाती हैं. हालांकि, संसाधनों के सेट के लिए कुल मेट्रिक वाली रिपोर्ट में, मिटाए गए आइटम से जुड़ी मेट्रिक अब भी शामिल होती हैं.
उदाहरण के लिए, मान लें कि चैनल का मालिक दो रिपोर्ट वापस पाता है. पहली रिपोर्ट में, किसी समयावधि के दौरान चैनल के सभी वीडियो को हर दिन मिले कुल व्यू की जानकारी दी जाती है. दूसरी रिपोर्ट में, उसी समयावधि के दौरान हर वीडियो के हिसाब से मिले कुल व्यू की जानकारी दी गई है.
इस मामले में, पहली रिपोर्ट में उन वीडियो के व्यू शामिल होंगे जिन्हें बाद में मिटा दिया गया था. ऐसा इसलिए, क्योंकि पहली रिपोर्ट में हर दिन के कुल व्यू शामिल होते हैं. हालांकि, दूसरी रिपोर्ट में मिटाए गए आइटम के व्यू शामिल नहीं किए जाएंगे, क्योंकि दूसरी रिपोर्ट में वीडियो के हिसाब से व्यू की जानकारी दी जाती है. इसलिए, अगर चैनल ने रिपोर्ट में शामिल समयावधि के दौरान वीडियो मिटाए हैं, तो पहली रिपोर्ट में बताए गए कुल रोज़ाना व्यू की संख्या, दूसरी रिपोर्ट में बताए गए रोज़ाना और वीडियो के हिसाब से व्यू की संख्या के योग से ज़्यादा हो सकती है.
डेटा की पहचान छिपाना
मेट्रिक में तय सीमा से कम डेटा होने पर, YouTube Analytics में शायद आपको पूरा डेटा न दिखे. ऐसा कई तरह की रिपोर्ट में हो सकता है. इसका मतलब है कि अगर:
-
किसी वीडियो या चैनल पर तय समयावधि के दौरान सीमित ट्रैफ़िक हो,
या
-
आपने ट्रैफ़िक सोर्स या देश जैसे किसी ऐसे फ़िल्टर या डाइमेंशन को चुना है जिसकी वैल्यू, तय थ्रेशोल्ड को पूरा नहीं करती हैं.
डेटा सीमित होने पर, अलग-अलग रिपोर्ट में बताए गए कुल योग में अंतर हो सकता है. यह अंतर, रिपोर्ट में डेटा को एग्रीगेट करने के तरीके पर निर्भर करता है.
उदाहरण के लिए, मान लें कि चैनल का मालिक दो रिपोर्ट वापस पाता है. पहली रिपोर्ट में, किसी वीडियो को मिले कुल व्यू की जानकारी होती है. वहीं, दूसरी रिपोर्ट में, उस वीडियो को हर देश में मिले कुल व्यू की जानकारी होती है. मान लें कि तय की गई समयावधि में, वीडियो को 1, 000 बार देखा गया. इनमें से 500 बार अमेरिका में, 498 बार कनाडा में, और दो बार फ़्रांस में देखा गया.
इस उदाहरण में, पहली रिपोर्ट से पता चलेगा कि वीडियो को 1,000 बार देखा गया. दूसरी रिपोर्ट में सिर्फ़ यह जानकारी होगी कि वीडियो को अमेरिका में 500 बार और कनाडा में 498 बार देखा गया. इसलिए, दोनों रिपोर्ट में व्यू की कुल संख्या में अंतर होगा. ध्यान दें कि दूसरी रिपोर्ट में यह जानकारी नहीं होगी कि दो अन्य व्यू भी मिले हैं या फ़्रांस में कोई व्यू मिला है.
असल थ्रेशोल्ड जिन पर डेटा को सीमित तौर पर दिखाया जाता है उन्हें पब्लिश नहीं किया जाता. साथ ही, YouTube अपनी सूझ-बूझ से इनमें बदलाव कर सकता है.
डेटा के सीमित टाइप
YouTube Analytics की रिपोर्ट में, आपको यह डेटा कम दिख सकता है:
- डेमोग्राफ़िक्स डेटा, जैसे कि उम्र और लिंग.
- भौगोलिक डेटा. इसमें उन देशों या इलाकों से जुड़ी मेट्रिक या डाइमेंशन शामिल होते हैं जहां दर्शक मौजूद थे. जैसे, उनके देश या इलाके. हालांकि, ध्यान दें कि रिपोर्ट में रेवेन्यू मेट्रिक पर, जगह के हिसाब से थ्रेशोल्ड लागू नहीं होते.
- ट्रैफ़िक के कुछ सोर्स से जुड़े आंकड़े. जैसे, खोज के लिए इस्तेमाल किए गए शब्द या बाहरी यूआरएल, जिनकी वजह से आपके वीडियो को व्यू मिले. उदाहरण के लिए, वीडियो खोजने के लिए इस्तेमाल हुए ऐसे शब्द और यूआरएल रिपोर्ट में नहीं दिखेंगे जिनसे बहुत कम व्यू मिलते हैं. हालांकि, आपको वीडियो खोजने के लिए इस्तेमाल हुए ऐसे शब्द और यूआरएल दिखेंगे जिनसे ज़्यादातर दर्शक आपके कॉन्टेंट तक पहुंचते हैं.
YouTube Analytics की रिपोर्ट में सीमित डेटा दिखने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
कोटा का इस्तेमाल
एपीआई के लिए किए गए हर अनुरोध को, एपीआई इस्तेमाल करने के कोटा की एक यूनिट के तौर पर गिना जाता है. कोटा की सीमाएं, Google API Console में कोटा पैनल पर दिखती हैं.