YouTube Analytics API - Data Model

YouTube Analytics एपीआई की मदद से, YouTube Analytics डेटा वाली कस्टम रिपोर्ट जनरेट की जा सकती हैं. एपीआई, चैनलों और कॉन्टेंट के मालिकों की रिपोर्ट दिखाता है. रिपोर्ट फ़ील्ड को डाइमेंशन या मेट्रिक की तरह माना जाता है:

  • डाइमेंशन सामान्य मानदंड होते हैं, जिनका इस्तेमाल डेटा इकट्ठा करने के लिए किया जाता है, जैसे कि जिस तारीख को कार्रवाई हुई या उपयोगकर्ता किस देश में था.

    रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का यूनीक कॉम्बिनेशन होता है. इसलिए, रिपोर्ट के लिए चुने गए डाइमेंशन से यह तय होता है कि YouTube, रिपोर्ट में दी गई मेट्रिक के वैल्यू का हिसाब कैसे लगाता है.

  • मेट्रिक, उपयोगकर्ता की गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित आय से जुड़े अलग-अलग मेज़रमेंट होते हैं. उपयोगकर्ता गतिविधि की मेट्रिक में, वीडियो देखे जाने की संख्या और रेटिंग (पसंद और नापसंद) जैसी चीज़ें शामिल होती हैं.

Analytics API में फ़िल्टर करने और क्रम से लगाने के पैरामीटर मौजूद हैं. इसलिए, कॉलिंग ऐप्लिकेशन को, इन फ़ंक्शन के साथ काम करने की ज़रूरत नहीं है. एपीआई की मदद से, YouTube Analytics ग्रुप का डेटा भी वापस पाया जा सकता है. ग्रुप में 500 वीडियो, प्लेलिस्ट, चैनलों या एसेट को शामिल किया जाता है.

रिपोर्ट पैरामीटर चुनना

जब किसी रिपोर्ट का अनुरोध किया जाता है, तब एपीआई के reports.query तरीके का इस्तेमाल करके, एपीआई अनुरोध में पांच पैरामीटर शामिल होते हैं. इन पैरामीटर से तय होता है कि रिपोर्ट की वैल्यू को कैसे कैलकुलेट किया जाएगा:

  • startDate और endDate पैरामीटर से पता चलता है कि रिपोर्ट में किस समयावधि का डेटा शामिल होगा. एपीआई रिस्पॉन्स में असल में पिछले दिन तक का डेटा शामिल होता है जिसके लिए क्वेरी में सभी क्वेरी क्वेरी में उपलब्ध होती हैं.

  • metrics पैरामीटर से, रिपोर्ट में शामिल किए जाने वाले मेज़रमेंट के बारे में पता चलता है. चैनल रिपोर्ट में, मेट्रिक, उपयोगकर्ता की गतिविधि को मेज़र करती हैं. साथ ही, इनमें व्यू और पसंद जैसी वैल्यू शामिल होती हैं. कुछ मेट्रिक, विज्ञापन की परफ़ॉर्मेंस या अनुमानित आय को भी मेज़र करती हैं.

  • dimensions पैरामीटर से पता चलता है कि मेट्रिक को कैसे ग्रुप किया जाएगा.

  • filters पैरामीटर से पता चलता है कि रिपोर्ट का डेटा कैसे फ़िल्टर किया जाएगा. उदाहरण के लिए, किसी चैनल का पूरा डेटा दिखाने के बजाय, रिपोर्ट को फ़िल्टर किया जा सकता है. इसमें, सिर्फ़ किसी खास देश, वीडियो या वीडियो के ग्रुप की मेट्रिक शामिल होती हैं.

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

सैंपल रिपोर्टिंग के विकल्प

उदाहरण के तौर पर, मान लीजिए कि चैनल का मालिक यह जानने के लिए वीडियो डिवाइस प्रकार की रिपोर्ट पाना चाहता है कि मोबाइल डिवाइस, गेम कंसोल, टीवी वगैरह पर चैनल के वीडियो को कितने बार देखा गया है.

  • चैनल का मालिक, 2015-06-01 को startDate पैरामीटर और 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 तरीके पर एक ऐसा जीईटी अनुरोध भेजें, जिसे अनुमति मिल चुकी हो. इसमें वे पैरामीटर भी शामिल होने चाहिए जो रिपोर्ट को फिर से हासिल करना चाहते हैं.

एपीआई के साथ काम करने वाली रिपोर्ट की सूची के लिए, चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट से जुड़ा दस्तावेज़ देखें. हर रिपोर्ट की परिभाषा से उन वैल्यू का पता चलता है जिनकी अनुमति रिपोर्ट में, metrics, dimensions, और filters पैरामीटर के लिए होती है.

सबसे सही तरीके

YouTube Analytics API का इस्तेमाल करने वाले ऐप्लिकेशन को हमेशा इन तरीकों का पालन करना चाहिए:

  • रिपोर्ट के कॉलम का क्रम तय करने के लिए, रिस्पॉन्स के हेडर की लाइन का इस्तेमाल करें. उदाहरण के लिए, यह न मानें कि व्यू किसी रिस्पॉन्स में दी गई पहली मेट्रिक होगी. ऐसा सिर्फ़ इसलिए होगा, क्योंकि यह रिपोर्ट के ब्यौरे में दी गई पहली मेट्रिक है. इसके बजाय, रिस्पॉन्स की हेडर लाइन का इस्तेमाल करके, यह तय करें कि किस कॉलम में वह डेटा मौजूद है.
  • YouTube Analytics एपीआई के जवाबों में मिले संसाधनों के लिए ज़्यादा मेटाडेटा पाने के लिए, YouTube डेटा एपीआई का इस्तेमाल करें. जैसा कि YouTube API सेवाओं के डेवलपर की नीतियों (सेक्शन III.E.4.b से III.E.4.d) में बताया गया है, एपीआई क्लाइंट को 30 दिनों के बाद, एपीआई से सेव किए गए रिसॉर्स मेटाडेटा को मिटाना या रीफ़्रेश करना होगा.

मेट्रिक और मिटाए गए आइटम इकट्ठा करें

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

उदाहरण के लिए, मान लें कि चैनल का मालिक दो रिपोर्ट लोड करता है. पहली रिपोर्ट में, एक खास समयावधि के दौरान, चैनल के सभी वीडियो को हर दिन मिलने वाले कुल व्यू की सूची बनाई जाती है. दूसरी रिपोर्ट में किसी खास समयावधि के दौरान वीडियो-दर-वीडियो के आधार पर हर दिन मिलने वाले कुल व्यू की सूची होती है.

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

डेटा की पहचान छिपाना

अगर मेट्रिक, थ्रेशोल्ड तक नहीं पहुंच पाती हैं, तो YouTube Analytics का कुछ डेटा सीमित तौर पर दिखाया जाता है. ऐसा कई रिपोर्ट में हो सकता है. व्यावहारिक तौर पर, इसका मतलब यह हो सकता है कि किसी रिपोर्ट में आपका पूरा (या कोई भी) डेटा शामिल न हो, अगर:

  1. किसी वीडियो या चैनल पर सीमित समय में सीमित ट्रैफ़िक आता है,

    या

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

डेटा सीमित होने पर, अलग-अलग रिपोर्ट में दिखने वाली कुल रिपोर्ट में फ़र्क़ हो सकता है. यह इस बात पर निर्भर करता है कि रिपोर्ट में कुल डेटा कैसे दिखता है.

उदाहरण के लिए, मान लें कि चैनल का मालिक दो रिपोर्ट लोड करता है. पहली रिपोर्ट किसी खास वीडियो के कुल व्यू की सूची बनाती है. वहीं दूसरी रिपोर्ट में उस देश के हिसाब से, देश के आधार पर कुल व्यू की सूची होती है. किसी खास समयावधि के दौरान, मान लें कि वीडियो को 1,000 बार देखा गया, जहां अमेरिका में 500 व्यू हुए, कनाडा में 498, और फ़्रांस में दो व्यू हुए.

इस उदाहरण में, पहली रिपोर्ट बताती है कि वीडियो को 1000 बार देखा गया है. दूसरी रिपोर्ट सिर्फ़ यह बताती है कि अमेरिका में वीडियो को 500 बार और कनाडा में 498 बार देखा गया. इस तरह, दोनों रिपोर्ट में व्यू की कुल संख्या में अंतर होगा. ध्यान दें कि दूसरी रिपोर्ट में इस बात का कोई संकेत नहीं होगा कि दो अन्य व्यू भी हुए हैं (या कोई व्यू फ़्रांस में हुआ है).

डेटा की सीमित सीमाएं, पब्लिश नहीं की जाती हैं. साथ ही, YouTube अपनी सूझ-बूझ से भी इसमें बदलाव कर सकता है.

सीमित डेटा टाइप

नीचे दी गई जानकारी, YouTube Analytics की रिपोर्ट में सीमित हो सकती है:

  • डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) का डेटा, जैसे कि उम्र और लिंग.
  • भौगोलिक डेटा में, उन देशों या इलाकों से जुड़ी मेट्रिक या डाइमेंशन शामिल हैं जहां के उपयोगकर्ता रहे हैं, जैसे कि उनके देश या इलाके. हालांकि, ध्यान रखें कि ये रिपोर्ट, आय की मेट्रिक पर देश या इलाके के हिसाब से थ्रेशोल्ड लागू नहीं करती हैं.
  • खोज के लिए इस्तेमाल हुए शब्दों या बाहरी यूआरएल जैसे खास ट्रैफ़िक सोर्स से जुड़ी मेट्रिक, जिनकी वजह से आपके वीडियो देखे गए. उदाहरण के लिए, खोज के लिए इस्तेमाल हुए ऐसे शब्द और यूआरएल जो रिपोर्ट में बहुत कम संख्या में दिखते हैं, रिपोर्ट में नहीं दिखेंगे. हालांकि, आपको ऐसे शब्द और यूआरएल दिखेंगे जो आपके कॉन्टेंट पर बहुत ज़्यादा दर्शक लाते हैं.

YouTube Analytics रिपोर्ट में सीमित डेटा के बारे में ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.

कोटा का इस्तेमाल

एपीआई से किए गए आपके हर अनुरोध को, आपके एपीआई के इस्तेमाल की सीमा के तौर पर गिना जाता है. कोटा की सीमाएं, Google API Console में कोटा पैनल पर दिखती हैं.