ध्यान दें:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
इस पेज पर ऐसी रिपोर्ट मौजूद हैं जिन्हें कॉन्टेंट के मालिक, YouTube Analytics API की मदद से हासिल कर सकते हैं. कॉन्टेंट के मालिक की रिपोर्ट में, YouTube कॉन्टेंट के किसी खास मालिक से लिंक किए गए चैनलों की मेट्रिक शामिल होती हैं. उपयोगकर्ता गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित रेवेन्यू के अलग-अलग मेज़रमेंट को मेट्रिक कहते हैं.
वीडियो रिपोर्ट में उपयोगकर्ता गतिविधि, विज्ञापन की परफ़ॉर्मेंस, और कॉन्टेंट के मालिक के चैनलों पर मौजूद वीडियो से मिलने वाले अनुमानित रेवेन्यू की मेट्रिक शामिल होती हैं.
प्लेलिस्ट रिपोर्ट में वे आंकड़े होते हैं जो खास तौर पर, प्लेलिस्ट से जुड़े वीडियो पर मिले व्यू से जुड़े होते हैं. प्लेलिस्ट रिपोर्ट में कई ऐसे डाइमेंशन और फ़िल्टर का इस्तेमाल किया जाता है जिनका इस्तेमाल वीडियो रिपोर्ट करता है.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, आय और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक शामिल होती हैं. वे adType डाइमेंशन का इस्तेमाल करके, वीडियो चलाने के दौरान दिखाए गए विज्ञापनों के टाइप के हिसाब से मेट्रिक का ग्रुप बनाते हैं. विज्ञापन की परफ़ॉर्मेंस रिपोर्ट सेक्शन में, विज्ञापन की परफ़ॉर्मेंस से जुड़ी दो तरह की मेट्रिक की जानकारी दी जाती है. ये मेट्रिक, एपीआई पर काम करती हैं.
रिपोर्ट फिर से पाना
कॉन्टेंट के मालिक की रिपोर्ट को फिर से पाने के लिए, एपीआई के reports.query तरीके का इस्तेमाल करें. साथ ही, एपीआई अनुरोध में ids पैरामीटर वैल्यू को contentOwner==OWNER_NAME पर सेट करें. यहां OWNER_NAME, कॉन्टेंट के मालिक के आईडी के बारे में बताता है. अगर आपको इसके बारे में पता नहीं है, तो अपने पार्टनर मैनेजर से पूछें.
अनुमति
YouTube Analytics एपीआई के सभी अनुरोधों को अनुमति मिलना ज़रूरी है. अनुमति देने वाली गाइड में, अनुमति देने वाले टोकन वापस पाने के लिए, OAuth 2.0 प्रोटोकॉल का इस्तेमाल करने का तरीका बताया गया है.
YouTube Analytics API के अनुरोध, अनुमति देने के इन दायरों का इस्तेमाल करते हैं:
अपने YouTube कॉन्टेंट की YouTube Analytics रिपोर्ट देखें. इस दायरे की मदद से, उपयोगकर्ता गतिविधि की मेट्रिक को ऐक्सेस किया जा सकता है. जैसे, व्यू की संख्या और रेटिंग की संख्या.
अपने YouTube कॉन्टेंट के लिए YouTube Analytics की पैसे से जुड़ी रिपोर्ट देखना. इस स्कोप से, उपयोगकर्ता गतिविधि की मेट्रिक के साथ-साथ अनुमानित रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक का ऐक्सेस मिलता है.
https://www.googleapis.com/auth/youtube
अपना YouTube खाता मैनेज करें. YouTube Analytics API में, चैनल के मालिक इस दायरे का इस्तेमाल, YouTube Analytics के ग्रुप और ग्रुप आइटम को मैनेज करने के लिए करते हैं.
https://www.googleapis.com/auth/youtubepartner
YouTube पर मौजूद ऐसेट और उनसे जुड़ा कॉन्टेंट देखें और मैनेज करें. 'YouTube Analytics एपीआई' में, कॉन्टेंट के मालिक इस दायरे का इस्तेमाल YouTube Analytics के ग्रुप और ग्रुप आइटम को मैनेज करने के लिए करते हैं.
ध्यान दें: तारे के निशान (*) के निशान वाली मेट्रिक के लिए, https://www.googleapis.com/auth/yt-analytics-monetary.readonly के स्कोप का ऐक्सेस देने वाले ऑथराइज़ेशन टोकन की ज़रूरत होती है.
फ़िल्टर
कॉन्टेंट के मालिक की रिपोर्ट पाने के सभी एपीआई अनुरोधों में, डेटा को video डाइमेंशन, channel डाइमेंशन, isCurated डाइमेंशन या claimedStatus और uploaderType डाइमेंशन के साथ काम करने वाले कॉम्बिनेशन का इस्तेमाल करके फ़िल्टर किया जाना चाहिए. (काम करने वाले कॉम्बिनेशन, uploaderType डाइमेंशन की परिभाषा में दिए गए हैं.)
काम करने वाली रिपोर्ट की जानकारी देने वाली टेबल, उन फ़िल्टर की पहचान करती हैं जिनका इस्तेमाल किसी रिपोर्ट के लिए किया जा सकता है. ब्यौरे में, ब्रैकेट में दिखाए गए फ़िल्टर वैकल्पिक होते हैं. उदाहरण के लिए, अगर किसी रिपोर्ट में video(,country) को फ़िल्टर करने के विकल्प के तौर पर शामिल किया गया है, तो रिपोर्ट को फ़िल्टर करके सिर्फ़ किसी खास वीडियो का डेटा शामिल किया जा सकता है या सिर्फ़ किसी खास देश के किसी वीडियो का डेटा शामिल किया जा सकता है.
इस एपीआई में video, playlist, और channel फ़िल्टर के लिए, एक से ज़्यादा वैल्यू तय करने की सुविधा भी है. अगर इनमें से किसी एक फ़िल्टर के लिए एक से ज़्यादा वैल्यू तय की जाती हैं, तो आपके पास उस फ़िल्टर को अनुरोध के लिए तय किए गए डाइमेंशन की सूची में जोड़ने का विकल्प भी होता है. अगर किसी रिपोर्ट के लिए, फ़िल्टर को इस्तेमाल किए जा सकने वाले डाइमेंशन के तौर पर शामिल नहीं किया गया है, तब भी ऐसा ही होगा.
किसी खास वैल्यू या वैल्यू के सेट के लिए, एपीआई के नतीजों को फ़िल्टर करने का तरीका जानने के लिए, filters पैरामीटर की परिभाषा देखें.
रिपोर्ट टेबल के बारे में समझना
इस सेक्शन में, टेबल में इस्तेमाल की गई फ़ॉर्मैटिंग और शब्दावली के बारे में बताया गया है. ये टेबल, उन रिपोर्ट के बारे में बताती हैं जो एपीआई के साथ काम करती हैं. नीचे दी गई टेबल में, टाइम डाइमेंशन और averageViewPercentage मेट्रिक का इस्तेमाल करके,
वीडियो चलाने की जानकारी देने वाले वीडियो की रिपोर्ट के लिए इस्तेमाल किए जा सकने वाले डाइमेंशन, मेट्रिक, और फ़िल्टर दिए गए हैं.
टेबल में डाइमेंशन के लिए दो लाइनें, मेट्रिक के लिए एक लाइन, और फ़िल्टर के लिए तीन लाइनें होती हैं. डाइमेंशन और फ़िल्टर
के लिए, हर लाइन की वैल्यू को एपीआई अनुरोध में जोड़ा जा सकता है. हालांकि, ऐसा तब ही हो सकता है,
जब कॉम्बिनेशन टेबल में दिए गए, इस्तेमाल के नियमों के हिसाब से हो. उदाहरण के लिए, इस रिपोर्ट के लिए मान्य dimensions
पैरामीटर वैल्यू में ये शामिल हैं:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
हालांकि, पैरामीटर वैल्यू day,month अमान्य है, क्योंकि यह समय पर आधारित दो डाइमेंशन का इस्तेमाल करती है. हालांकि, अनुरोध 0 या 1 का इस्तेमाल कर सकता है. इस मामले में, पैरामीटर वैल्यू subscribedStatus,youtubeProduct असल में रिपोर्ट दिखाती है, लेकिन मेट्रिक को दिन, हफ़्ते, महीने वगैरह के हिसाब से एग्रीगेट नहीं किया जाता. (इस रिपोर्ट को दस्तावेज़ में अलग से दर्ज किया जाता है.)
रिपोर्ट टेबल शब्दावली
डाइमेंशन ज़रूरी हैं या ज़रूरी नहीं हैं, यह बताने के लिए टेबल इन शब्दावली का इस्तेमाल करती है:
इन शब्दों का मतलब है कि वैल्यू डालना ज़रूरी है:
ज़रूरी है: आपको वैल्यू शामिल करनी होगी.
सिर्फ़ एक वैल्यू इस्तेमाल करें: आपको ग्रुप से एक वैल्यू शामिल करनी होगी.
एक या उससे ज़्यादा वैल्यू का इस्तेमाल करें: ग्रुप से किसी एक या सभी वैल्यू को शामिल किया जा सकता है. हालांकि, इसमें कम से कम एक वैल्यू शामिल करना ज़रूरी है.
इन शब्दों का मतलब है कि वैल्यू ज़रूरी नहीं है:
ज़रूरी नहीं: आपके पास वैल्यू शामिल करने का विकल्प होता है.
0 या 1 का इस्तेमाल करें: आपके पास ग्रुप से एक वैल्यू शामिल करने का विकल्प होता है.
0 या इससे ज़्यादा का इस्तेमाल करें: आपके पास ग्रुप से किसी एक या सभी वैल्यू को शामिल करने का विकल्प होता है.
अहम जानकारी: कॉन्टेंट के मालिक की वीडियो रिपोर्ट पाने के सभी एपीआई अनुरोधों में, डेटा को वीडियो डाइमेंशन, चैनल डाइमेंशन, ग्रुप डाइमेंशन या फिर claimedStatus और uploaderType डाइमेंशन के साथ काम करने वाले कॉम्बिनेशन का इस्तेमाल करके फ़िल्टर किया जाना चाहिए. (कुछ रिपोर्ट में वे सभी विकल्प काम नहीं करते.) इस्तेमाल किए जा सकने वाले ये कॉम्बिनेशन, uploaderType डाइमेंशन की डेफ़िनिशन में भी शामिल हैं:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
वीडियो रिपोर्ट
बुनियादी आंकड़े
बुनियादी आंकड़े (इसमें सदस्यों की संख्या भी शामिल है)
यह रिपोर्ट कॉन्टेंट के मालिक के सभी चैनलों पर उपयोगकर्ता की कार्रवाइयों से जुड़े आंकड़े दिखाती है. रिपोर्ट को इस तरह से फ़िल्टर किया जा सकता है कि सिर्फ़ किसी खास वीडियो या देश का डेटा दिखे. इसका इस्तेमाल सिर्फ़ दावा किए गए कॉन्टेंट के आंकड़े पाने के लिए भी किया जा सकता है. इसमें कॉन्टेंट के मालिक, तीसरे पक्ष या दोनों की ओर से अपलोड किया गया वह कॉन्टेंट शामिल है जिस पर दावा किया गया है.
यह रिपोर्ट किसी खास अमेरिकी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के आंकड़े देती है. ध्यान दें कि यह रिपोर्ट, सिर्फ़ ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के किसी सबसेट के साथ काम करती है.
यह रिपोर्ट खास समयावधि के लिए कॉन्टेंट के मालिक के सभी चैनलों पर उपयोगकर्ता की कार्रवाइयों से जुड़े आंकड़े दिखाती है. रिपोर्ट को इस तरह से फ़िल्टर किया जा सकता है कि सिर्फ़ किसी खास वीडियो या देश का डेटा दिखे.
खास समयावधि के दौरान, अमेरिका में उपयोगकर्ता की गतिविधि
यह रिपोर्ट किसी खास अमेरिकी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के आंकड़े देती है. ध्यान दें कि यह रिपोर्ट, सिर्फ़ ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के किसी सबसेट के साथ काम करती है.
यह रिपोर्ट कॉन्टेंट के मालिक के सभी चैनलों के लिए, हर देश के हिसाब से उपयोगकर्ता गतिविधि से जुड़े आंकड़े उपलब्ध कराती है. रिपोर्ट को इस तरह से फ़िल्टर किया जा सकता है कि सिर्फ़ किसी खास वीडियो या चैनल का डेटा दिखे.
यह रिपोर्ट, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, उपयोगकर्ता की गतिविधि के आंकड़े उपलब्ध कराती है. इस रिपोर्ट के लिए, आपको filters पैरामीटर की वैल्यू को country==US पर सेट करना होगा.
शहर के हिसाब से उपयोगकर्ता की गतिविधि (<= 250 नतीजे)
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 250 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. दूसरी रिपोर्ट के उलट, इस रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होती है.
यह रिपोर्ट शहर के आधार पर उपयोगकर्ता गतिविधि के आंकड़े उपलब्ध कराती है.
वीडियो चलाने की जानकारी वाली रिपोर्ट में, वीडियो देखने के इन एट्रिब्यूट से जुड़े आंकड़े मिलते हैं:
क्या किसी लाइव वीडियो ब्रॉडकास्ट या मांग पर उपलब्ध वीडियो देखा जा रहा था?
क्या दर्शक ने उस चैनल की सदस्यता ली थी जिसके पास वीडियो का मालिकाना हक है?
वीडियो किस YouTube प्रॉडक्ट पर देखा गया?
तकनीकी रूप से, इन रिपोर्ट में वीडियो चलाने की जानकारी वाले डाइमेंशन देना ज़रूरी नहीं है. अगर अपने अनुरोध में, वीडियो चलाने की जानकारी वाले डाइमेंशन को शामिल नहीं किया जाता है, तो आपको जो रिपोर्ट मिलेगी वह बुनियादी आंकड़ों, समय के हिसाब से या उपयोगकर्ता के देश या इलाके की रिपोर्ट जैसी ही होगी.
ध्यान दें:liveOrOnDemand डाइमेंशन और फ़िल्टर का इस्तेमाल, averageViewPercentage मेट्रिक के साथ नहीं किया जा सकता. इसी तरह, नीचे दिए गए हर सब-सेक्शन में दो रिपोर्ट दी गई हैं. एक रिपोर्ट liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करती है, जबकि दूसरी रिपोर्ट averageViewPercentage मेट्रिक के साथ काम करती है.
सदस्यता की स्थिति के हिसाब से उपयोगकर्ता की गतिविधि
यह रिपोर्ट, आपके चैनल की सदस्यता लेने वाले और सदस्यता नहीं लेने वाले दर्शकों के लिए, उपयोगकर्ता गतिविधि की मेट्रिक उपलब्ध कराती है. आंकड़ों को समयावधि (दिन या महीने) के हिसाब से ग्रुप में रखा जा सकता है. साथ ही, रिपोर्ट को देश, महाद्वीप या subContinent के हिसाब से भी फ़िल्टर किया जा सकता है.
प्रांतों के लिए सदस्यता की स्थिति के आधार पर उपयोगकर्ता की गतिविधि
यह रिपोर्ट, अमेरिका के राज्यों या डिस्ट्रिक्ट ऑफ़ कोलंबिया में, सदस्यता लेने वाले और सदस्यता नहीं लेने वाले दर्शकों के लिए, उपयोगकर्ता गतिविधि की मेट्रिक उपलब्ध कराती है. इस रिपोर्ट में, पिछली रिपोर्ट की तुलना में कम मेट्रिक इस्तेमाल की जा सकती हैं.
इन रिपोर्ट के लिए समय डाइमेंशन – दिन या महीना – ज़रूरी नहीं है, क्योंकि आपको रिपोर्ट में शामिल की जाने वाली तारीख की सीमा तय करने के लिए, startDate और endDate अनुरोध पैरामीटर का इस्तेमाल करना होगा. अगर डाइमेंशन मौजूद है, तो इससे पता चलता है कि आपको रिपोर्ट में डेटा को दिन, महीने वगैरह के हिसाब से एग्रीगेट करना है.
वैकल्पिक समय डाइमेंशन और liveOrOnDemand के आंकड़ों के साथ वीडियो चलाने की जानकारी
यह रिपोर्ट खास समय अंतरालों के लिए वीडियो चलाने की जानकारी के आंकड़े दिखाती है. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
यह रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. यह averageViewPercentage मेट्रिक के लिए सहायता जोड़ता है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर, liveOrOnDemand के साथ काम नहीं करता.
liveOrOnDemand के आंकड़ों के साथ, प्रांत के हिसाब से वीडियो चलाने की जानकारी
यह रिपोर्ट अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के वीडियो चलाने की जानकारी के आंकड़े देती है. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
यह रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. यह averageViewPercentage मेट्रिक के लिए सहायता जोड़ता है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर, liveOrOnDemand के साथ काम नहीं करता.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. दूसरी रिपोर्ट के उलट, इस रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होती है.
इस रिपोर्ट से, एम्बेड किए गए उन वीडियो प्लेयर की पहचान की जाती है जिनकी वजह से कॉन्टेंट के मालिक के कॉन्टेंट को सबसे ज़्यादा व्यू या देखने का समय सबसे ज़्यादा मिला. इस रिपोर्ट को वापस पाने के लिए, आपको insightPlaybackLocationType फ़िल्टर को EMBEDDED पर सेट करना होगा.
इस रिपोर्ट में, दर्शकों के आपके वीडियो कॉन्टेंट तक पहुंचने के तरीके के आधार पर आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Google Search या किसी मिलते-जुलते वीडियो के लिंक से आने वाले व्यू की संख्या की पहचान करता है.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. दूसरी रिपोर्ट के उलट, इस रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होती है.
इस रिपोर्ट में उन रेफ़रर के आधार पर वीडियो देखे जाने के आंकड़े इकट्ठा किए जाते हैं जिनसे कॉन्टेंट के मालिक के कॉन्टेंट को सबसे ज़्यादा व्यू मिले हैं. रेफ़रर को ट्रैफ़िक सोर्स के टाइप के हिसाब से अलग-अलग कैटगरी में बांटा जाता है. वहीं insightTrafficSourceDetail डाइमेंशन की मदद से, उन ट्रैफ़िक सोर्स की पहचान की जाती है जिनके लिए रिपोर्ट उपलब्ध है. उदाहरण के लिए, अगर आपने insightTrafficSourceType फ़िल्टर को ADVERTISING पर सेट किया है, तो रिपोर्ट में ऐसे विज्ञापनों के टाइप की सूची होगी जिन्होंने कॉन्टेंट के मालिक के कॉन्टेंट को सबसे ज़्यादा व्यू या देखे जाने का समय सबसे ज़्यादा जनरेट किया है.
ध्यान दें: यह रिपोर्ट सिर्फ़ कुछ खास ट्रैफ़िक सोर्स के लिए काम करती है. उदाहरण के लिए, NO_LINK_EMBEDDED ट्रैफ़िक सोर्स में ज़्यादा जानकारी नहीं होती, इसलिए यह इस रिपोर्ट के साथ काम नहीं करता. किन ट्रैफ़िक सोर्स पर यह रिपोर्ट काम करती है, इस बारे में जानकारी के लिए insightTrafficSourceType की परिभाषा देखें.
डिवाइस का टाइप और ऑपरेटिंग सिस्टम
डिवाइस का टाइप
इस रिपोर्ट में, आपके वीडियो देखने के दौरान जिस तरह के डिवाइस का इस्तेमाल किया गया था उसके आधार पर आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह टैबलेट या गेम कंसोल पर हुए व्यू की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम के हिसाब से, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android डिवाइसों या PlayStations पर देखे जाने की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम और डिवाइस टाइप के आधार पर, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android टैबलेट या Windows डेस्कटॉप डिवाइसों पर मिले व्यू की संख्या की पहचान करता है.
ध्यान दें:subscribedStatus वाले वीडियो की जानकारी देने वाले डाइमेंशन की अलग-अलग वैल्यू के लिए, इस रिपोर्ट में viewerPercentage की वैल्यू को सामान्य नहीं बनाया जाता है.
फ़िल्टर का इस्तेमाल करके, यह पक्का किया जा सकता है कि रिपोर्ट में subscribedStatus डाइमेंशन की एक वैल्यू के लिए, सिर्फ़ viewerPercentage डेटा को शामिल किया जाए.
दर्शकों की दिलचस्पी और कॉन्टेंट शेयर करना
इस रिपोर्ट से पता चलता है कि चैनल के वीडियो अलग-अलग सोशल प्लैटफ़ॉर्म पर कितनी बार शेयर किए गए.
इस रिपोर्ट की मदद से, यह पता लगाया जाता है कि वीडियो अपनी ऑडियंस को बनाए रख सकता है या नहीं. elapsedVideoTimeRatio डाइमेंशन, उन वीडियो की संख्या मेज़र करता है जो इनसे जुड़ी मेट्रिक वैल्यू के लिए बीत चुके हैं. audienceWatchRatio और relativeRetentionPerformance मेट्रिक से दो आंकड़े मिलते हैं. इनसे पता चलता है कि वीडियो, दर्शकों को बनाए रखने में कितना कामयाब होता है. पहला विकल्प एक निरपेक्ष मान है, जबकि दूसरे दिखाता है कि वीडियो की परफ़ॉर्मेंस, मिलती-जुलती अवधि वाले दूसरे YouTube वीडियो के मुकाबले कैसी है.
ध्यान दें: दर्शक बनाए रखने की रिपोर्ट में, video फ़िल्टर के लिए वैल्यू की कॉमा-सेपरेटेड लिस्ट नहीं बनाई जा सकती. वैल्यू में सिर्फ़ एक वीडियो आईडी होना चाहिए.
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. सिर्फ़ सबसे लोकप्रिय 10 वीडियो का डेटा ही 1 जनवरी 2013 से पहले का है. दूसरी रिपोर्ट के उलट, इन रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होगी.
देश, महाद्वीप या उपमहाद्वीप के हिसाब से, सबसे ज़्यादा देखे गए वीडियो (<= 200 रिज़ल्ट)
इस रिपोर्ट में फ़िल्टर करने और क्रम से लगाने की तय शर्तों के आधार पर कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची होती है.
अमेरिका के राज्य के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, अमेरिका के किसी खास राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया में कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची होती है. ध्यान दें कि यह रिपोर्ट, सिर्फ़ ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के किसी सबसेट के साथ काम करती है.
जिन दर्शकों ने आपके चैनल की सदस्यता ली है या जिन्होंने सदस्यता नहीं ली है उनके लिए सबसे ज़्यादा देखे गए वीडियो(<= 200 नतीजे)
इस रिपोर्ट में, सबसे ज़्यादा देखे गए वीडियो की सूची होती है. इसमें उन दर्शकों के बारे में जानकारी होती है जिन्होंने आपके चैनल की सदस्यता ली है या जिन्होंने सदस्यता नहीं ली है. देश, महाद्वीप या subContinent के हिसाब से, सबसे लोकप्रिय वीडियो की सूची बनाने के लिए, रिपोर्ट को फ़िल्टर किया जा सकता है. पिछली रिपोर्ट की मदद से, आपको अमेरिका के किसी खास राज्य में, उन दर्शकों के सबसे ज़्यादा देखे गए वीडियो के बारे में जानकारी मिलती है जिन्होंने आपके चैनल की सदस्यता ली है या जिन्होंने सदस्यता नहीं ली है. हालांकि, इस रिपोर्ट की तुलना में, यह रिपोर्ट कम मेट्रिक के साथ काम करती है.
YouTube के प्रॉडक्ट के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, सबसे ज़्यादा देखे गए वीडियो की जानकारी दी जाती है. साथ ही, वीडियो चलाने की जानकारी और भौगोलिक फ़िल्टर के साथ-साथ इन्हें भी फ़िल्टर किया जा सकता है. यह रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. हालांकि, इसमें कम मेट्रिक इस्तेमाल की जा सकती हैं. साथ ही, इसमें youtubeProduct फ़िल्टर के साथ काम करने की सुविधा भी है.
वीडियो चलाने की जानकारी वाले फ़िल्टर वाले सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची दी जाती है. इन वीडियो को वीडियो चलाने की जानकारी वाले एक या इससे ज़्यादा डाइमेंशन के हिसाब से फ़िल्टर किया जाता है: liveOrOnDemand, subscribedStatus, और youtubeProduct. इस रिपोर्ट में, इलाके के हिसाब से डेटा को फ़िल्टर करने की सुविधा भी होती है.
प्लेलिस्ट से जुड़ी रिपोर्ट में, चैनल के मालिक की प्लेलिस्ट में मौजूद वीडियो पर उपयोगकर्ता की गतिविधि से जुड़ी मेट्रिक
मौजूद होती हैं. इन रिपोर्ट के दो वर्शन उपलब्ध हैं और हर उपलब्ध रिपोर्ट के लिए,
इन सेक्शन में हर वर्शन की जानकारी होती है:
हर सेक्शन में मौजूद सुझाया गया टैब, एपीआई के अनुरोध के पसंदीदा फ़ॉर्मैट के बारे में बताता है,
ताकि इससे जुड़ी रिपोर्ट को वापस पाया जा सके. सुझाई गई रिपोर्ट, मेट्रिक के एक बड़े सेट के साथ काम करती हैं.
इसमें, एग्रीगेट की गई वीडियो मेट्रिक और
इन-प्लेलिस्ट मेट्रिक, दोनों शामिल होती हैं. अनुरोध का यह फ़ॉर्मैट,
isCurated डाइमेंशन का इस्तेमाल नहीं करता.
हर सेक्शन में isCurated का इस्तेमाल करना टैब से, एपीआई अनुरोध के एक पुराने फ़ॉर्मैट के बारे में पता चलता है. इसमें isCurated डाइमेंशन की ज़रूरत होती है. इन रिपोर्ट में, सिर्फ़
इन-प्लेलिस्ट मेट्रिक इस्तेमाल की जा सकती हैं. ध्यान दें कि
isCurated डाइमेंशन सभी रिपोर्ट के लिए अब काम नहीं करता. नीचे दी गई चेतावनी में,
सुविधा बंद होने के शेड्यूल के बारे में बताया गया है.
नीचे दी गई चेतावनी में, रिपोर्ट के दोनों वर्शन के बीच हुए बदलावों के बारे में ज़्यादा जानकारी दी गई है.
एग्रीगेट किए गए वीडियो की मेट्रिक
ये मेट्रिक, उपयोगकर्ता की गतिविधि और इंप्रेशन से जुड़ी मेट्रिक उपलब्ध कराती हैं.
ये मेट्रिक, प्लेलिस्ट में मौजूद सभी वीडियो के लिए एग्रीगेट की जाती हैं.
साथ ही, इन मेट्रिक का मालिकाना हक, प्लेलिस्ट के मालिकाना हक वाले चैनल के पास भी होता है. दूसरे चैनलों के मालिकाना हक वाले वीडियो की मेट्रिक को एग्रीगेशन में नहीं गिना जाता. इस वजह से, अगर कोई चैनल ऐसी
प्लेलिस्ट बनाता है जिसमें सिर्फ़ दूसरे चैनलों के मालिकाना हक वाले वीडियो शामिल हैं, तो उन प्लेलिस्ट की
रिपोर्ट में इन मेट्रिक का डेटा नहीं मिलेगा.
YouTube पर काम करने वाले वीडियो मेट्रिक की सूची देखने के लिए, प्लेलिस्ट की मेट्रिक से जुड़ी मेट्रिक सेक्शन देखें. इस सूची में सभी वीडियो मेट्रिक शामिल हैं.
इन-प्लेलिस्ट मेट्रिक
इन मेट्रिक से, प्लेलिस्ट पेज के लिए उपयोगकर्ता गतिविधि और यूज़र ऐक्टिविटी के बारे में पता चलता है. इन मेट्रिक में, प्लेलिस्ट में मौजूद सभी वीडियो पर मिले व्यू की संख्या शामिल होती है. भले ही, उनका मालिकाना हक किसी भी चैनल पर हो. हालांकि, इसमें सिर्फ़ प्लेलिस्ट में मौजूद वीडियो पर मिले व्यू शामिल किए जाते हैं.
Play Books पर काम करने वाली प्लेलिस्ट से जुड़ी मेट्रिक
यह रिपोर्ट, कॉन्टेंट के मालिक के चैनलों की प्लेलिस्ट के वीडियो के साथ, उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े उपलब्ध कराती है. रिपोर्ट में कोई ज़रूरी डाइमेंशन नहीं है.
इस रिपोर्ट में, कॉन्टेंट के मालिक के चैनलों की प्लेलिस्ट में मौजूद वीडियो के साथ, उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े दिए जाते हैं. ये आंकड़े खास समय के अंतराल में दिखाए जाते हैं. रिपोर्ट को इस तरह फ़िल्टर किया जा सकता है कि सिर्फ़ किसी
प्लेलिस्ट या चैनल का डेटा दिखे.
यह रिपोर्ट, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, प्लेलिस्ट पर की गई गतिविधि के आंकड़े की जानकारी देती है. इस रिपोर्ट के लिए, filters पैरामीटर वैल्यू में country==US शामिल किया जाता है.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. दूसरी रिपोर्ट के उलट, इस रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होती है.
इस रिपोर्ट से, एम्बेड किए गए उन वीडियो प्लेयर की पहचान की जाती है जिनकी वजह से, किसी कॉन्टेंट के मालिक की प्लेलिस्ट को सबसे ज़्यादा व्यू या देखने का समय सबसे ज़्यादा मिला.
इस रिपोर्ट में, प्लेलिस्ट के कॉन्टेंट को दर्शकों के पहुंचने के तरीके के आधार पर इकट्ठा किया जाता है. उदाहरण के लिए, यह Google Search या चैनल पेज से आने वाले व्यू की संख्या की पहचान करता है.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. दूसरी रिपोर्ट के उलट, इस रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होती है.
इस रिपोर्ट में उन रेफ़रर के आधार पर आंकड़े इकट्ठा किए जाते हैं जिनसे कॉन्टेंट के मालिक की प्लेलिस्ट को सबसे ज़्यादा व्यू मिले. रेफ़रर को ट्रैफ़िक सोर्स के टाइप के हिसाब से अलग-अलग कैटगरी में बांटा जाता है. वहीं insightTrafficSourceDetail डाइमेंशन की मदद से, उन ट्रैफ़िक सोर्स की पहचान की जाती है जिनके लिए रिपोर्ट उपलब्ध है. उदाहरण के लिए, अगर insightTrafficSourceType फ़िल्टर को ADVERTISING पर सेट किया जाता है, तो रिपोर्ट में ऐसे विज्ञापनों के टाइप जोड़े जाएंगे जिन्होंने सबसे ज़्यादा व्यू जनरेट किए हैं या कॉन्टेंट के मालिक की प्लेलिस्ट के हिसाब से वीडियो देखने का समय सबसे ज़्यादा है.
ध्यान दें: यह रिपोर्ट सिर्फ़ कुछ खास ट्रैफ़िक सोर्स के लिए काम करती है. उदाहरण के लिए, NO_LINK_EMBEDDED ट्रैफ़िक सोर्स में ज़्यादा जानकारी नहीं होती, इसलिए यह इस रिपोर्ट के साथ काम नहीं करता. किन ट्रैफ़िक सोर्स पर यह रिपोर्ट काम करती है, इस बारे में जानकारी के लिए insightTrafficSourceType की परिभाषा देखें.
डिवाइस का टाइप और ऑपरेटिंग सिस्टम
प्लेलिस्ट के लिए डिवाइस का टाइप
इस रिपोर्ट में, आपके प्लेलिस्ट के कॉन्टेंट को देखने के लिए इस्तेमाल किए गए डिवाइस के आधार पर आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह मोबाइल डिवाइसों या गेम कंसोल को देखे जाने की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम के हिसाब से, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android डिवाइसों या PlayStation पर प्लेलिस्ट को देखे जाने की संख्या की पहचान करता है.
प्लेलिस्ट के लिए ऑपरेटिंग सिस्टम और डिवाइस का टाइप
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम और डिवाइस टाइप के आधार पर, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android टैबलेट या Windows डेस्कटॉप डिवाइसों पर वीडियो सूची को देखे जाने की संख्या की पहचान करता है.
ध्यान दें: वीडियो चलाने की जानकारी वाले डाइमेंशन (subscribedStatus और youtubeProduct) के लिए, अलग-अलग वैल्यू या वैल्यू को मिले-जुले होने के लिए, इस रिपोर्ट में viewerPercentage वैल्यू को सामान्य नहीं किया जाता है. उदाहरण के लिए, subscribedStatus डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट में, viewerPercentage डेटा जोड़ा जाता है. यह डेटा, उन व्यू औरमें जोड़े गए उपयोगकर्ताओं के लिए 10% हो जाता है जिन्होंने सदस्यता छोड़ दी है viewerPercentage (रिपोर्ट में सभी viewerPercentage फ़ील्ड की कुल संख्या 200 प्रतिशत है.
यह पक्का करने के लिए कि रिपोर्ट में प्लेबैक की जानकारी वाले डाइमेंशन के लिए, सिर्फ़ एक मान (या अलग-अलग वैल्यू के कॉम्बिनेशन) के लिए viewerPercentage डेटा को ही शामिल किया जाए, फ़िल्टर का इस्तेमाल किया जा सकता है.
सबसे ज़्यादा देखी जाने वाली प्लेलिस्ट
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या इससे कम पूर्णांक वैल्यू पर सेट करना होगा. सिर्फ़ सबसे ज़्यादा देखी गई 10 प्लेलिस्ट का डेटा ही 1 जनवरी, 2013 से पहले का है. दूसरी रिपोर्ट के उलट, इन रिपोर्ट में भी आपको sort अनुरोध पैरामीटर के लिए एक वैल्यू तय करनी होगी.
इस रिपोर्ट में फ़िल्टर करने और क्रम से लगाने की तय शर्तों के आधार पर, कॉन्टेंट के मालिक की सबसे लोकप्रिय प्लेलिस्ट की सूची होती है.
ध्यान दें: विज्ञापन की परफ़ॉर्मेंस रिपोर्ट के लिए, अनुमति वाले टोकन की ज़रूरत होती है, जो https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप का ऐक्सेस देता हो.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट, वीडियो चलाने के दौरान दिखाए गए विज्ञापनों के लिए इंप्रेशन पर आधारित मेट्रिक देती हैं. ये मेट्रिक हर विज्ञापन इंप्रेशन का आकलन करती हैं और हर वीडियो प्लेबैक से कई इंप्रेशन मिल सकते हैं.
इंप्रेशन पर आधारित विज्ञापन की परफ़ॉर्मेंस मेट्रिक:
इसके अलावा, कुछ वीडियो रिपोर्ट में, वीडियो चलाने पर आधारित विज्ञापन की परफ़ॉर्मेंस के बारे में नीचे दी गई मेट्रिक दिखती हैं. हालांकि, विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में इन मेट्रिक को शामिल नहीं किया जाता.
