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पर सेट करता है. इन वैल्यू के आधार पर, रिपोर्ट में दो महीने का डेटा शामिल होगा.डिवाइस टाइप की रिपोर्ट में, views और estimatedMinutesWatched मेट्रिक काम करती हैं. इसलिए, चैनल का मालिक
metricsपैरामीटर कोviews,estimatedMinutesWatchedपर सेट करता है.dimensionsपैरामीटर के लिए, चैनल के मालिक के पास कई विकल्प होते हैं. इनमें से दो को यहां दी गई सूची में दिखाया गया है. तीसरे के बारे में, इस सेक्शन में आगेfiltersपैरामीटर वैल्यू की जानकारी में बताया गया है.पैरामीटर वैल्यू को
deviceTypeपर सेट करने का मतलब है कि व्यू की संख्या और वीडियो देखने के कुल समय को डिवाइस टाइप के हिसाब से ग्रुप किया जाएगा. ऐसा रिपोर्ट में शामिल पूरी अवधि के लिए किया जाएगा. इस वैल्यू की मदद से, रिपोर्ट के डेटा से इन सवालों के जवाब मिलेंगे:1 जून, 2015 से 31 जुलाई, 2015 के बीच, चैनल के वीडियो मोबाइल डिवाइसों पर कितनी बार देखे गए?
1 जून, 2015 से 31 जुलाई, 2015 के बीच, गेम कंसोल पर चैनल के वीडियो कितनी बार देखे गए?
इस रिपोर्ट में, हर तरह के डिवाइस के लिए कुल व्यू और वीडियो देखने के कुल समय की जानकारी शामिल होगी.
पैरामीटर वैल्यू को
day,deviceTypeपर सेट करने का मतलब है कि रिपोर्टिंग अवधि के दौरान, हर दिन के लिए व्यू की संख्या और देखने का कुल समय की गिनती, डिवाइस टाइप के हिसाब से की जाएगी. इस वैल्यू की मदद से, रिपोर्ट के डेटा से इन सवालों के जवाब मिलेंगे:1 जून, 2015 को मोबाइल डिवाइसों पर चैनल के वीडियो कितनी बार देखे गए?
चैनल के वीडियो, 14 जुलाई, 2015 को टीवी पर कितनी बार देखे गए?
आखिर में,
filtersपैरामीटर की मदद से चैनल का मालिक, रिपोर्ट को सीमित कर सकता है. इससे रिपोर्ट में सिर्फ़ वही डेटा शामिल किया जा सकता है जो फ़िल्टर की गई खास वैल्यू से मैच करता हो. रिपोर्ट में फ़िल्टर करने के कई विकल्प होते हैं. इसलिए, उन सभी के बारे में बताना मुमकिन नहीं है. ये उदाहरण, जनरेट की जा सकने वाली रिपोर्ट का सिर्फ़ एक हिस्सा हैं.चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ Android ऑपरेटिंग सिस्टम के लिए वैल्यू दिखा सकता है. (रिपोर्टिंग अवधि के दौरान, Android फ़ोन या टैबलेट पर कितने व्यू मिले?)
चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ किसी खास देश के लिए वैल्यू देख सकता है. (रिपोर्टिंग अवधि के दौरान, कनाडा में हर दिन वीडियो कितनी बार देखे गए?)
चैनल का मालिक, अनुरोध को फ़िल्टर करके सिर्फ़ कुछ वीडियो के लिए वैल्यू दिखा सकता है. हालांकि, वीडियो फ़िल्टर में, कॉमा लगाकर अलग की गई वैल्यू की सूची का इस्तेमाल किया जा सकता है. इसलिए, रिपोर्ट में कई वीडियो का डेटा शामिल हो सकता है.
इसके अलावा, अगर video फ़िल्टर में कई वैल्यू दी गई हैं, तो video को डाइमेंशन के तौर पर भी सेट किया जा सकता है. इसका मतलब है कि
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 Analytics की रिपोर्ट में, यह डेटा सीमित हो सकता है:
- डेमोग्राफ़िक्स डेटा, जैसे कि उम्र और लिंग.
- भौगोलिक डेटा, जिसमें दर्शकों की मौजूदगी वाले देशों या इलाकों से जुड़ी मेट्रिक या डाइमेंशन शामिल हैं. जैसे, उनके देश या इलाके. हालांकि, ध्यान दें कि रिपोर्ट में रेवेन्यू मेट्रिक पर, देश या इलाके के हिसाब से थ्रेशोल्ड लागू नहीं होते.
- ट्रैफ़िक के खास सोर्स से जुड़ी मेट्रिक. जैसे, खोज के लिए इस्तेमाल हुए शब्द या बाहरी यूआरएल, जिनकी वजह से आपके वीडियो पर व्यू मिले. उदाहरण के लिए, खोज के लिए इस्तेमाल हुए ऐसे शब्द और यूआरएल जिनसे बहुत कम व्यू मिले हैं वे रिपोर्ट में नहीं दिखेंगे. हालांकि, आपको खोज के लिए इस्तेमाल हुए ऐसे शब्द और यूआरएल अब भी दिखेंगे जिनसे आपके कॉन्टेंट पर बहुत ज़्यादा व्यू मिले हैं.
YouTube Analytics की रिपोर्ट में सीमित डेटा दिखने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
इस्तेमाल किया गया कोटा
आपके हर एपीआई अनुरोध को, एपीआई इस्तेमाल करने के कोटे की एक यूनिट के तौर पर गिना जाता है. कोटा की सीमाएं, Google Cloud Console में कोटा पैनल पर दिखती हैं.