ध्यान दें: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 API के सभी अनुरोधों को स्वीकार किया जाना चाहिए. अनुमति से जुड़ी गाइड में, ऑथराइज़ेशन टोकन पाने के लिए 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 ऐसेट और उससे जुड़ा कॉन्टेंट देखें और मैनेज करें. YouTube Analytics API में, कॉन्टेंट के मालिक इस स्कोप का इस्तेमाल करके, 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,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
हालांकि, पैरामीटर की वैल्यू day,month अमान्य है, क्योंकि इसमें समय पर आधारित दो डाइमेंशन का इस्तेमाल किया गया है. साथ ही, अनुरोध में 0 या 1 का इस्तेमाल करना ज़रूरी है.
रिपोर्ट टेबल की शब्दावली
टेबल में, डाइमेंशन की ज़रूरत है या नहीं, यह बताने के लिए इन शब्दों का इस्तेमाल किया जाता है:
इन शब्दों का मतलब है कि वैल्यू देना ज़रूरी है:
ज़रूरी है: आपको वैल्यू शामिल करनी होगी.
सिर्फ़ एक का इस्तेमाल करें: आपको ग्रुप में से एक वैल्यू शामिल करनी होगी.
एक या उससे ज़्यादा वैल्यू का इस्तेमाल करें: ग्रुप की कोई भी या सभी वैल्यू शामिल की जा सकती हैं. हालांकि, आपको कम से कम एक वैल्यू शामिल करनी होगी.
इन शब्दों का मतलब है कि वैल्यू देना ज़रूरी नहीं है:
ज़रूरी नहीं: आपके पास वैल्यू शामिल करने का विकल्प है.
0 या 1 का इस्तेमाल करें: आपके पास ग्रुप से एक वैल्यू शामिल करने का विकल्प है.
0 या उससे ज़्यादा का इस्तेमाल करें: आपके पास ग्रुप की कोई भी या सभी वैल्यू शामिल करने का विकल्प होता है.
अहम जानकारी: कॉन्टेंट के मालिक के वीडियो की रिपोर्ट पाने के लिए, एपीआई के सभी अनुरोधों में वीडियो डाइमेंशन, चैनल डाइमेंशन, ग्रुप डाइमेंशन या claimedStatus और uploaderType डाइमेंशन के साथ-साथ, इनके किसी भी कॉम्बिनेशन का इस्तेमाल करके डेटा फ़िल्टर करना ज़रूरी है. (कुछ रिपोर्ट में ये सभी विकल्प काम नहीं करते.) इस्तेमाल किए जा सकने वाले कॉम्बिनेशन, जो uploaderType डाइमेंशन की परिभाषा में भी शामिल हैं:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
वीडियो रिपोर्ट
बुनियादी आंकड़े
बुनियादी आंकड़े (इसमें सदस्यों की संख्या भी शामिल है)
इस रिपोर्ट में, कॉन्टेंट के मालिक के सभी चैनलों पर उपयोगकर्ता की कार्रवाइयों से जुड़े आंकड़े मिलते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास वीडियो या देश का डेटा देखा जा सकता है. इसका इस्तेमाल, सिर्फ़ उस कॉन्टेंट के आंकड़े पाने के लिए भी किया जा सकता है जिस पर दावा किया गया है. इसमें, कॉन्टेंट के मालिक, तीसरे पक्ष या दोनों के अपलोड किए गए कॉन्टेंट पर किया गया दावा शामिल है.
इस रिपोर्ट में, अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए आंकड़े दिए जाते हैं. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
इस रिपोर्ट में, किसी खास समयावधि के लिए कॉन्टेंट के मालिक के सभी चैनलों पर, उपयोगकर्ता की कार्रवाइयों से जुड़े आंकड़े मिलते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास वीडियो या देश का डेटा देखा जा सकता है.
अमेरिका के राज्यों में, किसी खास समयावधि के दौरान उपयोगकर्ता की गतिविधि
इस रिपोर्ट में, अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए आंकड़े दिए जाते हैं. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
इस रिपोर्ट में, कॉन्टेंट के मालिक के सभी चैनलों के लिए, हर देश के हिसाब से उपयोगकर्ता गतिविधि से जुड़े आंकड़े मिलते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास वीडियो या चैनल का डेटा देखा जा सकता है.
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, उपयोगकर्ता गतिविधि के आंकड़े दिए गए हैं. इस रिपोर्ट के लिए, आपको filters पैरामीटर की वैल्यू को country==US पर सेट करना होगा.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 250 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर की वैल्यू भी बतानी होगी.
इस रिपोर्ट में, शहर के हिसाब से उपयोगकर्ता गतिविधि के आंकड़े दिए जाते हैं.
वीडियो चलाने की ज़्यादा जानकारी वाली रिपोर्ट में, वीडियो देखने से जुड़े इन एट्रिब्यूट के आंकड़े मिलते हैं:
क्या यह लाइव वीडियो ब्रॉडकास्ट या मांग पर उपलब्ध वीडियो का व्यू था?
क्या दर्शक ने उस चैनल की सदस्यता ली थी जिसका वीडियो इस्तेमाल किया गया था?
YouTube के किस प्रॉडक्ट पर व्यू मिला?
तकनीकी तौर पर, इन रिपोर्ट में वीडियो चलाने की जानकारी वाले सभी डाइमेंशन इस्तेमाल करना ज़रूरी नहीं है. अगर आपने अपने अनुरोध में, वीडियो चलाने की जानकारी वाले डाइमेंशन शामिल नहीं किए हैं, तो मिलने वाली रिपोर्ट बुनियादी आंकड़े, समय के हिसाब से या उपयोगकर्ता की जगह की रिपोर्ट जैसी ही होगी.
ध्यान दें:liveOrOnDemand डाइमेंशन और फ़िल्टर का इस्तेमाल, averageViewPercentage मेट्रिक के साथ नहीं किया जा सकता. इसलिए, यहां दिए गए हर सब-सेक्शन में दो रिपोर्ट शामिल हैं. एक रिपोर्ट में liveOrOnDemand डाइमेंशन (और फ़िल्टर) काम करता है, जबकि दूसरी रिपोर्ट में averageViewPercentage मेट्रिक काम करती है.
सदस्यता की स्थिति के हिसाब से उपयोगकर्ता की गतिविधि
इस रिपोर्ट में, सदस्यों और सामान्य दर्शकों की गतिविधि से जुड़ी मेट्रिक मिलती हैं. आंकड़ों को समयावधि (दिन या महीना) के हिसाब से ग्रुप किया जा सकता है. साथ ही, रिपोर्ट को देश, महाद्वीप या subContinent के हिसाब से भी फ़िल्टर किया जा सकता है.
प्रांतों के हिसाब से, सदस्यता की स्थिति के हिसाब से उपयोगकर्ता गतिविधि
इस रिपोर्ट में, अमेरिका के राज्यों या डिस्ट्रिक्ट ऑफ़ कोलंबिया में, सदस्यता लेने वाले और न लेने वाले दर्शकों की गतिविधि की मेट्रिक दी जाती हैं. इस रिपोर्ट में पिछली रिपोर्ट के मुकाबले कम मेट्रिक काम करती हैं.
टाइम डाइमेंशन के साथ प्लेबैक की जानकारी (शामिल करना ज़रूरी नहीं है)
इन रिपोर्ट के लिए, समय डाइमेंशन – दिन या महीना – का इस्तेमाल करना ज़रूरी नहीं है. ऐसा इसलिए, क्योंकि रिपोर्ट में शामिल की जाने वाली तारीख की सीमा तय करने के लिए, आपको startDate और endDate अनुरोध पैरामीटर का इस्तेमाल करना होगा. अगर डाइमेंशन मौजूद है, तो इसका मतलब है कि आपको रिपोर्ट में डेटा को दिन, महीने वगैरह के हिसाब से इकट्ठा करना है.
प्लेबैक की जानकारी, जिसमें समय डाइमेंशन और liveOrOnDemand के आंकड़े शामिल हैं. हालांकि, इनका इस्तेमाल करना ज़रूरी नहीं है
इस रिपोर्ट में, किसी खास समयावधि के लिए वीडियो चलाए जाने के बारे में आंकड़े मिलते हैं. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
averageViewPercentage मेट्रिक की मदद से, देश के हिसाब से वीडियो चलाए जाने की जानकारी
नीचे दी गई रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. इससे averageViewPercentage मेट्रिक के साथ काम करने की सुविधा मिलती है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर liveOrOnDemand के साथ काम नहीं करती.
liveOrOnDemand के आंकड़ों के साथ, प्रांत के हिसाब से वीडियो चलाने की जानकारी
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, वीडियो चलाए जाने से जुड़े आंकड़े दिए गए हैं. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
averageViewPercentage मेट्रिक के साथ, प्रांत के हिसाब से वीडियो चलाए जाने की जानकारी
नीचे दी गई रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. इससे averageViewPercentage मेट्रिक के साथ काम करने की सुविधा मिलती है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर liveOrOnDemand के साथ काम नहीं करती.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर के लिए भी वैल्यू तय करनी होगी.
इस रिपोर्ट से, एम्बेड किए गए उन वीडियो प्लेयर की पहचान की जाती है जिनसे कॉन्टेंट के मालिक के वीडियो पर सबसे ज़्यादा व्यू या वीडियो देखने का कुल समय मिला. इस रिपोर्ट को फिर से पाने के लिए, आपको insightPlaybackLocationType फ़िल्टर को EMBEDDED पर सेट करना होगा.
इस रिपोर्ट में, वीडियो देखने के आंकड़ों को इकट्ठा किया जाता है. ये आंकड़े इस आधार पर इकट्ठा किए जाते हैं कि दर्शक आपके वीडियो पर कैसे पहुंचे. उदाहरण के लिए, यह उन व्यू की संख्या की पहचान करता है जो Google पर खोज के नतीजों में दिखने या किसी मिलते-जुलते वीडियो के लिंक से मिले हैं.
ध्यान दें: अगर क्वेरी वाले वीडियो की संख्या x तारीख की सीमा में दिनों की संख्या का प्रॉडक्ट 50,000 से ज़्यादा है, तो यह रिपोर्ट गड़बड़ी का मैसेज दिखाती है. उदाहरण के लिए, 500 वीडियो आईडी का डेटा पाने वाली क्वेरी, ज़्यादा से ज़्यादा 100 दिनों के डेटा का अनुरोध कर सकती है. किसी अनुरोध से मिलने वाली पंक्तियों की संख्या कम करने के लिए, अपनी क्वेरी को कई क्वेरी में बांटें. इन क्वेरी में कम वीडियो शामिल करें या तारीख की छोटी सीमाएं सेट करें.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर की वैल्यू भी बतानी होगी.
इस रिपोर्ट में, वीडियो पर मिले व्यू के आंकड़ों को इकट्ठा किया जाता है. ये आंकड़ें, कॉन्टेंट के मालिक के वीडियो पर सबसे ज़्यादा व्यू जनरेट करने वाले रेफ़रर के आधार पर इकट्ठा किए जाते हैं. रेफ़रर को ट्रैफ़िक सोर्स के टाइप के हिसाब से बांटा जाता है. साथ ही, insightTrafficSourceDetail डाइमेंशन की परिभाषा से उन ट्रैफ़िक सोर्स की पहचान होती है जिनके लिए रिपोर्ट उपलब्ध है. उदाहरण के लिए, अगर insightTrafficSourceType फ़िल्टर को ADVERTISING पर सेट किया जाता है, तो रिपोर्ट में उन विज्ञापनों के टाइप की सूची दिखेगी जिनसे कॉन्टेंट के मालिक के कॉन्टेंट पर सबसे ज़्यादा व्यू या वीडियो देखने का कुल समय मिला.
ध्यान दें: यह रिपोर्ट सिर्फ़ कुछ खास ट्रैफ़िक सोर्स के लिए उपलब्ध है. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, और NO_LINK_EMBEDDED ट्रैफ़िक सोर्स काम नहीं करते.
डिवाइस का टाइप और ऑपरेटिंग सिस्टम
डिवाइस का टाइप
इस रिपोर्ट में, वीडियो देखने के आंकड़ों को इकट्ठा किया जाता है. ये आंकड़े, इस बात के आधार पर इकट्ठा किए जाते हैं कि दर्शक आपका वीडियो किस तरह के डिवाइस पर देख रहे थे. उदाहरण के लिए, यह टैबलेट या गेम कंसोल पर मिले व्यू की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम के आधार पर वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android डिवाइसों या PlayStations पर मिले व्यू की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम और डिवाइस टाइप के आधार पर, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android टैबलेट या Windows डेस्कटॉप डिवाइसों पर मिले व्यू की संख्या की पहचान करता है.
ध्यान दें: इस रिपोर्ट में viewerPercentage की वैल्यू, subscribedStatus वाले वीडियो चलाने की जानकारी वाले डाइमेंशन की अलग-अलग वैल्यू के लिए सामान्य नहीं की जाती हैं.
उदाहरण के लिए, अगर कोई रिपोर्ट subscribedStatus डाइमेंशन का इस्तेमाल करती है, तो वह सदस्यता वाले व्यू के लिए viewerPercentage का डेटा 100 प्रतिशत दिखाती है और सदस्यता न लेने वाले व्यू के लिए viewerPercentage का डेटा 100 प्रतिशत दिखाती है. (रिपोर्ट में सभी viewerPercentage फ़ील्ड की कुल वैल्यू 200 प्रतिशत है.)
फ़िल्टर का इस्तेमाल करके यह पक्का किया जा सकता है कि रिपोर्ट में सिर्फ़ subscribedStatus डाइमेंशन की एक वैल्यू के लिए viewerPercentage डेटा हो.
दर्शकों की दिलचस्पी और कॉन्टेंट शेयर करना
इस रिपोर्ट में आंकड़ों के ज़रिए यह जानकारी मिलती है कि चैनल के वीडियो, अलग-अलग सोशल मीडिया प्लैटफ़ॉर्म पर कितनी बार शेयर किए गए.
इस रिपोर्ट से यह पता चलता है कि वीडियो पर दर्शक कितने समय तक बने रहते हैं. elapsedVideoTimeRatio डाइमेंशन, मेट्रिक की वैल्यू के लिए वीडियो के बीत चुके समय को मेज़र करता है. audienceWatchRatio और relativeRetentionPerformance मेट्रिक से दो मेज़रमेंट मिलते हैं. इनसे पता चलता है कि वीडियो पर दर्शक कितने समय तक बने रहते हैं. पहली वैल्यू, वीडियो पर बने रहने वाले दर्शकों की कुल संख्या होती है. वहीं, दूसरी वैल्यू से पता चलता है कि आपका वीडियो, YouTube पर उसी अवधि के दूसरे वीडियो के मुकाबले कैसा परफ़ॉर्म कर रहा है.
ध्यान दें: दर्शक बनाए रखने की रिपोर्ट में, video फ़िल्टर के लिए वैल्यू की सूची को कॉमा लगाकर अलग-अलग नहीं किया जा सकता. वैल्यू में सिर्फ़ एक वीडियो आईडी होना चाहिए.
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. 1 जनवरी, 2013 से पहले का डेटा, सिर्फ़ टॉप 10 वीडियो के लिए उपलब्ध है. ज़्यादातर अन्य रिपोर्ट के विपरीत, इन रिपोर्ट के लिए भी आपको sort अनुरोध पैरामीटर की वैल्यू तय करनी होगी.
देश, महाद्वीप या उपमहाद्वीप के हिसाब से, सबसे ज़्यादा देखे गए वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची दिखती है. यह सूची, फ़िल्टर करने और क्रम से लगाने की तय शर्तों के आधार पर बनाई जाती है.
अमेरिका के राज्य के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया में, कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची होती है. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
सदस्यों या सदस्य नहीं होने वाले दर्शकों के लिए सबसे लोकप्रिय वीडियो(<= 200 नतीजे)
इस रिपोर्ट में, सदस्यों और सामान्य दर्शकों के लिए सबसे ज़्यादा देखे गए वीडियो की सूची होती है. रिपोर्ट को फ़िल्टर करके, देश, महाद्वीप या subContinent के हिसाब से सबसे ज़्यादा देखे गए वीडियो की सूची देखी जा सकती है. पिछली रिपोर्ट की मदद से, अमेरिका के किसी खास राज्य में चैनल के सदस्यों या सदस्य नहीं होने वाले दर्शकों के लिए, सबसे लोकप्रिय वीडियो देखे जा सकते हैं. हालांकि, इसमें इस रिपोर्ट के मुकाबले कम मेट्रिक काम करती हैं.
YouTube के प्रॉडक्ट के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में सबसे लोकप्रिय वीडियो की सूची होती है. साथ ही, इसमें वीडियो चलाने की जानकारी और भौगोलिक फ़िल्टर की सुविधा भी मिलती है. यह रिपोर्ट पिछली रिपोर्ट से मिलती-जुलती है. हालांकि, इसमें कम मेट्रिक काम करती हैं और youtubeProduct फ़िल्टर के साथ काम करने की सुविधा जोड़ी गई है.
वीडियो चलाने से जुड़ी जानकारी वाले फ़िल्टर के साथ सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, कॉन्टेंट के मालिक के सबसे लोकप्रिय वीडियो की सूची दी गई है. इसे वीडियो चलाने से जुड़ी जानकारी के एक या उससे ज़्यादा डाइमेंशन के हिसाब से फ़िल्टर किया जाता है: liveOrOnDemand, subscribedStatus, और youtubeProduct. इस रिपोर्ट में, क्षेत्र के हिसाब से फ़िल्टर करने की सुविधा भी उपलब्ध है.
प्लेलिस्ट रिपोर्ट में, चैनल के मालिक की प्लेलिस्ट में मौजूद वीडियो से जुड़ी उपयोगकर्ता गतिविधि से जुड़ी मेट्रिक होती हैं. इन रिपोर्ट के दो वर्शन उपलब्ध हैं. साथ ही, हर उपलब्ध रिपोर्ट के लिए,
नीचे दिए गए सेक्शन में हर वर्शन की जानकारी दी गई है:
हर सेक्शन में मौजूद सुझाया गया टैब, उससे जुड़ी रिपोर्ट को फिर से पाने के लिए, एपीआई अनुरोध के पसंदीदा फ़ॉर्मैट के बारे में बताता है. सुझाई गई रिपोर्ट में, मेट्रिक का बड़ा सेट शामिल होता है. इसमें वीडियो की एग्रीगेट की गई मेट्रिक और प्लेलिस्ट में मौजूद मेट्रिक, दोनों शामिल होती हैं. अनुरोध का यह फ़ॉर्मैट,
isCurated डाइमेंशन का इस्तेमाल नहीं करता.
हर सेक्शन में मौजूद isCurated का इस्तेमाल करना टैब, एपीआई अनुरोध के पुराने फ़ॉर्मैट के बारे में बताता है. इसमें isCurated डाइमेंशन की ज़रूरत होती है. ये रिपोर्ट सिर्फ़
प्लेलिस्ट में मौजूद मेट्रिक के साथ काम करती हैं. ध्यान दें कि सभी रिपोर्ट के लिए,
isCurated डाइमेंशन का इस्तेमाल बंद कर दिया गया है. नीचे दी गई चेतावनी में,
बंद होने के शेड्यूल के बारे में बताया गया है.
चेतावनी वाले इस नोट में, दोनों रिपोर्ट वर्शन के बीच हुए बदलावों के बारे में ज़्यादा जानकारी दी गई है.
वीडियो की एग्रीगेट की गई मेट्रिक
इन मेट्रिक से, उपयोगकर्ता गतिविधि और इंप्रेशन की मेट्रिक मिलती हैं. ये मेट्रिक, प्लेलिस्ट में मौजूद उन सभी वीडियो के लिए इकट्ठा की जाती हैं जिनका मालिकाना हक, प्लेलिस्ट के चैनल के पास होता है. दूसरे चैनलों के मालिकाना हक वाले वीडियो की मेट्रिक, एग्रीगेशन में शामिल नहीं की जाती हैं. इसलिए, अगर कोई चैनल ऐसी प्लेलिस्ट बनाता है जिसमें सिर्फ़ दूसरे चैनलों के वीडियो शामिल हैं, तो उन प्लेलिस्ट की रिपोर्ट में इन मेट्रिक की वैल्यू नहीं दिखेंगी.
इन मेट्रिक से, प्लेलिस्ट पेज के संदर्भ में उपयोगकर्ता की गतिविधि और जुड़ाव के बारे में पता चलता है. इन मेट्रिक में, प्लेलिस्ट में मौजूद सभी वीडियो के व्यू शामिल होते हैं. भले ही, उन पर किस चैनल का मालिकाना हक हो. हालांकि, इनमें सिर्फ़ प्लेलिस्ट में मिले व्यू की गिनती की जाती है.
इस रिपोर्ट में, कॉन्टेंट के मालिक के चैनलों पर मौजूद प्लेलिस्ट में मौजूद वीडियो के साथ उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े दिए जाते हैं. रिपोर्ट में कोई ज़रूरी डाइमेंशन नहीं है.
इस रिपोर्ट में, किसी खास समयावधि के दौरान, कॉन्टेंट के मालिक के चैनलों की प्लेलिस्ट में मौजूद वीडियो के साथ उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े दिए जाते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी एक प्लेलिस्ट या चैनल का डेटा देखा जा सकता है.
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, प्लेलिस्ट की गतिविधि के आंकड़े दिए गए हैं. इस रिपोर्ट के लिए, filters पैरामीटर की वैल्यू में country==US शामिल करें.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर की वैल्यू भी बतानी होगी.
इस रिपोर्ट से, एम्बेड किए गए उन वीडियो प्लेयर की पहचान की जाती है जिनकी वजह से कॉन्टेंट के मालिक की प्लेलिस्ट को सबसे ज़्यादा व्यू या वीडियो देखने का कुल समय मिला.
इस रिपोर्ट में, वीडियो देखने के आंकड़ों को इकट्ठा किया जाता है. ये आंकड़े इस आधार पर इकट्ठा किए जाते हैं कि दर्शक आपकी प्लेलिस्ट के वीडियो तक कैसे पहुंचे. उदाहरण के लिए, यह उन व्यू की संख्या की पहचान करता है जो Google पर की गई खोज या चैनल पेज से मिले हैं.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर की वैल्यू भी बतानी होगी.
इस रिपोर्ट में, वीडियो पर मिले व्यू के आंकड़े इकट्ठा किए जाते हैं. ये आंकड़े, कॉन्टेंट के मालिक की प्लेलिस्ट पर सबसे ज़्यादा व्यू जनरेट करने वाले रेफ़रर के आधार पर इकट्ठा किए जाते हैं. रेफ़रर को ट्रैफ़िक सोर्स के टाइप के हिसाब से बांटा जाता है. साथ ही, insightTrafficSourceDetail डाइमेंशन की परिभाषा से उन ट्रैफ़िक सोर्स की पहचान होती है जिनके लिए रिपोर्ट उपलब्ध है. उदाहरण के लिए, अगर insightTrafficSourceType फ़िल्टर को ADVERTISING पर सेट किया जाता है, तो रिपोर्ट में उन विज्ञापनों के टाइप की सूची दिखेगी जिनसे कॉन्टेंट के मालिक की प्लेलिस्ट पर सबसे ज़्यादा व्यू या वीडियो देखने का कुल समय मिला.
ध्यान दें: यह रिपोर्ट सिर्फ़ कुछ खास ट्रैफ़िक सोर्स के लिए उपलब्ध है. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, और NO_LINK_EMBEDDED ट्रैफ़िक सोर्स काम नहीं करते.
डिवाइस का टाइप और ऑपरेटिंग सिस्टम
प्लेलिस्ट के लिए डिवाइस का टाइप
इस रिपोर्ट में, प्लेलिस्ट में मौजूद वीडियो देखने के लिए इस्तेमाल किए गए डिवाइस के हिसाब से, वीडियो देखने के आंकड़ों को इकट्ठा किया जाता है. उदाहरण के लिए, इससे मोबाइल डिवाइसों या गेम कंसोल पर मिले व्यू की संख्या का पता चलता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम के आधार पर वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android डिवाइसों या PlayStations पर प्लेलिस्ट व्यू की संख्या की पहचान करता है.
इस रिपोर्ट में, दर्शकों के ऑपरेटिंग सिस्टम और डिवाइस टाइप के आधार पर, वीडियो देखने के आंकड़े इकट्ठा किए जाते हैं. उदाहरण के लिए, यह Android टैबलेट या Windows डेस्कटॉप डिवाइसों पर प्लेलिस्ट व्यू की संख्या की पहचान करता है.
ध्यान दें: इस रिपोर्ट में viewerPercentage वैल्यू, अलग-अलग वैल्यू या वीडियो चलाने की जानकारी वाले डाइमेंशन (subscribedStatus और youtubeProduct) की वैल्यू के कॉम्बिनेशन के लिए सामान्य नहीं की जाती हैं.
उदाहरण के लिए, subscribedStatus डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट, viewerPercentage का डेटा दिखाती है. यह डेटा, सदस्यता वाले व्यू के लिए 100 प्रतिशत और viewerPercentage का डेटा, सदस्यता न लेने वाले व्यू के लिए 100 प्रतिशत होता है. (रिपोर्ट में मौजूद सभी viewerPercentage फ़ील्ड की कुल वैल्यू 200 प्रतिशत है.)
फ़िल्टर का इस्तेमाल करके यह पक्का किया जा सकता है कि रिपोर्ट में, वीडियो चलाने की जानकारी वाले डाइमेंशन के लिए सिर्फ़ एक वैल्यू (या वैल्यू के कॉम्बिनेशन) का viewerPercentage डेटा शामिल हो.
सबसे ज़्यादा देखी जाने वाली प्लेलिस्ट
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. 1 जनवरी, 2013 से पहले का डेटा, सिर्फ़ सबसे ज़्यादा देखी गई 10 प्लेलिस्ट के लिए उपलब्ध है. ज़्यादातर अन्य रिपोर्ट के विपरीत, इन रिपोर्ट के लिए भी आपको sort अनुरोध पैरामीटर की वैल्यू बतानी होगी.
इस रिपोर्ट में, कॉन्टेंट के मालिक की सबसे लोकप्रिय प्लेलिस्ट की सूची दिखती है. यह सूची, फ़िल्टर करने और क्रम से लगाने की तय की गई शर्तों के आधार पर बनाई जाती है.
ध्यान दें: विज्ञापन की परफ़ॉर्मेंस रिपोर्ट देखने के लिए, अनुमति देने वाला ऐसा टोकन ज़रूरी है जो https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप का ऐक्सेस देता हो.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, वीडियो चलाने के दौरान दिखने वाले विज्ञापनों के लिए, इंप्रेशन पर आधारित मेट्रिक मिलती हैं. इन मेट्रिक में हर विज्ञापन इंप्रेशन की गिनती की जाती है. साथ ही, हर वीडियो प्लेबैक से कई इंप्रेशन मिल सकते हैं.
इंप्रेशन पर आधारित विज्ञापन की परफ़ॉर्मेंस मेट्रिक ये हैं:
इसके अलावा, कुछ वीडियो रिपोर्ट में, प्लेबैक पर आधारित विज्ञापन की परफ़ॉर्मेंस की ये मेट्रिक काम करती हैं. हालांकि, इन मेट्रिक को विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में शामिल नहीं किया जाता.
[null,null,["आखिरी बार 2024-11-15 (UTC) को अपडेट किया गया."],[[["Content Owner Reports provide YouTube content partners with detailed metrics on channels linked to their content owner accounts, covering user activity, ad performance, and estimated revenue."],["These reports are accessible through the `reports.query` method using OAuth 2.0 authorization, and data must be filtered by dimensions like `video`, `channel`, or specific combinations of `claimedStatus` and `uploaderType`."],["Video Reports offer a variety of data, including basic user activity, geographic breakdowns by country, province, and city, and time-based activity, all supporting a wide range of metrics like `views`, `likes`, and `estimatedRevenue`."],["Playlist Reports, while deprecating the `isCurated` dimension by the end of 2024, offer metrics for both aggregated video activity and in-playlist activity, with the `views` metric behavior changing based on the presence or absence of `isCurated`."],["Several reports require you to specify exactly one of `playlist` or `group` if certain view-related metrics are requested, and there are specific reports with their own requirements, like the Top Playlists report that can be sorted by `playlistViews`, `playlistEstimatedMinutesWatched`, or `playlistStarts` with a `maxResults` limit of 200."]]],[]]
