YouTube Analytics API की मदद से, YouTube Analytics के डेटा वाली कस्टम रिपोर्ट जनरेट की जा सकती हैं. यह एपीआई, चैनलों और कॉन्टेंट के मालिकों के लिए रिपोर्ट जनरेट कर सकता है. रिपोर्ट के फ़ील्ड को डाइमेंशन या मेट्रिक के तौर पर दिखाया जाता है:
-
डाइमेंशन ऐसे सामान्य मानदंड होते हैं जिनका इस्तेमाल, डेटा को इकट्ठा करने के लिए किया जाता है. जैसे, कोई कार्रवाई किस तारीख को हुई या उपयोगकर्ता किस देश में मौजूद थे.
किसी रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का यूनीक कॉम्बिनेशन होता है. इसलिए, रिपोर्ट के लिए चुने गए डाइमेंशन से यह तय होता है कि 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 को गेम कंसोल पर कितनी बार देखा गया?)
-
डेटा के अपडेट होने की दर और इंतज़ार का समय
YouTube Analytics API में टारगेट की गई क्वेरी मौजूद होती हैं. हालांकि, Analytics का डेटा रीयल-टाइम में उपलब्ध नहीं होता. डेटा को प्रोसेस करने में आम तौर पर 48 से 72 घंटे लगते हैं. इसलिए, एपीआई के जवाब में हाल के दिनों का डेटा शामिल नहीं होता. साथ ही, आपकी रिपोर्ट की endDate में सिर्फ़ उस आखिरी दिन तक का डेटा शामिल होता है जिसके लिए अनुरोध की गई सभी मेट्रिक पूरी तरह से प्रोसेस हो चुकी हों.
डेटा मिलने में लगने वाले समय को देखते हुए, आपको एपीआई से मिले डेटा और YouTube Studio में दिखने वाली रीयल-टाइम मेट्रिक के बीच अंतर दिख सकता है. अगर आपके ऐप्लिकेशन को अलग-अलग
वीडियो के लिए रीयल-टाइम आंकड़े चाहिए, जैसे कि मौजूदा व्यू, पसंद या टिप्पणियों की संख्या, तो YouTube Analytics API के बजाय YouTube Data API के
तरीके
videos.list का इस्तेमाल करें.
रिपोर्ट वापस पाना
रिपोर्ट वापस पाने के लिए, एपीआई के reports.query तरीके को अनुमति वाला जीईटी अनुरोध भेजें. इसमें उन पैरामीटर के बारे में बताएं जिनकी मदद से, वापस पाने वाली रिपोर्ट तय की जाती है.
एपीआई से जनरेट की जा सकने वाली रिपोर्ट की सूची देखने के लिए, चैनल की रिपोर्ट और कॉन्टेंट के मालिकों के लिए रिपोर्ट से जुड़े दस्तावेज़ देखें. हर रिपोर्ट की परिभाषा में, उन वैल्यू की जानकारी दी जाती है जिन्हें रिपोर्ट में metrics, dimensions, और filters पैरामीटर के लिए इस्तेमाल किया जा सकता है.
सबसे सही तरीके
YouTube Analytics API का इस्तेमाल करने वाले ऐप्लिकेशन को हमेशा इन तरीकों का पालन करना चाहिए:
- रिपोर्ट के कॉलम का क्रम तय करने के लिए, जवाब की हेडर लाइन का इस्तेमाल करें. उदाहरण के लिए, यह न मान लें कि जवाब में व्यू की संख्या पहली मेट्रिक होगी, क्योंकि रिपोर्ट के ब्यौरे में यह पहली मेट्रिक के तौर पर शामिल है. इसके बजाय, यह तय करने के लिए कि उस डेटा वाला कॉलम कौनसा है, जवाब की हेडर लाइन का इस्तेमाल करें.
- YouTube Analytics API के जवाबों में तय किए गए संसाधनों के लिए, अतिरिक्त मेटाडेटा वापस पाने के लिए YouTube Data API का इस्तेमाल करें. YouTube API सेवाओं के लिए डेवलपर की नीतियों (सेक्शन III.E.4.b से III.E.4.d) में बताए गए मुताबिक, एपीआई क्लाइंट को 30 दिनों के बाद, सेव किए गए संसाधन के मेटाडेटा को या तो मिटाना होगा या उसे रीफ़्रेश करना होगा.
कुल मेट्रिक और मिटाए गए आइटम
YouTube Analytics API के जवाबों में, मिटाए गए आइटम के लिए मेट्रिक का ब्रेकडाउन शामिल नहीं होता. उदाहरण के लिए, अगर किसी चैनल का मालिक कोई वीडियो मिटाता है, तो वह वीडियो, एपीआई के उस जवाब में शामिल नहीं होगा जिसमें वीडियो के हिसाब से मेट्रिक दिखाई जाती हैं. हालांकि, संसाधनों के सेट के लिए कुल मेट्रिक दिखाने वाली रिपोर्ट में, मिटाए गए आइटम से जुड़ी मेट्रिक शामिल होती हैं.
उदाहरण के लिए, मान लें कि किसी चैनल का मालिक दो रिपोर्ट वापस पाता है. पहली रिपोर्ट में, किसी तय समयावधि के दौरान, चैनल के सभी वीडियो के लिए हर दिन के कुल व्यू की संख्या दिखाई जाती है. दूसरी रिपोर्ट में, उसी समयावधि के दौरान, वीडियो के हिसाब से हर दिन के कुल व्यू की संख्या दिखाई जाती है.
इस मामले में, पहली रिपोर्ट में उन वीडियो के व्यू की संख्या शामिल होगी जिन्हें बाद में मिटा दिया गया था. ऐसा इसलिए, क्योंकि पहली रिपोर्ट में हर दिन के कुल व्यू की संख्या दिखाई जाती है. हालांकि, दूसरी रिपोर्ट में मिटाए गए आइटम से जुड़े व्यू की संख्या शामिल नहीं होगी, क्योंकि दूसरी रिपोर्ट में वीडियो के हिसाब से व्यू की संख्या दिखाई जाती है. नतीजे के तौर पर, अगर चैनल ने रिपोर्ट में शामिल समयावधि के दौरान वीडियो मिटाए हैं, तो पहली रिपोर्ट में दिखाए गए हर दिन के कुल व्यू की संख्या, दूसरी रिपोर्ट में दिखाए गए हर दिन के वीडियो के हिसाब से व्यू की संख्या के योग से ज़्यादा हो सकती है.
डेटा की पहचान छिपाना
YouTube Analytics का कुछ डेटा सीमित होता है. ऐसा तब होता है, जब मेट्रिक में तय सीमा से कम डेटा होता है. ऐसा कई तरह की रिपोर्ट में हो सकता है. इसका मतलब है कि अगर किसी रिपोर्ट में आपका पूरा (या कोई भी) डेटा शामिल नहीं है, तो इसकी ये वजहें हो सकती हैं:
-
किसी तय समयावधि के दौरान, किसी वीडियो या चैनल पर सीमित ट्रैफ़िक हो,
या
-
आपने कोई ऐसा फ़िल्टर या डाइमेंशन चुना हो जिसकी वैल्यू, तय सीमा को पूरा न करती हों. जैसे, ट्रैफ़िक सोर्स या देश.
जब डेटा सीमित होता है, तब अलग-अलग रिपोर्ट के कुल डेटा में अंतर हो सकता है. यह इस बात पर निर्भर करता है कि वे रिपोर्ट किस तरह डेटा इकट्ठा करती हैं.
उदाहरण के लिए, मान लें कि किसी चैनल का मालिक दो रिपोर्ट वापस पाता है. पहली रिपोर्ट में, किसी वीडियो के कुल व्यू की संख्या दिखाई जाती है. वहीं, दूसरी रिपोर्ट में, उसी वीडियो के देश के हिसाब से कुल व्यू की संख्या दिखाई जाती है. मान लें कि इस तय समयावधि के दौरान वीडियो को 1,000 व्यू मिला. इस पर 500 व्यू अमेरिका से, 498 व्यू कनाडा से, और दो व्यू फ़्रांस से आया.
इस उदाहरण में, पहली रिपोर्ट से पता चलेगा कि वीडियो को 1,000 बार देखा गया. दूसरी रिपोर्ट से सिर्फ़ यह पता चलेगा कि वीडियो को अमेरिका में 500 बार और कनाडा में 498 बार देखा गया. इसलिए, दोनों रिपोर्ट में व्यू की कुल संख्या में अंतर दिखेगा. ध्यान दें कि दूसरी रिपोर्ट में यह जानकारी शामिल नहीं होगी कि वीडियो को दो अन्य लोगों ने भी देखा था या फ़्रांस में किसी ने नहीं देखा.
असल थ्रेशोल्ड जिन पर डेटा को सीमित तौर पर दिखाया जाता है उन्हें पब्लिश नहीं किया जाता. साथ ही, YouTube अपनी सूझ-बूझ से इनमें बदलाव कर सकता है.
सीमित डेटा के टाइप
YouTube Analytics की रिपोर्ट में, यह डेटा सीमित हो सकता है:
- डेमोग्राफ़िक्स डेटा, जैसे कि उम्र और लिंग.
- जगह की जानकारी का डेटा. इसमें, उन देशों या इलाकों से जुड़ी मेट्रिक या डाइमेंशन शामिल हैं जहां दर्शक मौजूद थे. जैसे, उनके देश या इलाके. हालांकि, ध्यान दें कि रिपोर्ट में, रेवेन्यू की मेट्रिक पर जगह की जानकारी के थ्रेशोल्ड लागू नहीं होते.
- ट्रैफ़िक के खास सोर्स से जुड़ी मेट्रिक. जैसे, खोज के लिए इस्तेमाल किए गए शब्द या बाहरी यूआरएल जिनकी वजह से आपके वीडियो को व्यू मिले. उदाहरण के लिए, खोज के लिए इस्तेमाल किए गए ऐसे शब्द और यूआरएल रिपोर्ट में नहीं दिखेंगे जिनकी वजह से वीडियो को बहुत कम व्यू मिले. हालांकि, आपको ऐसे शब्द और यूआरएल दिखते रहेंगे जिनकी वजह से ज़्यादा दर्शक आपके कॉन्टेंट तक पहुंचते हैं.
YouTube Analytics की रिपोर्ट में सीमित डेटा दिखने के बारे में ज़्यादा जानने के लिए, YouTube का सहायता केंद्र देखें.
इस्तेमाल किया गया कोटा
एपीआई का हर अनुरोध, आपके एपीआई के इस्तेमाल के कोटे की एक यूनिट के तौर पर गिना जाता है. कोटे की सीमाएं, Google API कंसोल में कोटे वाले पैनल पर दिखती हैं.