Dimensions

इस दस्तावेज़ में उन डाइमेंशन के बारे में बताया गया है जो YouTube Analytics API के साथ काम करते हैं. यह एपीआई, रीयल-टाइम में टारगेट की गई क्वेरी के साथ काम करता है, ताकि YouTube Analytics की कस्टम रिपोर्ट जनरेट की जा सकें.

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

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

क्वेरी रिपोर्ट पाने के लिए, YouTube Analytics API के reports.query तरीके को कॉल करें. अपने अनुरोध में, dimensions पैरामीटर का इस्तेमाल करके वे डाइमेंशन तय करें जिनका इस्तेमाल YouTube, रिपोर्ट में मेट्रिक वैल्यू का हिसाब लगाने के लिए करेगा.

मुख्य डाइमेंशन

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

यहां दी गई सूची में, एपीआई के मुख्य डाइमेंशन के बारे में बताया गया है.

ज़्यादा जानकारी के लिए, समर्थन नहीं होने की नीति के तहत आने वाले YouTube API की सूची देखें.

फ़िल्टर

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

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

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

आयाम

यहां दिए गए सेक्शन में, उन डाइमेंशन के बारे में बताया गया है जिनका इस्तेमाल YouTube Analytics API की क्वेरी रिपोर्ट में किया जाता है. जब तक अलग से न बताया जाए, तब तक इन डाइमेंशन का इस्तेमाल चैनल और कॉन्टेंट के मालिक, दोनों की रिपोर्ट में किया जाता है. सिर्फ़ फ़िल्टर के तौर पर इस्तेमाल किए जा सकने वाले डाइमेंशन की भी पहचान की जाती है.

संसाधन

ये डाइमेंशन, उन संसाधनों से जुड़े होते हैं जिन्हें चैनल और कॉन्टेंट के मालिक, YouTube पर मैनेज करते हैं:

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

वीडियो (मुख्य डाइमेंशन)
YouTube वीडियो का आईडी. YouTube Data API में, यह video रिसॉर्स की id प्रॉपर्टी की वैल्यू होती है. This is a core dimension and is subject to the Deprecation Policy.
प्लेलिस्ट
YouTube प्लेलिस्ट का आईडी. YouTube Data API में, यह playlist संसाधन की id प्रॉपर्टी की वैल्यू होती है.
channel (मुख्य डाइमेंशन) (सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट में इस्तेमाल किया जाता है)
YouTube चैनल का आईडी. YouTube Data API में, यह channel संसाधन की id प्रॉपर्टी की वैल्यू होती है. This is a core dimension and is subject to the Deprecation Policy.

कॉन्टेंट के मालिक की रिपोर्ट में, channel डाइमेंशन का इस्तेमाल अक्सर किया जाता है. इसकी वजह यह है कि उन रिपोर्ट में आम तौर पर कई चैनलों का कुल डेटा इकट्ठा किया जाता है.
group (सिर्फ़ फ़िल्टर)
YouTube Analytics ग्रुप का आईडी. YouTube Analytics API के groups.list तरीके का इस्तेमाल करके, इस वैल्यू को वापस पाया जा सकता है. group फ़िल्टर का इस्तेमाल करने पर, एपीआई से मिले जवाब में उस ग्रुप के सभी वीडियो, प्लेलिस्ट या चैनलों का डेटा शामिल होता है.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, रिपोर्टिंग इकाई के डाइमेंशन या फ़िल्टर का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • बुनियादी आंकड़े
      • टॉप 10 – किसी चैनल पर सबसे ज़्यादा देखे गए वीडियो
      • टॉप 10 – चैनल के सबसे ज़्यादा देखे गए वीडियो के लिए, एनोटेशन पर क्लिक मिलने की दर
      • किसी प्लेलिस्ट के आंकड़े
      • टॉप 10 – किसी चैनल की सबसे ज़्यादा देखी गई प्लेलिस्ट
    • भौगोलिक
      • टॉप 10 – किसी देश में सबसे ज़्यादा देखे गए वीडियो
      • टॉप 10 – यूरोप में सबसे ज़्यादा देखे गए वीडियो

  • कॉन्टेंट के मालिक के उदाहरण

    • बुनियादी आंकड़े
      • टॉप 10 - कॉन्टेंट के मालिक के सबसे ज़्यादा देखे गए वीडियो
      • कॉन्टेंट के मालिक के लिए, सबसे ज़्यादा देखे गए 10 वीडियो
      • टॉप 10 - कॉन्टेंट के मालिक के चैनल पर सबसे ज़्यादा देखे गए वीडियो
      • टॉप 10 – चैनल के सबसे ज़्यादा देखे गए वीडियो के लिए, एनोटेशन पर क्लिक मिलने की दर
      • कॉन्टेंट के मालिक की सबसे ज़्यादा देखी गई 10 प्लेलिस्ट
    • भौगोलिक
      • कॉन्टेंट के मालिक के लिए, यूरोप में सबसे ज़्यादा देखे गए टॉप 10 वीडियो
      • टॉप 10 – अमेरिका में सबसे ज़्यादा सुनी गई प्लेलिस्ट

भौगोलिक इलाके

इन डाइमेंशन से, उपयोगकर्ता गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित रेवेन्यू मेट्रिक से जुड़े भौगोलिक क्षेत्र की पहचान की जाती है.

country (मुख्य डाइमेंशन)
रिपोर्ट की लाइन में मौजूद मेट्रिक से जुड़ा देश. डाइमेंशन की वैल्यू, दो अक्षरों वाला ISO-3166-1 देश का कोड होती है. जैसे, US, CN (चीन) या FR (फ़्रांस). देश के कोड ZZ का इस्तेमाल, उन मेट्रिक की रिपोर्ट करने के लिए किया जाता है जिनके लिए YouTube, देश की पहचान नहीं कर सका. This is a core dimension and is subject to the Deprecation Policy.
province
रिपोर्ट की लाइन में मौजूद मेट्रिक से जुड़ा अमेरिका का राज्य या इलाका. डाइमेंशन की वैल्यू, ISO 3166-2 कोड होती है.इससे अमेरिका के किसी राज्य या डिस्ट्रिक्ट ऑफ़ कोलंबिया की पहचान की जाती है. जैसे, US-MI (मिशिगन) या US-TX (टेक्सस). प्रांत के कोड US-ZZ का इस्तेमाल, उन मेट्रिक की रिपोर्ट करने के लिए किया जाता है जिनके लिए YouTube, अमेरिका के राज्य की पहचान नहीं कर सका. जब किसी एपीआई अनुरोध में dimensions पैरामीटर वैल्यू में province शामिल होता है, तो अनुरोध में filters पैरामीटर वैल्यू में country==US को शामिल करके, डेटा को अमेरिका तक सीमित करना भी ज़रूरी है.

ध्यान दें: इस डाइमेंशन में, अमेरिका के बाहरी इलाकों की पहचान करने वाली ISO 3166-2 वैल्यू का इस्तेमाल नहीं किया जा सकता. इसकी वजह यह है कि उन इलाकों के अपने ISO 3166-1 देश कोड भी होते हैं. यह अमेरिका के अलावा, अन्य देशों के सबडिवीज़न के साथ भी काम नहीं करता.

dma
तीन अंकों वाला आइडेंटिफ़ायर, जिसका इस्तेमाल Nielsen, डेटा लाइन में बताए गए व्यूइंग इवेंट से जुड़े खास तौर पर बनाए गए बाज़ार (डीएमए) की पहचान करने के लिए करता है.
city
रिपोर्ट की लाइन में मौजूद मेट्रिक से जुड़ा अनुमानित शहर. इस डाइमेंशन का डेटा, 1 जनवरी, 2022 से उपलब्ध है.
continent (सिर्फ़ फ़िल्टर)
संयुक्त राष्ट्र (यूएन) का स्टैटिस्टिकल रीजन कोड. एपीआई में ये वैल्यू इस्तेमाल की जा सकती हैं:
वैल्यू ब्यौरा
002 अफ़्रीका
019 अमेरिका (उत्तरी अमेरिका, लैटिन अमेरिका, दक्षिण अमेरिका, और कैरेबियन)
142 एशिया
150 यूरोप
009 ओशीनिया
इस डाइमेंशन का इस्तेमाल सिर्फ़ डेटा को फ़िल्टर करने के लिए किया जा सकता है. इस डाइमेंशन का इस्तेमाल करने के लिए, filters पैरामीटर की वैल्यू को continent==REGION_CODE पर सेट करें. साथ ही, टेबल से REGION_CODE वैल्यू तय करें.
subContinent (सिर्फ़ फ़िल्टर)
संयुक्त राष्ट्र का सांख्यिकी क्षेत्र कोड, जिससे किसी भौगोलिक उप-क्षेत्र की पहचान की जाती है. संयुक्त राष्ट्र सांख्यिकी प्रभाग, उप-क्षेत्रों के साथ-साथ उन देशों की सूची भी दिखाता है जो हर क्षेत्र से जुड़े हैं.

इस डाइमेंशन का इस्तेमाल सिर्फ़ डेटा को फ़िल्टर करने के लिए किया जा सकता है. इस डाइमेंशन का इस्तेमाल करने के लिए, filters पैरामीटर की वैल्यू को subContinent==REGION_CODE पर सेट करें. साथ ही, संयुक्त राष्ट्र की सूची से REGION_CODE वैल्यू तय करें.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, भौगोलिक डाइमेंशन या फ़िल्टर का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • बुनियादी आंकड़े: किसी चैनल के लिए, देश के हिसाब से व्यू की संख्या और अन्य जानकारी
    • भौगोलिक
      • किसी चैनल के वीडियो देखने के कुल समय की मेट्रिक, देश के हिसाब से
      • किसी चैनल के वीडियो के लिए, देश के हिसाब से एनोटेशन मेट्रिक
      • अमेरिका के राज्यों और वॉशिंगटन डी॰सी॰ के लिए, प्रांत के हिसाब से मेट्रिक.
      • किसी चैनल की प्लेलिस्ट के लिए, देश के हिसाब से वीडियो देखने के कुल समय की मेट्रिक
      • टॉप 10 – अमेरिका में सबसे ज़्यादा सुनी गई प्लेलिस्ट
    • वीडियो चलाने की जगह: अलग-अलग जगहों पर वीडियो चलाने से मिले रोज़ाना के व्यू की संख्या और वीडियो देखने का कुल समय
    • ट्रैफ़िक सोर्स: किसी देश में अलग-अलग ट्रैफ़िक सोर्स से मिले व्यू और वीडियो देखने का कुल समय
    • डेमोग्राफ़िक: कैलिफ़ोर्निया में रहने वाले दर्शकों की डेमोग्राफ़िक जानकारी (उम्र समूह और लिंग)
    • सबसे लोकप्रिय वीडियो
      • टॉप 10 – किसी देश में सबसे ज़्यादा देखे गए वीडियो
      • टॉप 10 – यूरोप में सबसे ज़्यादा देखे गए वीडियो

  • कॉन्टेंट के मालिक के उदाहरण

    • बुनियादी आंकड़े: खुद अपलोड किए गए सभी वीडियो के लिए, देश के हिसाब से व्यू की संख्या और अन्य जानकारी
    • भौगोलिक
      • खुद अपलोड किए गए कॉन्टेंट को देखने के कुल समय की मेट्रिक, देश के हिसाब से
      • खुद अपलोड किए गए कॉन्टेंट के लिए, देश के हिसाब से एनोटेशन मेट्रिक
      • अमेरिका के राज्यों और वॉशिंगटन डी॰सी॰ के लिए, प्रांत के हिसाब से मेट्रिक.
      • कॉन्टेंट के मालिक की प्लेलिस्ट के लिए, देश के हिसाब से वीडियो देखने के कुल समय की मेट्रिक
      • टॉप 10 – अमेरिका में सबसे ज़्यादा सुनी गई प्लेलिस्ट
    • वीडियो चलाने की जगह: अलग-अलग जगहों पर वीडियो चलाने से मिले रोज़ाना के व्यू की संख्या और वीडियो देखने का कुल समय
    • डेमोग्राफ़िक: कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक जानकारी (उम्र समूह और लिंग)
    • सबसे लोकप्रिय वीडियो: टॉप 10 – यूरोप में कॉन्टेंट के मालिक के सबसे ज़्यादा देखे गए वीडियो
    • रेवेन्यू/विज्ञापन की परफ़ॉर्मेंस: देश के हिसाब से रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक

समयावधि

इन डाइमेंशन से पता चलता है कि किसी रिपोर्ट में डेटा को किसी समयावधि के हिसाब से इकट्ठा किया जाना चाहिए. जैसे, दिन, हफ़्ते या महीने के हिसाब से. startDate और endDate अनुरोध पैरामीटर से उस समयावधि का पता चलता है जिसके लिए रिपोर्ट में डेटा शामिल किया गया है. ध्यान दें कि रिपोर्ट में उस आखिरी दिन तक का डेटा दिखता है जिसके लिए, अनुरोध में बताई गई सभी मेट्रिक, क्वेरी किए जाने के समय उपलब्ध होती हैं. रिपोर्ट में, तारीखें YYYY-MM-DD फ़ॉर्मैट में दिखती हैं.

अहम जानकारी: सभी तारीखें, पैसिफ़िक समय (यूटीसी-7 या यूटीसी-8) के मुताबिक रात 12:00 बजे से शुरू होकर, तय किए गए दिन, महीने, और साल को रात 11:59 बजे खत्म होने वाली समयावधि के हिसाब से होती हैं. इस वजह से, जिन तारीखों पर डेलाइट सेविंग टाइम के लिए घड़ियों को आगे सेट किया जाता है वे 23 घंटे की अवधि दिखाती हैं. साथ ही, जिन तारीखों पर घड़ियों को पीछे सेट किया जाता है वे 25 घंटे की अवधि दिखाती हैं.

महीना डाइमेंशन, तय किए गए महीने और साल के पहले दिन, पैसिफ़िक समय (यूटीसी-7 या यूटीसी-8) के मुताबिक रात 12:00 बजे से शुरू होने वाली समयावधि को दिखाता है.

day (मुख्य डाइमेंशन)
इस डाइमेंशन का इस्तेमाल करने पर, रिपोर्ट में मौजूद डेटा को रोज़ के हिसाब से एग्रीगेट किया जाता है. साथ ही, हर लाइन में एक दिन का डेटा होता है. डेटा को और ज़्यादा ब्रेकडाउन करने के लिए, अन्य डाइमेंशन का इस्तेमाल किया जा सकता है. उदाहरण के लिए, ट्रैफ़िक सोर्स की रिपोर्ट, हर दिन के व्यू के आंकड़ों को एग्रीगेट कर सकती है. यह इस आधार पर किया जाता है कि उपयोगकर्ता आपके वीडियो तक कैसे पहुंचते हैं. This is a core dimension and is subject to the Deprecation Policy.
month (मुख्य डाइमेंशन)
रिपोर्ट में मौजूद डेटा, कैलेंडर के महीने के हिसाब से एग्रीगेट किया जाता है. रोज़ की रिपोर्ट की तरह ही, डेटा को और ज़्यादा सेगमेंट में बांटने के लिए अन्य फ़िल्टर इस्तेमाल किए जा सकते हैं. रिपोर्ट में, तारीखें YYYY-MM फ़ॉर्मैट में दिखती हैं.

ध्यान दें: अगर आपकी एपीआई क्वेरी में month डाइमेंशन का इस्तेमाल किया जाता है, तो start-date और end-date, दोनों पैरामीटर को महीने के पहले दिन पर सेट करना होगा. This is a core dimension and is subject to the Deprecation Policy.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, समय के हिसाब से डाइमेंशन या फ़िल्टर का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • समय के हिसाब से
      • किसी चैनल के वीडियो को रोज़ाना देखे जाने के कुल समय की मेट्रिक
      • किसी चैनल के वीडियो के लिए, रोज़ के एनोटेशन की मेट्रिक
      • किसी चैनल की प्लेलिस्ट को रोज़ाना मिलने वाले व्यू
    • वीडियो चलाने की जगह: अलग-अलग जगहों पर वीडियो चलाने से मिले रोज़ाना के व्यू की संख्या और वीडियो देखने का कुल समय
    • ट्रैफ़िक सोर्स: अलग-अलग ट्रैफ़िक सोर्स से मिले रोज़ाना के व्यू की संख्या और वीडियो देखने का कुल समय
    • डिवाइस/ओएस
      • Android ऑपरेटिंग सिस्टम के लिए, डिवाइस टाइप के हिसाब से रोज़ की मेट्रिक
      • मोबाइल डिवाइसों के लिए, ऑपरेटिंग सिस्टम की रोज़ की मेट्रिक
      • ऑपरेटिंग सिस्टम और डिवाइस टाइप के हिसाब से, हर दिन की मेट्रिक

  • कॉन्टेंट के मालिक के उदाहरण

    • समय के हिसाब से
      • खुद अपलोड किए गए कॉन्टेंट को रोज़ाना देखे जाने के कुल समय की मेट्रिक
      • दावे वाले कॉन्टेंट के लिए एनोटेशन मेट्रिक
      • कॉन्टेंट के मालिक के लिए, प्लेलिस्ट को रोज़ाना मिले व्यू
    • वीडियो चलाने की जगह: अलग-अलग जगहों पर वीडियो चलाने से मिले रोज़ाना के व्यू की संख्या और वीडियो देखने का कुल समय
    • ट्रैफ़िक सोर्स: अलग-अलग ट्रैफ़िक सोर्स से मिले व्यू की संख्या और वीडियो देखने का कुल समय
    • डिवाइस/ओएस
      • दावा किए गए वीडियो के लिए, डिवाइस टाइप के हिसाब से हर दिन की मेट्रिक
      • मोबाइल डिवाइसों पर देखे गए, दावा किए गए वीडियो के लिए रोज़ाना के ऑपरेटिंग सिस्टम की मेट्रिक
      • ऑपरेटिंग सिस्टम और डिवाइस टाइप के हिसाब से, हर दिन की मेट्रिक
    • रेवेन्यू/विज्ञापन की परफ़ॉर्मेंस: हर दिन का रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक

वीडियो चलाने की जगह

इन डाइमेंशन से, उस पेज या ऐप्लिकेशन के बारे में अहम जानकारी मिलती है जहां उपयोगकर्ता गतिविधि हुई थी.

insightPlaybackLocationType
रिपोर्ट में मौजूद डेटा को उस पेज या ऐप्लिकेशन के टाइप के आधार पर एग्रीगेट किया जाता है जहां वीडियो चलाया गया था. इस डाइमेंशन के लिए ये वैल्यू हो सकती हैं:

  • BROWSE – इस डेटा से पता चलता है कि YouTube के होम पेज या होम स्क्रीन, उपयोगकर्ता के सदस्यता फ़ीड या YouTube की किसी अन्य ब्राउज़िंग सुविधा से कितने व्यू मिले.

  • CHANNEL – इस डेटा से, चैनल पेज पर मिले व्यू की जानकारी मिलती है.

  • EMBEDDED – इस डेटा से उन व्यू के बारे में पता चलता है जो किसी दूसरी वेबसाइट या ऐप्लिकेशन पर मिले हैं. इन वेबसाइटों या ऐप्लिकेशन पर, वीडियो को <iframe> या <object> एम्बेड का इस्तेमाल करके एम्बेड किया गया था.

  • EXTERNAL_APP – इस डेटा से, तीसरे पक्ष के किसी ऐप्लिकेशन में मिले व्यू की जानकारी मिलती है. इसमें, वीडियो को <iframe> या <object> एम्बेड करने के अलावा, किसी दूसरे तरीके से चलाया गया हो. उदाहरण के लिए, YouTube Android Player API का इस्तेमाल करने वाले ऐप्लिकेशन में वीडियो चलाने की संख्या को इस वैल्यू का इस्तेमाल करके कैटगरी में बांटा जाएगा.

  • IMMERSIVE_LIVE_FEED – इस डेटा से, वर्टिकल लाइव फ़ीड पर मिले व्यू की जानकारी मिलती है.

  • MOBILE – इस डेटा से, YouTube की मोबाइल वेबसाइट या मंज़ूरी पा चुके YouTube API क्लाइंट पर मिले व्यू की जानकारी मिलती है. इसमें मोबाइल डिवाइसों पर मिले व्यू भी शामिल हैं.

    YouTube Analytics की रिपोर्ट में, 10 सितंबर, 2013 से वीडियो चलाए जाने की संख्या को MOBILE के तौर पर नहीं दिखाया जाता. हालांकि, रिपोर्ट में यह वैल्यू दिख सकती है, क्योंकि लेगसी डेटा अब भी इस कैटगरी में आता है. हालांकि, उस तारीख के बाद, मोबाइल प्लेबैक को WATCH, EMBEDDED या EXTERNAL_APP प्लेबैक के तौर पर बांटा जाता है. यह इस बात पर निर्भर करता है कि प्लेबैक किस तरह के ऐप्लिकेशन पर होते हैं.

  • SEARCH – इस डेटा से पता चलता है कि YouTube के खोज नतीजों वाले पेज से, वीडियो को कितने व्यू मिले.

  • SHORTS_FEED – इस डेटा से पता चलता है कि YouTube Shorts फ़ीड में वीडियो को कितने व्यू मिले.

  • WATCH – इस डेटा से पता चलता है कि वीडियो को YouTube के वॉच पेज पर या YouTube के आधिकारिक ऐप्लिकेशन, जैसे कि Android के लिए YouTube ऐप्लिकेशन पर कितनी बार देखा गया.

  • YT_OTHER – इस डेटा में ऐसे व्यू शामिल होते हैं जिन्हें किसी अन्य कैटगरी में नहीं रखा गया है.

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

उदाहरण

सैंपल के तौर पर दिए गए इन अनुरोधों में, वीडियो चलाए जाने की जगह के डाइमेंशन का इस्तेमाल किया जाता है:

  • चैनल के उदाहरण

    • वीडियो चलाने की जगह
      • अलग-अलग प्लेबैक लोकेशन से मिले व्यू और वीडियो देखने का कुल समय
      • अलग-अलग प्लेबैक लोकेशन से रोज़ाना मिले व्यू की संख्या और वीडियो देखने का कुल समय
      • टॉप 10 – तीसरे पक्ष की वे साइटें जिनसे एम्बेड किए गए वीडियो को सबसे ज़्यादा व्यू मिलते हैं
      • अलग-अलग प्लेबैक लोकेशन से प्लेलिस्ट के व्यू की संख्या और देखने का कुल समय
      • प्लेलिस्ट के रोज़ाना के व्यू की संख्या और वीडियो चलाने की अलग-अलग जगहों से मिले, वीडियो देखने के कुल समय की जानकारी

  • कॉन्टेंट के मालिक के उदाहरण

    • वीडियो चलाने की जगह
      • अलग-अलग प्लेबैक लोकेशन से मिले व्यू और वीडियो देखने का कुल समय
      • अलग-अलग प्लेबैक लोकेशन से रोज़ाना मिले व्यू की संख्या और वीडियो देखने का कुल समय
      • टॉप 10 – तीसरे पक्ष की वे साइटें जिनसे एम्बेड किए गए वीडियो को सबसे ज़्यादा व्यू मिलते हैं
      • अलग-अलग प्लेबैक लोकेशन से प्लेलिस्ट के व्यू की संख्या और देखने का कुल समय
      • प्लेलिस्ट के रोज़ाना के व्यू की संख्या और वीडियो चलाने की अलग-अलग जगहों से मिले, वीडियो देखने के कुल समय की जानकारी

प्लेबैक की जानकारी

creatorContentType
इस डाइमेंशन से, डेटा लाइन में उपयोगकर्ता गतिविधि की मेट्रिक से जुड़े कॉन्टेंट के टाइप की पहचान की जाती है. इस डाइमेंशन का डेटा, 1 जनवरी, 2019 से उपलब्ध है.

यहां दी गई टेबल में, डाइमेंशन की वैल्यू की सूची दी गई है:
वैल्यू ब्यौरा
LIVE_STREAM देखा गया कॉन्टेंट, YouTube लाइव स्ट्रीम था.
SHORTS देखा गया कॉन्टेंट, YouTube शॉर्ट वीडियो था.
STORY देखा गया कॉन्टेंट, YouTube स्टोरी था.
VIDEO_ON_DEMAND देखा गया कॉन्टेंट, YouTube का ऐसा वीडियो था जो किसी अन्य डाइमेंशन वैल्यू के तहत नहीं आता.
UNSPECIFIED देखे गए कॉन्टेंट के टाइप के बारे में जानकारी नहीं है.
liveOrOnDemand
इस डाइमेंशन से पता चलता है कि डेटा लाइन में मौजूद उपयोगकर्ता गतिविधि की मेट्रिक, लाइव ब्रॉडकास्ट के व्यू से जुड़ी हैं या नहीं. इस डाइमेंशन का डेटा, 1 अप्रैल, 2014 से उपलब्ध है.

नीचे दी गई टेबल में, डाइमेंशन की वैल्यू दी गई हैं:
वैल्यू ब्यौरा
LIVE लाइन के डेटा से, लाइव ब्रॉडकास्ट के दौरान हुई उपयोगकर्ता गतिविधि के बारे में पता चलता है.
ON_DEMAND लाइन के डेटा से, उपयोगकर्ता गतिविधि के बारे में पता चलता है जो लाइव ब्रॉडकास्ट के दौरान नहीं हुई.
subscribedStatus
इस डाइमेंशन से पता चलता है कि डेटा लाइन में मौजूद उपयोगकर्ता गतिविधि की मेट्रिक, उन दर्शकों से जुड़ी हैं या नहीं जिन्होंने वीडियो या प्लेलिस्ट के चैनल की सदस्यता ली है. संभावित वैल्यू SUBSCRIBED और UNSUBSCRIBED हैं.

ध्यान दें कि डाइमेंशन की वैल्यू, उपयोगकर्ता गतिविधि के समय के हिसाब से सटीक होती है. उदाहरण के लिए, मान लें कि किसी उपयोगकर्ता ने किसी चैनल की सदस्यता नहीं ली है और वह उस चैनल का कोई वीडियो देखता है. इसके बाद, वह उसी दिन उस चैनल की सदस्यता लेता है और कोई दूसरा वीडियो देखता है. चैनल की रिपोर्ट से पता चलता है कि एक व्यू की subscribedStatus वैल्यू SUBSCRIBED है और एक व्यू की subscribedStatus वैल्यू UNSUBSCRIBED है.
youtubeProduct
इस डाइमेंशन से, YouTube की उस सेवा की पहचान होती है जिस पर उपयोगकर्ता गतिविधि हुई. इस डाइमेंशन का डेटा 18 जुलाई, 2015 से उपलब्ध है.

इस टेबल में डाइमेंशन की वैल्यू दी गई हैं:
वैल्यू ब्यौरा
CORE उपयोगकर्ता की ऐसी गतिविधि जो YouTube के खास ऐप्लिकेशन (YouTube Gaming, YouTube Kids या YouTube Music) में से किसी एक में नहीं हुई. अपवाद: YouTube Music पर 1 मार्च, 2021 से पहले की गई उपयोगकर्ता गतिविधि को CORE में शामिल किया गया है.
GAMING उपयोगकर्ता गतिविधि, YouTube Gaming में हुई.
KIDS उपयोगकर्ता गतिविधि, YouTube Kids में हुई.
MUSIC उपयोगकर्ता गतिविधि 1 मार्च, 2021 को या इसके बाद YouTube Music में हुई हो. 1 मार्च, 2021 से पहले का डेटा, CORE में शामिल है. रीयल-टाइम डेटा रिकॉर्ड नहीं किया जाता.
UNKNOWN उपयोगकर्ता गतिविधि 18 जुलाई, 2015 से पहले हुई हो.

ट्रैफ़िक सोर्स

insightTrafficSourceType
रिपोर्ट में मौजूद डेटा को रेफ़रल देने वाले के टाइप के आधार पर इकट्ठा किया जाता है. इससे पता चलता है कि उपयोगकर्ताओं ने वीडियो तक पहुंचने के लिए कौनसा तरीका अपनाया. इस डाइमेंशन के लिए ये वैल्यू हो सकती हैं:
  • ADVERTISING – दर्शक को किसी विज्ञापन से वीडियो पर भेजा गया. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से विज्ञापन के टाइप की पहचान होती है.
  • ANNOTATION – दर्शक किसी दूसरे वीडियो में मौजूद एनोटेशन पर क्लिक करके, वीडियो तक पहुंचे.
  • CAMPAIGN_CARD – ये व्यू, दावा किए गए उन वीडियो से मिले हैं जिन्हें उपयोगकर्ताओं ने अपलोड किया है. साथ ही, कॉन्टेंट के मालिक ने इन वीडियो का इस्तेमाल, देखे गए कॉन्टेंट का प्रमोशन करने के लिए किया है. यह ट्रैफ़िक सोर्स, सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए उपलब्ध है.
  • END_SCREEN – व्यू, किसी दूसरे वीडियो की एंड स्क्रीन से मिले हैं.
  • EXT_URL – वीडियो के व्यू, किसी दूसरी वेबसाइट पर मौजूद लिंक से मिले. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से वेब पेज की पहचान होती है. इस ट्रैफ़िक सोर्स में, Google पर खोज नतीजों से मिलने वाले रेफ़रल शामिल होते हैं.
  • HASHTAGS – वीओडी के हैशटैग पेजों या शॉर्ट वीडियो के हैशटैग पिवट पेजों से मिले व्यू.
  • LIVE_REDIRECT - वीडियो को मिले वे व्यू जो लाइव रीडायरेक्ट से मिले.
  • NO_LINK_EMBEDDED – वीडियो को किसी दूसरी वेबसाइट पर एम्बेड किया गया था और वहीं से देखा गया.
  • NO_LINK_OTHER – YouTube को ट्रैफ़िक के रेफ़रल की जानकारी नहीं मिली. इस कैटगरी में, किसी वीडियो पर आने वाला डायरेक्ट ट्रैफ़िक और मोबाइल ऐप्लिकेशन पर आने वाला ट्रैफ़िक शामिल है.
  • NOTIFICATION – वीडियो को YouTube से मिले ईमेल या सूचना से व्यू मिले.
  • PLAYLIST – वीडियो को प्लेलिस्ट के हिस्से के तौर पर चलाए जाने के दौरान मिले व्यू. इसमें प्लेलिस्ट पेज से आने वाला ट्रैफ़िक शामिल होता है.
  • PRODUCT_PAGE - वीडियो को प्रॉडक्ट पेज से व्यू मिले.
  • PROMOTED – वीडियो को YouTube पर बिना पैसे चुकाए किए गए प्रमोशन से व्यू मिले. जैसे, YouTube के "स्पॉटलाइट वीडियो" पेज से.
  • RELATED_VIDEO – वीडियो पर मिले व्यू, किसी दूसरे वीडियो के वॉच पेज पर मौजूद मिलते-जुलते वीडियो की सूची से आए हैं. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड में उस वीडियो का आईडी दिखता है.
  • SHORTS – दर्शक को Shorts फ़ीड में पिछले वीडियो से वर्टिकल स्वाइप करके, इस वीडियो पर भेजा गया.
  • SOUND_PAGE – शॉर्ट वीडियो के साउंड पिवट पेजों से मिले व्यू.
  • SUBSCRIBER – वीडियो को YouTube के होम पेज पर मौजूद फ़ीड या YouTube की सदस्यता सुविधाओं से व्यू मिले. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड में होम पेज फ़ीड के आइटम या उस पेज की जानकारी दिखती है जहां से व्यू मिले हैं.
  • YT_CHANNEL – वीडियो को चैनल पेज पर देखा गया. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड में उस चैनल का चैनल आईडी दिखता है.
  • YT_OTHER_PAGE – वीडियो को मिले व्यू, YouTube पेज पर दिखने वाले खोज के नतीजे या मिलते-जुलते वीडियो के लिंक के बजाय किसी अन्य लिंक से मिले थे. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से पेज की पहचान होती है.
  • YT_SEARCH – वीडियो पर मिले व्यू, YouTube पर खोज के नतीजों से आए हैं. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड में खोज के लिए इस्तेमाल हुए शब्द दिखते हैं.
  • VIDEO_REMIXES – वीडियो पर व्यू, Shorts प्लेयर में मौजूद रीमिक्स किए गए वीडियो के लिंक से मिले. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से उस वीडियो की जानकारी मिलती है जिससे दर्शक को रेफ़र किया गया था.
  • WATCH_WITH – वीडियो को व्यू, क्रिएटर की कमेंट्री / "साथ में देखें" स्ट्रीम से मिले. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से उस वीडियो की जानकारी मिलती है जिससे दर्शक को रेफ़र किया गया था.
insightTrafficSourceDetail
रिपोर्ट में मौजूद डेटा, उन रेफ़रल के आधार पर इकट्ठा किया जाता है जिनसे किसी वीडियो और ट्रैफ़िक सोर्स के टाइप के लिए सबसे ज़्यादा व्यू मिले हैं. यहां दी गई सूची में उन ट्रैफ़िक सोर्स की जानकारी दी गई है जिनके लिए यह रिपोर्ट उपलब्ध है. हर ट्रैफ़िक सोर्स के लिए, सूची में वह जानकारी दी गई है जो insightTrafficSourceDetail डाइमेंशन से मिलती है.
  • ADVERTISING – विज्ञापन का वह टाइप जिसकी वजह से व्यू मिले. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • क्लिक-टू-प्ले एंगेजमेंट विज्ञापन
    • सहभागिता विज्ञापन
    • Google Search विज्ञापन
    • मुख्यपृष्ठ वीडियो विज्ञापन
    • रिज़र्व किया गया स्किप किया जा सकने वाला इन-स्ट्रीम विज्ञापन
    • TrueView इन-सर्च और इन-डिसप्ले
    • TrueView इन-स्ट्रीम
    • अश्रेणीबद्ध YouTube विज्ञापन
    • वीडियो वॉल
  • CAMPAIGN_CARD – दावा किया गया वह वीडियो जिसकी वजह से दर्शक, रिपोर्ट में बताए गए वीडियो तक पहुंचे.
  • END_SCREEN – वह वीडियो जिसकी वजह से दर्शक, रिपोर्ट में बताए गए वीडियो तक पहुंचे.
  • EXT_URL – वह वेबसाइट जिसने दर्शकों को वीडियो देखने के लिए भेजा.
  • HASHTAGS – वह हैशटैग जिसकी वजह से व्यू मिले.
  • NOTIFICATION – वह ईमेल या सूचना जिससे ट्रैफ़िक रेफ़र किया गया.
  • RELATED_VIDEO – वह मिलता-जुलता वीडियो जिसकी वजह से दर्शक, रिपोर्ट में शामिल वीडियो तक पहुंचे.
  • SOUND_PAGE – वह वीडियो जिससे व्यू मिले.
  • SUBSCRIBER – होम पेज फ़ीड का आइटम या YouTube की सदस्यता की सुविधा, जिसकी वजह से दर्शक रिपोर्ट में शामिल वीडियो तक पहुंचे. कन्वर्ज़न के लिए मान्य डिवाइस ये हैं:
    • activity – होम पेज के सदस्यता पेज पर नए वीडियो के फ़ीड में मौजूद आइटम से मिले व्यू. ये व्यू, अपलोड न किए गए और सोशल मीडिया पर शेयर न किए गए वीडियो से जुड़ी गतिविधि से मिले हैं. जैसे, पसंद किए गए वीडियो, पसंदीदा वीडियो, बुलेटिन पोस्ट, और प्लेलिस्ट में जोड़े गए वीडियो.
    • blogged – होम पेज के सदस्यता पेज पर नए वीडियो के फ़ीड में मौजूद आइटम से मिले व्यू. ये व्यू, टॉप ब्लॉग के लिंक से मिले हैं.
    • mychannel – होम पेज पर मौजूद अन्य फ़ीड में मौजूद आइटम से मिले व्यू. जैसे, "पसंद किए गए वीडियो", "वीडियो देखने का इतिहास", और "बाद में देखें".
    • podcasts – पॉडकास्ट के डेस्टिनेशन पेज पर मौजूद आइटम से मिले व्यू.
    • sdig – सदस्यता से जुड़े अपडेट वाले ईमेल से मिले व्यू.
    • uploaded – होम पेज के सदस्यता पेज पर नए वीडियो के फ़ीड में, uploaded आइटम से मिले व्यू.
    • / – YouTube के होम पेज से मिले अन्य व्यू.
    • /my_subscriptions – YouTube पर उपयोगकर्ताओं के मेरी सदस्यताएं पेज से मिले व्यू.
  • YT_CHANNEL – वह चैनल पेज जहां दर्शकों ने वीडियो देखा.
  • YT_OTHER_PAGE – YouTube का वह पेज जहां से दर्शक आपके वीडियो पर पहुंचे.
  • YT_SEARCH – खोज के लिए इस्तेमाल किया गया वह शब्द जिसकी वजह से दर्शक वीडियो तक पहुंचे.
  • VIDEO_REMIXES – वह वीडियो जिससे व्यू मिले.
  • WATCH_WITH – वह वीडियो जिससे व्यू मिले.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, ट्रैफ़िक सोर्स के डाइमेंशन का इस्तेमाल किया जाता है:

  • चैनल के उदाहरण

    • ट्रैफ़िक सोर्स
      • किसी देश में अलग-अलग ट्रैफ़िक सोर्स से मिले व्यू और वीडियो देखने का कुल समय
      • अलग-अलग ट्रैफ़िक सोर्स से मिले रोज़ के व्यू की संख्या और वीडियो देखने का कुल समय
      • टॉप 10 – YouTube पर खोज के लिए इस्तेमाल किए गए वे शब्द जिनसे किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक जनरेट होता है
      • टॉप 10 – Google Search पर खोज के लिए इस्तेमाल हुए वे शब्द जिनसे किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक मिला
      • किसी देश में अलग-अलग ट्रैफ़िक सोर्स से, प्लेलिस्ट के व्यू की संख्या और उसे देखने का कुल समय
      • अलग-अलग ट्रैफ़िक सोर्स से, प्लेलिस्ट को रोज़ाना मिले व्यू की संख्या और उसे देखने का कुल समय

  • कॉन्टेंट के मालिक के उदाहरण

    • ट्रैफ़िक सोर्स
      • अलग-अलग ट्रैफ़िक सोर्स से मिले व्यू और वीडियो देखने का कुल समय
      • अलग-अलग ट्रैफ़िक सोर्स से मिले रोज़ के व्यू की संख्या और वीडियो देखने का कुल समय
      • टॉप 10 – YouTube पर खोज के लिए इस्तेमाल किए गए वे शब्द जिनसे किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक जनरेट होता है
      • टॉप 10 – Google Search पर खोज के लिए इस्तेमाल हुए वे शब्द जिनसे किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक मिला
      • किसी देश में अलग-अलग ट्रैफ़िक सोर्स से, प्लेलिस्ट के व्यू की संख्या और उसे देखने का कुल समय
      • अलग-अलग ट्रैफ़िक सोर्स से, प्लेलिस्ट को रोज़ाना मिले व्यू की संख्या और उसे देखने का कुल समय

डिवाइस

deviceType
इस डाइमेंशन से, उस डिवाइस के फ़िज़िकल फ़ॉर्म फ़ैक्टर की पहचान होती है जिस पर व्यू जनरेट हुआ. यहां दी गई सूची में उन डिवाइस टाइप के बारे में बताया गया है जिनके लिए एपीआई, डेटा दिखाता है. deviceType डाइमेंशन का इस्तेमाल फ़िल्टर के तौर पर भी किया जा सकता है. इससे, ऑपरेटिंग सिस्टम की रिपोर्ट को सिर्फ़ किसी खास तरह के डिवाइस के डेटा तक सीमित किया जा सकता है.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
यह डाइमेंशन, उस डिवाइस के सॉफ़्टवेयर सिस्टम की पहचान करता है जिस पर व्यू मिला. यहां दी गई सूची में उन ऑपरेटिंग सिस्टम के बारे में बताया गया है जिनके लिए एपीआई, डेटा दिखाता है. operatingSystem का इस्तेमाल फ़िल्टर के तौर पर भी किया जा सकता है. इससे, डिवाइस टाइप की रिपोर्ट को किसी खास ऑपरेटिंग सिस्टम के डेटा तक सीमित किया जा सकता है.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

उदाहरण

नीचे दिए गए सैंपल अनुरोधों में, डिवाइस के डाइमेंशन का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • डिवाइस/ओएस
      • Android ऑपरेटिंग सिस्टम के लिए, डिवाइस टाइप के हिसाब से रोज़ की मेट्रिक
      • मोबाइल डिवाइसों के लिए, ऑपरेटिंग सिस्टम की रोज़ की मेट्रिक
      • ऑपरेटिंग सिस्टम और डिवाइस टाइप के हिसाब से, हर दिन की मेट्रिक
      • Android ऑपरेटिंग सिस्टम पर प्लेलिस्ट के व्यू के लिए, डिवाइस टाइप के हिसाब से रोज़ की मेट्रिक
      • मोबाइल डिवाइसों पर प्लेलिस्ट के व्यू के लिए, ऑपरेटिंग सिस्टम की रोज़ की मेट्रिक

  • कॉन्टेंट के मालिक के उदाहरण

    • डिवाइस/ओएस
      • दावा किए गए वीडियो के लिए, डिवाइस टाइप के हिसाब से हर दिन की मेट्रिक
      • मोबाइल डिवाइसों पर देखे गए, दावा किए गए वीडियो के लिए रोज़ाना के ऑपरेटिंग सिस्टम की मेट्रिक
      • ऑपरेटिंग सिस्टम और डिवाइस टाइप के हिसाब से, हर दिन की मेट्रिक
      • Android ऑपरेटिंग सिस्टम पर प्लेलिस्ट के व्यू के लिए, डिवाइस टाइप के हिसाब से रोज़ की मेट्रिक
      • मोबाइल डिवाइसों पर प्लेलिस्ट के व्यू के लिए, ऑपरेटिंग सिस्टम की रोज़ की मेट्रिक

डेमोग्राफ़िक्स

डेमोग्राफ़िक डाइमेंशन से, आपको अपने दर्शकों की उम्र की सीमा और लिंग के बारे में जानकारी मिलती है. YouTube सहायता केंद्र पर, YouTube Analytics रिपोर्ट में मौजूद डेमोग्राफ़िक डेटा के बारे में ज़्यादा जानकारी दी गई है.

ageGroup (मुख्य डाइमेंशन)
इस डाइमेंशन से, रिपोर्टिंग डेटा से जुड़े उन उपयोगकर्ताओं के उम्र समूह की पहचान की जाती है जिन्होंने लॉग इन किया है. इसमें वे उपयोगकर्ता भी शामिल हैं जिनकी उम्र YouTube के अनुमान के मुताबिक 18 साल से कम है. एपीआई, इन उम्र समूहों का इस्तेमाल करता है:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (मुख्य डाइमेंशन)
इस डाइमेंशन से, रिपोर्टिंग डेटा से जुड़े लॉग इन किए हुए उपयोगकर्ताओं के लिंग की पहचान की जाती है. female, male, और user_specified को वैल्यू के तौर पर इस्तेमाल किया जा सकता है. This is a core dimension and is subject to the Deprecation Policy.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, डेमोग्राफ़िक डाइमेंशन का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • डेमोग्राफ़िक
      • कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक्स (उम्र समूह और लिंग)
      • कैलिफ़ोर्निया में प्लेलिस्ट देखने वाले दर्शकों की डेमोग्राफ़िक्स (उम्र समूह और लिंग)

  • कॉन्टेंट के मालिक के उदाहरण

    • डेमोग्राफ़िक
      • कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक्स (उम्र समूह और लिंग)
      • कैलिफ़ोर्निया में प्लेलिस्ट देखने वाले दर्शकों की डेमोग्राफ़िक्स (उम्र समूह और लिंग)

यूज़र ऐक्टिविटी और कॉन्टेंट शेयर करना

sharingService (मुख्य डाइमेंशन)
इस डाइमेंशन से, वीडियो शेयर करने के लिए इस्तेमाल की गई सेवा का पता चलता है. "शेयर करें" बटन का इस्तेमाल करके, YouTube पर (या YouTube प्लेयर के ज़रिए) वीडियो शेयर किए जा सकते हैं. This is a core dimension and is subject to the Deprecation Policy.

इस टेबल में, डाइमेंशन की मान्य वैल्यू दी गई हैं:
शेयर करने की सेवा एपीआई वैल्यू
Allo ALLO
Ameba AMEBA
Android ईमेल ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android पर मैसेज सेवा ANDROID_MMS
Android सिस्टम का शेयर डायलॉग ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
प्रतिक्रिया पाएं BLIND_REACT
Blogger BLOGGER
क्लिपबोर्ड पर कॉपी करें COPY_PASTE
Cyworld CYWORLD
Digg DIGG
सिस्टम ऐक्टिविटी का डायलॉग बॉक्स DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
क्यूआर कोड दिखाया गया DISPLAYED_QR_CODE
Dropbox DROPBOX
जोड़ें EMBED
ईमेल MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Facebook पेज FACEBOOK_PAGES
Facebook पर ग्रुप में शेयर करना FACEBOOK_SHARE_TO_GROUP
Facebook Stories FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google ऐप्लिकेशन GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
एचटीसी टेक्स्ट मैसेज HTC_MMS
आईएमओ IMO
Instagram INSTAGRAM
Instagram स्टोरीज़ INSTAGRAM_STORIES
न्योते का लिंक (Android) INVITE_LINK_ANDROID
न्योते का लिंक (iOS) INVITE_LINK_IOS
प्लेलिस्ट में वीडियो जोड़ने के लिए, अन्य क्रिएटर्स को न्योता भेजना INVITE_PLAYLIST_COLLABORATORS
iOS सिस्टम ऐक्टिविटी डायलॉग IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
KaiOS मैसेज KAIOS_MESSAGES
Kik KIK
LGE का ईमेल LGE_EMAIL
लाइन LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Maps में कॉपी/पेस्ट करना MAPS_COPY_PASTE
Meet की लाइव शेयरिंग की सुविधा MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
आस-पास शेयर करने की सुविधा NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
अन्य OTHER
Pinterest PINTEREST
क्विक शेयर QUICK_SHARE
क्विक शेयर (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
रीमिक्स REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
डिवाइस में मौजूद फ़ोटो के फ़ोल्डर में सेव करें SAVE_TO_DEVICE_PHOTOS
बिना विज्ञापन के शेयर करें SHARE_AD_FREE
Snapchat camera पर शेयर करें SHARE_TO_SNAPCHAT_CAMERA
बच्चों के साथ शेयर करें SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
मैसेज TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
अज्ञात UNKNOWN
Verizon messages VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
वेब सिस्टम ऐक्टिविटी डायलॉग WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! जापान YAHOO
YouTube कम्यूनिटी पोस्ट YOUTUBE_COMMUNITY_POST
YouTube कम्यूनिटी पर फिर से पोस्ट करना YOUTUBE_COMMUNITY_REPOST
आपके लिए, YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
YouTube Music से Snapchat preview पर शेयर करें YTM_SHARE_TO_SNAPCHAT_PREVIEW
YouTube Shorts में ग्रीन स्क्रीन की सुविधा YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
YouTube Watch with Friends YOUTUBE_WATCH_WITH_FRIENDS

ज़्यादा जानकारी के लिए, सहायता दस्तावेज़ देखें.

उदाहरण

नीचे दिए गए सैंपल अनुरोधों में, सोशल डाइमेंशन का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

    • सोशल: वीडियो शेयर करने की मेट्रिक. इन्हें उस सेवा के हिसाब से इकट्ठा किया जाता है जहां वीडियो शेयर किए गए थे

  • कॉन्टेंट के मालिक के उदाहरण

    • सोशल: वीडियो शेयर करने की मेट्रिक. इन्हें उस सेवा के हिसाब से इकट्ठा किया जाता है जहां वीडियो शेयर किए गए थे

दर्शक बनाए रखना

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

एपीआई, हर वीडियो के लिए 100 डेटा पॉइंट दिखाता है. इनकी वैल्यू 0.01 से 1.0 के बीच होती है. वीडियो चलने के दौरान, डेटा को मेज़र करने का समय हर वीडियो के लिए बराबर होता है. इसका मतलब है कि दो मिनट के वीडियो के लिए, डेटा पॉइंट के बीच का इंटरवल 1.2 सेकंड होता है. हालांकि, दो घंटे के वीडियो के लिए, डेटा पॉइंट के बीच का इंटरवल 72 सेकंड होता है. डाइमेंशन की वैल्यू से, इंटरवल खत्म होने के समय का पता चलता है.
audienceType (सिर्फ़ फ़िल्टर करने पर)
डाइमेंशन वैल्यू से, रिपोर्ट के डेटा से जुड़े ट्रैफ़िक के टाइप का पता चलता है. ORGANIC, AD_INSTREAM, और AD_INDISPLAY इस्तेमाल की जा सकने वाली वैल्यू हैं. ट्रैफ़िक सोर्स के इन टाइप के बारे में जानने के लिए, YouTube सहायता केंद्र पर जाएं.

ध्यान दें कि audienceType फ़िल्टर का डेटा, 25 सितंबर, 2013 से उपलब्ध है. एपीआई, उन क्वेरी का डेटा नहीं दिखाता है जो फ़िल्टर का इस्तेमाल करके, पुरानी तारीखों का डेटा वापस पाने की कोशिश करती हैं. फ़िल्टर का इस्तेमाल न करने वाली क्वेरी, 1 जुलाई, 2008 के बाद की किसी भी तारीख के लिए काम करती हैं.

उदाहरण

यहां दिए गए सैंपल अनुरोधों में, दर्शक बनाए रखने से जुड़े डाइमेंशन का इस्तेमाल किया गया है:

  • चैनल के उदाहरण

  • कॉन्टेंट के मालिक के उदाहरण

लाइव स्ट्रीमिंग

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

रद्द की गई सदस्यताएं

membershipsCancellationSurveyReason
रिपोर्टिंग अवधि के दौरान, YouTube के उन उपयोगकर्ताओं की संख्या जिन्होंने तय किए गए चैनल की सदस्यता रद्द करने के बाद, सर्वे पूरा किया. यहां दी गई टेबल में, डाइमेंशन की मान्य वैल्यू की सूची दी गई है:
एपीआई वैल्यू स्पष्टीकरण
UNKNOWN उपयोगकर्ता ने सर्वे पूरा नहीं किया.
DISLIKE_PERKS उपयोगकर्ता को पैसे चुकाकर ली गई सदस्यता के फ़ायदे पसंद नहीं आए.
PERKS_NOT_DELIVERED उपयोगकर्ता ने बताया कि उसे पैसे चुकाकर ली जाने वाली सदस्यता के वे फ़ायदे नहीं मिले जिनका वादा किया गया था.
CANNOT_ACCESS_PERKS उपयोगकर्ता को फ़ायदे ऐक्सेस करने में समस्या आ रही थी.
NO_LONGER_INTERESTED उपयोगकर्ता को अब पैसे चुकाकर ली जाने वाली सदस्यता में दिलचस्पी नहीं है.
FEEL_UNAPPRECIATED उपयोगकर्ता को लगा कि चैनल के सदस्य के तौर पर उसकी सराहना नहीं की गई.
FINANCIAL_REASONS उपयोगकर्ता ने वित्तीय वजहों से सदस्यता रद्द की.
JOIN_LIMITED_TIME उपयोगकर्ता को कुछ समय के लिए ही सदस्य बनना था.
OTHER उपयोगकर्ता ने सदस्यता रद्द करने की कोई और वजह बताई.

विज्ञापन प्रदर्शन

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

  • auctionBumperInstream – ये स्किप न किए जा सकने वाले वीडियो विज्ञापन छह सेकंड तक चलते हैं और इन्हें नीलामी के ज़रिए प्लेस किया जाता है. इनके खत्म होने के बाद ही, वीडियो देखा जा सकता है.

  • auctionDisplay – यह एक रिच मीडिया या इमेज वाला विज्ञापन होता है. यह वीडियो प्लेयर के सबसे निचले हिस्से पर ओवरले के तौर पर, वीडियो वॉच पेज पर 300x250 विज्ञापन यूनिट के तौर पर या दोनों के कॉम्बिनेशन के तौर पर दिखता है. ओवरले विज्ञापन, कुछ समय तक दिखने के बाद अपने-आप बंद हो जाता है. उपयोगकर्ता भी इसे बंद कर सकता है. अगर ओवरले और बैनर विज्ञापन एक साथ दिखाए जाते हैं, तो हर विज्ञापन को अलग इंप्रेशन के तौर पर गिना जाता है.

  • auctionInstream – स्किप न किए जा सकने वाले वीडियो विज्ञापन, जो मुख्य वीडियो से पहले, उसके बीच में या उसके बाद दिखते हैं.

  • auctionTrueviewInslate – दर्शक, वीडियो से पहले दिखाए गए कई वीडियो विज्ञापनों में से किसी एक को चुनता है. See the TrueView documentation for more information.

  • auctionTrueviewInstream – स्किप किए जा सकने वाले वीडियो विज्ञापन, जो मुख्य वीडियो से पहले या उसके दौरान चलते हैं. ज़्यादा जानकारी के लिए, TrueView दस्तावेज़ देखें.

  • auctionUnknown – ऐसा विज्ञापन जिसे AdWords नीलामी के ज़रिए खरीदा गया था, लेकिन उसे विज्ञापन के किसी अन्य टाइप में शामिल नहीं किया गया है.

  • reservedBumperInstream – ये स्किप न किए जा सकने वाले वीडियो विज्ञापन छह सेकंड तक चलते हैं और इन्हें रिज़र्वेशन के आधार पर बेचा जाता है. इन्हें वीडियो देखे जाने से पहले देखना ज़रूरी है.

  • reservedClickToPlay – ऐसा वीडियो विज्ञापन जिसे चलाने के लिए, उपयोगकर्ता को उस पर क्लिक करना पड़ता है. जब भी क्लिक-टू-प्ले विज्ञापन यूनिट दिखती है, तब एक विज्ञापन इंप्रेशन रिकॉर्ड किया जाता है. भले ही, उपयोगकर्ता ने वीडियो चलाना शुरू किया हो या नहीं. इन्हें रिज़र्वेशन के आधार पर बेचा जाता है.

  • reservedDisplay – यह एक रिच मीडिया या इमेज वाला विज्ञापन होता है. यह वीडियो प्लेयर के सबसे निचले हिस्से पर ओवरले के तौर पर, वीडियो वॉच पेज पर 300x250 विज्ञापन यूनिट के तौर पर या दोनों के कॉम्बिनेशन के तौर पर दिखता है. ओवरले विज्ञापन, कुछ समय तक दिखने के बाद अपने-आप बंद हो जाता है. उपयोगकर्ता भी इसे बंद कर सकता है. अगर ओवरले और बैनर विज्ञापन एक साथ दिखाए जाते हैं, तो हर विज्ञापन को अलग इंप्रेशन के तौर पर गिना जाता है.

  • reservedInstream – स्किप न किए जा सकने वाले वीडियो विज्ञापन, जो मुख्य वीडियो के पहले, उसके बीच में या उसके बाद दिखाए जाते हैं.

  • reservedInstreamSelect

  • reservedMasthead – यह एक बड़ा विज्ञापन होता है, जो होम पेज पर दिखता है. इसमें वीडियो और ग्राफ़िक एलिमेंट शामिल हो सकते हैं.

  • reservedUnknown – रिज़र्वेशन के आधार पर बेचा गया ऐसा विज्ञापन जिसे किसी अन्य विज्ञापन टाइप में शामिल नहीं किया जा सकता.

  • unknown – YouTube इस विज्ञापन का टाइप कैटगरी में नहीं बांट सका.

उदाहरण

यहां दिए गए सैंपल, विज्ञापन की परफ़ॉर्मेंस या रेवेन्यू मेट्रिक को वापस लाते हैं:

  • चैनल के उदाहरण

    • रेवेन्यू/विज्ञापन
      • चैनल के रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक
      • हर दिन के रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक
      • देश के हिसाब से रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक
      • सबसे ज़्यादा रेवेन्यू जनरेट करने वाले टॉप 10 वीडियो
      • अलग-अलग तरह के विज्ञापनों के लिए, विज्ञापन की परफ़ॉर्मेंस मेट्रिक

  • कॉन्टेंट के मालिक के उदाहरण

    • रेवेन्यू/विज्ञापन
      • दावा किए गए कॉन्टेंट के लिए रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक
      • हर दिन के रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक
      • देश के हिसाब से रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक
      • सबसे ज़्यादा रेवेन्यू जनरेट करने वाले टॉप 10 वीडियो
      • अलग-अलग तरह के विज्ञापनों के लिए, विज्ञापन की परफ़ॉर्मेंस मेट्रिक

कॉन्टेंट के मालिक के डाइमेंशन

ये डाइमेंशन, सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए काम करते हैं.

अहम जानकारी: कॉन्टेंट के मालिक की रिपोर्ट पाने के लिए किए जाने वाले एपीआई अनुरोधों में, इनमें से किसी एक डाइमेंशन का इस्तेमाल करके डेटा को फ़िल्टर करना ज़रूरी है:
  • video
  • channel
  • claimedStatus और uploaderType डाइमेंशन का ऐसा कॉम्बिनेशन जो इस्तेमाल किया जा सकता हो. इसके बारे में नीचे बताया गया है.
claimedStatus (सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट में इस्तेमाल किया जाता है)
इस डाइमेंशन की मदद से, यह बताया जा सकता है कि एपीआई से मिले जवाब में सिर्फ़ दावे वाले कॉन्टेंट की मेट्रिक शामिल होनी चाहिए. इस डाइमेंशन के लिए सिर्फ़ claimed वैल्यू मान्य है. अगर filters पैरामीटर, क्वेरी को claimedStatus==claimed तक सीमित करता है, तो एपीआई सिर्फ़ उस कॉन्टेंट का डेटा वापस लाएगा जिस पर दावा किया गया है. uploaderType डाइमेंशन की परिभाषा वाली टेबल में, इस डाइमेंशन को इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी दी गई है.
uploaderType (मुख्य डाइमेंशन) (सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट में इस्तेमाल किया जाता है)
इस डाइमेंशन से यह पता चलता है कि एपीआई से मिले जवाब में, कॉन्टेंट के मालिक के अपलोड किए गए कॉन्टेंट और/या तीसरे पक्षों के अपलोड किए गए कॉन्टेंट की मेट्रिक शामिल होनी चाहिए या नहीं. जैसे, उपयोगकर्ता के अपलोड किए गए वीडियो. self और thirdParty को वैल्यू के तौर पर इस्तेमाल किया जा सकता है. यह एक मुख्य डाइमेंशन है और इस पर समर्थन नहीं होने की नीति लागू होती है.

नीचे दी गई टेबल में, claimedStatus और uploaderType डाइमेंशन के लिए इस्तेमाल किए जा सकने वाले कॉम्बिनेशन दिखाए गए हैं. इन दोनों का इस्तेमाल, filters पैरामीटर में किया जाता है:

claimedStatus की कीमत का uploaderType की कीमत का ब्यौरा
[सेट नहीं है] खुद कॉन्टेंट के मालिक ने जो कॉन्टेंट अपलोड किया है उस पर दावा किया गया हो या नहीं, यह एपीआई उसके लिए YouTube Analytics का डेटा हासिल करता है.
दावा किया गया [सेट नहीं है] यह रिपोर्ट, कॉन्टेंट के मालिक या किसी तीसरे पक्ष के अपलोड किए गए ऐसे कॉन्टेंट का डेटा दिखाती है जिस पर दावा किया गया है.
दावा किया गया खुद कॉन्टेंट के मालिक ने जिस कॉन्टेंट पर दावा किया है उसका डेटा वापस लाता है.
दावा किया गया thirdParty तीसरे पक्ष के अपलोड किए गए ऐसे कॉन्टेंट का डेटा हासिल करता है जिस पर दावा किया गया है.

उदाहरण

कॉन्टेंट के मालिक की रिपोर्ट के लिए, सैंपल के तौर पर दिए गए कई एपीआई अनुरोधों में, डेटा को फ़िल्टर करने के लिए claimedStatus और uploaderType डाइमेंशन के साथ काम करने वाले कॉम्बिनेशन का इस्तेमाल किया जाता है.