इस पेज पर, ऐसी रिपोर्ट की सूची दी गई है जिन्हें चैनल के मालिक, YouTube Analytics API की मदद से ऐक्सेस कर सकते हैं. चैनल रिपोर्ट में, किसी चैनल पर दर्शकों की गतिविधि से जुड़ी मेट्रिक मिलती हैं. साथ ही, इनमें वीडियो पर मिले व्यू, रेटिंग, और सदस्यों की संख्या जैसी चीज़ों को मेज़र किया जाता है.
वीडियो रिपोर्ट में, चैनल के वीडियो से जुड़ी उपयोगकर्ता की सभी गतिविधियों के आंकड़े मिलते हैं.
प्लेलिस्ट की रिपोर्ट में, प्लेलिस्ट में मौजूद वीडियो के व्यू से जुड़े आंकड़े दिखते हैं.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक शामिल होती हैं. ये मेट्रिक, वीडियो चलाने के दौरान दिखाए गए विज्ञापनों के टाइप के आधार पर ग्रुप की जाती हैं. इसके लिए, adType डाइमेंशन का इस्तेमाल किया जाता है. विज्ञापन की परफ़ॉर्मेंस रिपोर्ट सेक्शन में, विज्ञापन की परफ़ॉर्मेंस की उन दो तरह की मेट्रिक के बारे में बताया गया है जिनका इस्तेमाल एपीआई करता है.
रिपोर्ट वापस लाना
चैनल की रिपोर्ट पाने के लिए, आपको अपने एपीआई अनुरोध में ids पैरामीटर की वैल्यू को इनमें से किसी एक वैल्यू पर सेट करना होगा:
channel==MINE – यह एपीआई, पुष्टि किए गए उपयोगकर्ता के YouTube चैनल का डेटा दिखाता है.
channel==CHANNEL_ID – CHANNEL_ID को उस चैनल के यूनीक चैनल आईडी पर सेट करें जिसके लिए आपको डेटा चाहिए. अनुरोध को अनुमति देने वाला उपयोगकर्ता, चैनल का मालिक होना चाहिए.
फ़िलहाल, चैनल आईडी एक स्ट्रिंग होती है, जो UC अक्षरों से शुरू होती है. हालांकि, इसका फ़ॉर्मैट बदल सकता है. (अपने YouTube चैनल के लिए, खाते की बेहतर सेटिंग पेज पर जाकर, अपने चैनल का आईडी देखा जा सकता है. इसके अलावा, YouTube Data API'schannels.list तरीके का इस्तेमाल करके, प्रोग्राम के ज़रिए भी अपने चैनल का आईडी वापस पाया जा सकता है.)
अनुमति देना
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(,country) के लिए, वीडियो फ़िल्टर ज़रूरी है. हालांकि, देश फ़िल्टर का इस्तेमाल करना ज़रूरी नहीं है.
एपीआई, video और playlist फ़िल्टर के लिए कई वैल्यू तय करने की सुविधा भी देता है. अगर आपने इनमें से किसी एक फ़िल्टर के लिए एक से ज़्यादा वैल्यू दी हैं, तो उस फ़िल्टर को उन डाइमेंशन की सूची में भी जोड़ा जा सकता है जिन्हें आपने अनुरोध के लिए चुना है. ऐसा तब भी होता है, जब फ़िल्टर को किसी खास रिपोर्ट के लिए, काम करने वाले डाइमेंशन के तौर पर सूची में न शामिल किया गया हो.
किसी खास वैल्यू या वैल्यू के सेट के लिए, एपीआई के नतीजों को फ़िल्टर करने के तरीके के बारे में पूरी जानकारी पाने के लिए, filters पैरामीटर की परिभाषा देखें.
रिपोर्ट टेबल को समझना
इस सेक्शन में, उन टेबल में इस्तेमाल किए गए फ़ॉर्मैट और शब्दों के बारे में बताया गया है जिनसे एपीआई के साथ काम करने वाली रिपोर्ट के बारे में पता चलता है. इस टेबल में, समय डाइमेंशन और averageViewPercentage मेट्रिक का इस्तेमाल करके, वीडियो चलाने की जानकारी वाली रिपोर्ट के लिए काम करने वाले डाइमेंशन, मेट्रिक, और फ़िल्टर की सूची दी गई है.
टेबल में डाइमेंशन के लिए दो लाइनें, मेट्रिक के लिए एक लाइन, और फ़िल्टर के लिए तीन लाइनें होती हैं. डाइमेंशन और फ़िल्टर के लिए, हर पंक्ति की वैल्यू को एपीआई अनुरोध में तब तक जोड़ा जा सकता है, जब तक कि कॉम्बिनेशन, टेबल में इस्तेमाल के नियमों का पालन करता हो. उदाहरण के लिए, इस रिपोर्ट के लिए dimensions
पैरामीटर की मान्य वैल्यू में ये शामिल हैं:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
हालांकि, पैरामीटर की वैल्यू day,month अमान्य है, क्योंकि इसमें समय पर आधारित दो डाइमेंशन का इस्तेमाल किया गया है. साथ ही, अनुरोध में 0 या 1 का इस्तेमाल करना ज़रूरी है.
रिपोर्ट टेबल की शब्दावली
टेबल में, डाइमेंशन की ज़रूरत है या नहीं, यह बताने के लिए इन शब्दों का इस्तेमाल किया जाता है:
इन शब्दों का मतलब है कि वैल्यू देना ज़रूरी है:
ज़रूरी है: आपको वैल्यू शामिल करनी होगी.
सिर्फ़ एक का इस्तेमाल करें: आपको ग्रुप में से एक वैल्यू शामिल करनी होगी.
एक या उससे ज़्यादा वैल्यू का इस्तेमाल करें: ग्रुप की कोई भी या सभी वैल्यू शामिल की जा सकती हैं. हालांकि, आपको कम से कम एक वैल्यू शामिल करनी होगी.
इन शब्दों का मतलब है कि वैल्यू देना ज़रूरी नहीं है:
ज़रूरी नहीं: आपके पास वैल्यू शामिल करने का विकल्प है.
0 या 1 का इस्तेमाल करें: आपके पास ग्रुप से एक वैल्यू शामिल करने का विकल्प है.
0 या उससे ज़्यादा का इस्तेमाल करें: आपके पास ग्रुप की कोई भी या सभी वैल्यू शामिल करने का विकल्प होता है.
वीडियो रिपोर्ट
बुनियादी आंकड़े
उपयोगकर्ता गतिविधि के बुनियादी आंकड़े
इस रिपोर्ट में, किसी चैनल पर उपयोगकर्ताओं की कार्रवाइयों से जुड़े आंकड़े मिलते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास वीडियो या देश का डेटा देखा जा सकता है.
अमेरिका के राज्यों के लिए, उपयोगकर्ता गतिविधि के बुनियादी आंकड़े
इस रिपोर्ट में, अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए आंकड़े दिए जाते हैं. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
चुनिंदा समयावधि के लिए, देश के हिसाब से उपयोगकर्ता गतिविधि
इस रिपोर्ट में, किसी चैनल पर उपयोगकर्ता की कार्रवाइयों से जुड़े आंकड़े दिए जाते हैं. ये आंकड़े, किसी खास समयावधि के लिए होते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास वीडियो या देश का डेटा देखा जा सकता है.
अमेरिका के राज्यों में, किसी खास समयावधि के दौरान उपयोगकर्ता की गतिविधि
इस रिपोर्ट में, अमेरिका के किसी खास राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया के उपयोगकर्ताओं की गतिविधि से जुड़े आंकड़े मिलते हैं. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
इस रिपोर्ट में, किसी चैनल के लिए हर देश के हिसाब से उपयोगकर्ता गतिविधि से जुड़े आंकड़े मिलते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी एक वीडियो का डेटा देखा जा सकता है.
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, उपयोगकर्ता गतिविधि के आंकड़े दिए गए हैं.
इस रिपोर्ट के लिए, आपको filters पैरामीटर की वैल्यू को country==US पर सेट करना होगा.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults
पैरामीटर को 250 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट के लिए भी आपको sort अनुरोध पैरामीटर की वैल्यू तय करनी होगी.
इस रिपोर्ट में, शहर के हिसाब से उपयोगकर्ता गतिविधि के आंकड़े दिए जाते हैं.
इस रिपोर्ट में, तय किए गए बाज़ार क्षेत्र (डीएमए) के हिसाब से उपयोगकर्ता गतिविधि के आंकड़े दिए जाते हैं. इस रिपोर्ट के लिए,
आपको filters पैरामीटर की वैल्यू को country==US पर सेट करना होगा या
किसी खास प्रांत (अमेरिका के राज्य) के हिसाब से फ़िल्टर करना होगा.
वीडियो चलाने की ज़्यादा जानकारी वाली रिपोर्ट में, वीडियो देखने से जुड़े इन एट्रिब्यूट के आंकड़े मिलते हैं:
क्या यह लाइव वीडियो ब्रॉडकास्ट या मांग पर उपलब्ध वीडियो का व्यू था?
क्या दर्शक ने उस चैनल की सदस्यता ली थी जिसका वीडियो इस्तेमाल किया गया था?
YouTube के किस प्रॉडक्ट पर व्यू मिला?
ध्यान दें:liveOrOnDemand डाइमेंशन और फ़िल्टर का इस्तेमाल, averageViewPercentage मेट्रिक के साथ नहीं किया जा सकता. इसलिए, यहां दिए गए हर सब-सेक्शन में दो रिपोर्ट शामिल हैं. एक रिपोर्ट में liveOrOnDemand डाइमेंशन (और फ़िल्टर) काम करता है, जबकि दूसरी रिपोर्ट में averageViewPercentage मेट्रिक काम करती है.
सदस्यता की स्थिति के हिसाब से उपयोगकर्ता की गतिविधि
इस रिपोर्ट में, सदस्यों और सामान्य दर्शकों की गतिविधि से जुड़ी मेट्रिक मिलती हैं. आंकड़ों को समयावधि (दिन या महीना) के हिसाब से ग्रुप किया जा सकता है. साथ ही, रिपोर्ट को देश, महाद्वीप या subContinent के हिसाब से भी फ़िल्टर किया जा सकता है.
प्रांतों के हिसाब से, सदस्यता की स्थिति के हिसाब से उपयोगकर्ता गतिविधि
इस रिपोर्ट में, अमेरिका के राज्यों या डिस्ट्रिक्ट ऑफ़ कोलंबिया में, सदस्यता लेने वाले और न लेने वाले दर्शकों की गतिविधि की मेट्रिक दी जाती हैं. इस रिपोर्ट में पिछली रिपोर्ट के मुकाबले कम मेट्रिक काम करती हैं.
टाइम डाइमेंशन के साथ प्लेबैक की जानकारी (शामिल करना ज़रूरी नहीं है)
इन रिपोर्ट के लिए, समय डाइमेंशन – दिन या महीना – का इस्तेमाल करना ज़रूरी नहीं है. ऐसा इसलिए, क्योंकि रिपोर्ट में शामिल की जाने वाली तारीख की सीमा तय करने के लिए, आपको startDate और endDate अनुरोध पैरामीटर का इस्तेमाल करना होगा. अगर डाइमेंशन मौजूद है, तो इसका मतलब है कि आपको रिपोर्ट में डेटा को दिन, महीने वगैरह के हिसाब से इकट्ठा करना है.
प्लेबैक की जानकारी, जिसमें समय डाइमेंशन और liveOrOnDemand के आंकड़े शामिल हैं. हालांकि, इनका इस्तेमाल करना ज़रूरी नहीं है
इस रिपोर्ट में, किसी खास समयावधि के लिए वीडियो चलाए जाने के बारे में आंकड़े मिलते हैं. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
averageViewPercentage मेट्रिक की मदद से, देश के हिसाब से वीडियो चलाए जाने की जानकारी
नीचे दी गई रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. इससे averageViewPercentage मेट्रिक के साथ काम करने की सुविधा मिलती है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर liveOrOnDemand के साथ काम नहीं करती.
liveOrOnDemand के आंकड़ों के साथ, प्रांत के हिसाब से वीडियो चलाने की जानकारी
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, वीडियो चलाए जाने से जुड़े आंकड़े दिए गए हैं. यह liveOrOnDemand डाइमेंशन (और फ़िल्टर) के साथ काम करता है.
averageViewPercentage मेट्रिक के साथ, प्रांत के हिसाब से वीडियो चलाए जाने की जानकारी
नीचे दी गई रिपोर्ट, पिछली रिपोर्ट से मिलती-जुलती है. इससे averageViewPercentage मेट्रिक के साथ काम करने की सुविधा मिलती है. हालांकि, यह डाइमेंशन या फ़िल्टर के तौर पर liveOrOnDemand के साथ काम नहीं करती.
ध्यान दें: इस रिपोर्ट के लिए, आपको maxResults पैरामीटर को 25 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. ज़्यादातर अन्य रिपोर्ट के उलट, इस रिपोर्ट में आपको sort अनुरोध पैरामीटर की वैल्यू भी बतानी होगी.
इस रिपोर्ट से उन एम्बेड किए गए वीडियो प्लेयर की पहचान की जाती है जिनकी वजह से, चैनल के वीडियो को सबसे ज़्यादा व्यू मिले या जिन्हें सबसे ज़्यादा समय तक देखा गया.
इस रिपोर्ट में, वीडियो देखने के आंकड़ों को इकट्ठा किया जाता है. ये आंकड़े इस आधार पर इकट्ठा किए जाते हैं कि दर्शक आपके वीडियो पर कैसे पहुंचे. उदाहरण के लिए, यह उन व्यू की संख्या की पहचान करता है जो 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 डेस्कटॉप डिवाइसों पर मिले व्यू की संख्या की पहचान करता है.
उदाहरण के लिए, subscribedStatus डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट में, सदस्यों के व्यू के लिए viewerPercentage डेटा 100 प्रतिशत होता है और सदस्य नहीं होने वाले दर्शकों के व्यू के लिए viewerPercentage डेटा 100 प्रतिशत होता है. (रिपोर्ट में मौजूद सभी viewerPercentage फ़ील्ड की कुल वैल्यू 200 प्रतिशत है.)
फ़िल्टर का इस्तेमाल करके यह पक्का किया जा सकता है कि रिपोर्ट में, वीडियो चलाने की जानकारी वाले डाइमेंशन के लिए सिर्फ़ एक वैल्यू (या वैल्यू के कॉम्बिनेशन) का viewerPercentage डेटा शामिल हो.
दर्शकों की दिलचस्पी और कॉन्टेंट शेयर करना
इस रिपोर्ट में आंकड़ों के ज़रिए यह जानकारी मिलती है कि चैनल के वीडियो, अलग-अलग सोशल मीडिया प्लैटफ़ॉर्म पर कितनी बार शेयर किए गए.
इस रिपोर्ट से यह पता चलता है कि वीडियो में दर्शकों का ध्यान कितनी देर तक बना रहा. साथ ही, इससे यह भी पता चलता है कि वीडियो के अलग-अलग हिस्सों को कितनी बार देखा गया. elapsedVideoTimeRatio डाइमेंशन, मेट्रिक की वैल्यू के लिए बीत चुके वीडियो के कुल समय को मेज़र करता है. मेट्रिक को दो कैटगरी में बांटा जा सकता है:
दर्शक बनाए रखना
इन मेट्रिक से पता चलता है कि वीडियो पर दर्शक कितने समय तक बने रहते हैं.
audienceWatchRatio एक अनुपात है, जो वीडियो के किसी हिस्से को मिले व्यू की संख्या की तुलना, वीडियो को मिले कुल व्यू से करता है.
relativeRetentionPerformance से पता चलता है कि वीडियो चलाने के दौरान, उस पर कितने दर्शक बने रहे. यह जानकारी, उसी अवधि के दूसरे YouTube वीडियो के मुकाबले दी जाती है.
वीडियो देखने से जुड़े ज़्यादा जानकारी वाले आंकड़े
इन मेट्रिक से यह जानकारी मिलती है कि वीडियो के किसी हिस्से को कितनी बार देखा गया.
startedWatching से पता चलता है कि वीडियो के किसी खास सेगमेंट के दौरान, दर्शकों ने वीडियो को कितनी बार देखना शुरू किया.
stoppedWatching से पता चलता है कि वीडियो के किसी खास सेगमेंट के दौरान, दर्शकों ने कितनी बार वीडियो देखना बंद किया.
ध्यान दें: इस रिपोर्ट में, video फ़िल्टर के लिए वैल्यू की सूची को कॉमा लगाकर अलग-अलग करने की सुविधा उपलब्ध नहीं है. वैल्यू में सिर्फ़ एक वीडियो आईडी होना चाहिए.
एक ही समय पर स्ट्रीम देख रहे दर्शकों की संख्या (लाइव स्ट्रीम के लिए)
इस रिपोर्ट से पता चलता है कि किसी लाइव स्ट्रीम किए गए वीडियो के लिए, किसी खास समय पर कितने दर्शक स्ट्रीम देख रहे थे.
फ़िल्टर से वीडियो के बारे में जानकारी मिलती है. पोज़िशन डाइमेंशन, आम तौर पर एक मिनट के डेटा को दिखाता है.
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. 1 जनवरी, 2013 से पहले का डेटा, सिर्फ़ टॉप 10 वीडियो के लिए उपलब्ध है. ज़्यादातर अन्य रिपोर्ट के विपरीत, इन रिपोर्ट के लिए भी आपको sort अनुरोध पैरामीटर की वैल्यू बतानी होगी.
क्षेत्र के हिसाब से फ़िल्टर करने की सुविधा के साथ सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, चैनल के सबसे लोकप्रिय वीडियो की सूची होती है. रिपोर्ट को फ़िल्टर करके, देश, महाद्वीप या subContinent के हिसाब से सबसे ज़्यादा देखे गए वीडियो की सूची देखी जा सकती है.
राज्य के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया में चैनल के सबसे लोकप्रिय वीडियो की सूची होती है. ध्यान दें कि यह रिपोर्ट, ऊपर बताई गई देश के हिसाब से उपलब्ध रिपोर्ट में मौजूद मेट्रिक के सिर्फ़ एक सबसेट के साथ काम करती है.
सदस्यों या सदस्य नहीं होने वाले दर्शकों के लिए सबसे लोकप्रिय वीडियो(<= 200 नतीजे)
इस रिपोर्ट में, चैनल के सबसे लोकप्रिय वीडियो की सूची दी जाती है. इसमें, सदस्यों और सदस्य नहीं होने वाले दर्शकों, दोनों के लिए वीडियो की सूची होती है. रिपोर्ट को फ़िल्टर करके, देश, महाद्वीप या subContinent के हिसाब से सबसे ज़्यादा देखे गए वीडियो की सूची देखी जा सकती है. पिछली रिपोर्ट की मदद से, अमेरिका के किसी खास राज्य में चैनल के सदस्यों या सदस्य नहीं होने वाले दर्शकों के लिए, सबसे लोकप्रिय वीडियो देखे जा सकते हैं. हालांकि, इसमें इस रिपोर्ट के मुकाबले कम मेट्रिक काम करती हैं.
YouTube के प्रॉडक्ट के हिसाब से सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, चैनल के सबसे लोकप्रिय वीडियो की सूची होती है. साथ ही, इसमें वीडियो चलाने से जुड़ी जानकारी और देश/इलाके के हिसाब से फ़िल्टर करने की सुविधा भी होती है. यह रिपोर्ट पिछली रिपोर्ट से मिलती-जुलती है. हालांकि, इसमें कम मेट्रिक काम करती हैं और youtubeProduct फ़िल्टर के साथ काम करने की सुविधा जोड़ी गई है.
वीडियो चलाने से जुड़ी जानकारी वाले फ़िल्टर के साथ सबसे लोकप्रिय वीडियो (<= 200 नतीजे)
इस रिपोर्ट में, चैनल के सबसे लोकप्रिय वीडियो की सूची दी गई है. इसे वीडियो चलाने से जुड़ी जानकारी के किसी भी या सभी डाइमेंशन के हिसाब से फ़िल्टर किया जा सकता है: liveOrOnDemand, subscribedStatus, और youtubeProduct. पिछली रिपोर्ट के उलट, यह रिपोर्ट liveOrOnDemand फ़िल्टर के साथ काम करती है. हालांकि, इसमें averageViewPercentage मेट्रिक का इस्तेमाल नहीं किया जा सकता.
प्लेलिस्ट रिपोर्ट में, चैनल के मालिक की प्लेलिस्ट में मौजूद वीडियो से जुड़ी उपयोगकर्ता गतिविधि से जुड़ी मेट्रिक होती हैं. इन रिपोर्ट के दो वर्शन उपलब्ध हैं. साथ ही, हर उपलब्ध रिपोर्ट के लिए,
नीचे दिए गए सेक्शन में हर वर्शन की जानकारी दी गई है:
हर सेक्शन में मौजूद सुझाया गया टैब, उससे जुड़ी रिपोर्ट को फिर से पाने के लिए, एपीआई अनुरोध के पसंदीदा फ़ॉर्मैट के बारे में बताता है. सुझाई गई रिपोर्ट में, मेट्रिक का बड़ा सेट शामिल होता है. इसमें वीडियो की एग्रीगेट की गई मेट्रिक और प्लेलिस्ट में मौजूद मेट्रिक, दोनों शामिल होती हैं. अनुरोध का यह फ़ॉर्मैट,
isCurated डाइमेंशन का इस्तेमाल नहीं करता.
हर सेक्शन में मौजूद isCurated का इस्तेमाल करना टैब, एपीआई अनुरोध के पुराने फ़ॉर्मैट के बारे में बताता है. इसमें isCurated डाइमेंशन की ज़रूरत होती है. ये रिपोर्ट सिर्फ़
प्लेलिस्ट में मौजूद मेट्रिक के साथ काम करती हैं. ध्यान दें कि सभी रिपोर्ट के लिए,
isCurated डाइमेंशन का इस्तेमाल बंद कर दिया गया है. नीचे दी गई चेतावनी में,
बंद होने के शेड्यूल के बारे में बताया गया है.
चेतावनी वाले इस नोट में, दोनों रिपोर्ट वर्शन के बीच हुए बदलावों के बारे में ज़्यादा जानकारी दी गई है.
वीडियो की एग्रीगेट की गई मेट्रिक
इन मेट्रिक से, उपयोगकर्ता गतिविधि और इंप्रेशन की मेट्रिक मिलती हैं. ये मेट्रिक, प्लेलिस्ट में मौजूद उन सभी वीडियो के लिए इकट्ठा की जाती हैं जिनका मालिकाना हक, प्लेलिस्ट के चैनल के पास होता है. दूसरे चैनलों के मालिकाना हक वाले वीडियो की मेट्रिक, एग्रीगेशन में शामिल नहीं की जाती हैं. इसलिए, अगर कोई चैनल ऐसी प्लेलिस्ट बनाता है जिसमें सिर्फ़ दूसरे चैनलों के वीडियो शामिल हैं, तो उन प्लेलिस्ट की रिपोर्ट में इन मेट्रिक की वैल्यू नहीं दिखेंगी.
इन मेट्रिक से, प्लेलिस्ट पेज के संदर्भ में उपयोगकर्ता की गतिविधि और जुड़ाव के बारे में पता चलता है. इन मेट्रिक में, प्लेलिस्ट में मौजूद सभी वीडियो के व्यू शामिल होते हैं. भले ही, उन पर किस चैनल का मालिकाना हक हो. हालांकि, इनमें सिर्फ़ प्लेलिस्ट में मिले व्यू की गिनती की जाती है.
इस रिपोर्ट में, चैनल की प्लेलिस्ट में मौजूद वीडियो के साथ उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े दिए जाते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास प्लेलिस्ट का डेटा देखा जा सकता है.
इस रिपोर्ट में, चैनल की प्लेलिस्ट में मौजूद वीडियो के साथ उपयोगकर्ताओं के इंटरैक्शन से जुड़े आंकड़े दिए जाते हैं. रिपोर्ट को फ़िल्टर करके, सिर्फ़ किसी खास प्लेलिस्ट का डेटा देखा जा सकता है.
इस रिपोर्ट में, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के लिए, प्लेलिस्ट की गतिविधि के आंकड़े दिए गए हैं.
इस रिपोर्ट के लिए, आपको नतीजों को फ़िल्टर करना होगा, ताकि सिर्फ़ अमेरिका का डेटा दिखे.
ध्यान दें: इस रिपोर्ट के लिए, आपको 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 वीडियो चलाने की जानकारी वाले डाइमेंशन की अलग-अलग वैल्यू के लिए सामान्य नहीं की जाती हैं.
उदाहरण के लिए, subscribedStatus डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट में, viewerPercentage डेटा, सदस्यता वाले व्यू के लिए 100 प्रतिशत और viewerPercentage डेटा, सदस्यता न लेने वाले व्यू के लिए 100 प्रतिशत जोड़ता है. (रिपोर्ट में मौजूद सभी viewerPercentage फ़ील्ड की कुल वैल्यू 200 प्रतिशत है.)
फ़िल्टर का इस्तेमाल करके, यह पक्का किया जा सकता है कि रिपोर्ट में सिर्फ़ subscribedStatus डाइमेंशन की एक वैल्यू के लिए viewerPercentage डेटा शामिल हो.
सबसे ज़्यादा देखी जाने वाली प्लेलिस्ट
ध्यान दें: इन रिपोर्ट के लिए, आपको maxResults पैरामीटर को 200 या उससे कम की पूर्णांक वैल्यू पर सेट करना होगा. 1 जनवरी, 2013 से पहले का डेटा, सिर्फ़ सबसे ज़्यादा देखी गई 10 प्लेलिस्ट के लिए उपलब्ध है. ज़्यादातर अन्य रिपोर्ट के विपरीत, इन रिपोर्ट के लिए भी आपको sort अनुरोध पैरामीटर की वैल्यू तय करनी होगी.
इस रिपोर्ट में, फ़िल्टर करने और क्रम से लगाने की तय की गई शर्तों के आधार पर, चैनल की सबसे लोकप्रिय प्लेलिस्ट की सूची दिखती है.
ध्यान दें: विज्ञापन की परफ़ॉर्मेंस रिपोर्ट देखने के लिए, अनुमति देने वाला ऐसा टोकन ज़रूरी है जो https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप का ऐक्सेस देता हो.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, वीडियो चलाने के दौरान दिखने वाले विज्ञापनों के लिए, इंप्रेशन पर आधारित मेट्रिक मिलती हैं. इन मेट्रिक में हर विज्ञापन इंप्रेशन की गिनती की जाती है. साथ ही, हर वीडियो प्लेबैक से कई इंप्रेशन मिल सकते हैं.
इंप्रेशन पर आधारित विज्ञापन की परफ़ॉर्मेंस मेट्रिक ये हैं:
इसके अलावा, कुछ वीडियो रिपोर्ट में, प्लेबैक पर आधारित विज्ञापन की परफ़ॉर्मेंस की ये मेट्रिक काम करती हैं. हालांकि, इन मेट्रिक को विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में शामिल नहीं किया जाता.
[null,null,["आखिरी बार 2024-11-15 (UTC) को अपडेट किया गया."],[[["The YouTube Analytics API provides channel reports that measure user activity metrics, including video views, ratings, and subscriptions across various report types like video, playlist, and ad performance."],["To retrieve reports, use the `ids` parameter with `channel==MINE` for the authenticated user's channel or `channel==CHANNEL_ID` for a specific channel, requiring ownership, while requests require OAuth 2.0 authorization with specific scopes for user activity and monetary data."],["Report tables utilize dimensions for data categories (e.g., `day`, `country`), metrics for quantitative measurements (e.g., `views`, `likes`), and filters to refine data (e.g., `country==US`), allowing customization based on the required report type."],["Playlist reports analyze user interactions within a channel's playlists, offering metrics like `views`, `estimatedMinutesWatched`, and `playlistStarts`, with options for geographic and time-based breakdowns, and specific filters, such as `isCurated`, that will be deprecated soon."],["Certain reports have constraints such as `maxResults` limitations, required sorting, and restrictions on using certain metrics or dimensions together, like `liveOrOnDemand` and `averageViewPercentage`, while certain traffic sources and report types might not be supported."]]],[]]
