Dimensions

इस दस्तावेज़ में उन डाइमेंशन के बारे में बताया गया है जिनका इस्तेमाल YouTube Analytics API करता है. इस 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 को शामिल करके, डेटा को सिर्फ़ अमेरिका तक सीमित करना होगा.

ध्यान दें: यह डाइमेंशन, आईएसओ 3166-2 के उन वैल्यू के साथ काम नहीं करता है जो अमेरिका के दूर-दराज के इलाकों की पहचान करती हैं. ऐसा इसलिए, क्योंकि उन इलाकों के अपने आईएसओ 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 फ़ॉर्मैट में दिखती हैं.

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

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

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

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

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

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

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

  • 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) में नहीं हुई है. अपवाद: 1 मार्च, 2021 से पहले YouTube Music में की गई उपयोगकर्ता गतिविधि को CORE में शामिल किया जाता है.
GAMING उपयोगकर्ता की गतिविधि YouTube Gaming में हुई.
KIDS उपयोगकर्ता की गतिविधि YouTube Kids में हुई हो.
MUSIC उपयोगकर्ता ने YouTube Music पर 1 मार्च, 2021 को या इसके बाद गतिविधि की हो. CORE में 1 मार्च, 2021 से पहले का डेटा शामिल है. रीयल-टाइम डेटा रिकॉर्ड नहीं किया जाता.
UNKNOWN उपयोगकर्ता की गतिविधि 18 जुलाई, 2015 से पहले हुई हो.

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

insightTrafficSourceType
रिपोर्ट में मौजूद डेटा को रेफ़रर टाइप के आधार पर इकट्ठा किया जाता है. इससे पता चलता है कि उपयोगकर्ता वीडियो तक कैसे पहुंचे. इस डाइमेंशन के लिए ये वैल्यू इस्तेमाल की जा सकती हैं:
  • ADVERTISING – दर्शक को विज्ञापन के ज़रिए वीडियो पर रीडायरेक्ट किया गया था. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से विज्ञापन के टाइप की पहचान होती है.
  • ANNOTATION – दर्शकों ने किसी दूसरे वीडियो में मौजूद एनोटेशन पर क्लिक करके, वीडियो देखा.
  • CAMPAIGN_CARD – ये व्यू, उपयोगकर्ता के अपलोड किए गए उन वीडियो से मिले हैं जिन पर दावा किया गया है. कॉन्टेंट के मालिक ने इन वीडियो का इस्तेमाल, देखे गए कॉन्टेंट का प्रमोशन करने के लिए किया था. यह ट्रैफ़िक सोर्स, सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए काम करता है.
  • END_SCREEN – व्यू, किसी दूसरे वीडियो की एंड स्क्रीन से मिले हैं.
  • EXT_URL – वीडियो को मिले व्यू, किसी दूसरी वेबसाइट पर मौजूद लिंक से मिले हैं. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से वेब पेज की पहचान होती है. इस ट्रैफ़िक सोर्स में, Google Search के नतीजों से मिले रेफ़रल शामिल होते हैं.
  • 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 फ़ील्ड में उस वीडियो की जानकारी दिखती है जिससे दर्शक को रेफ़र किया गया था.
insightTrafficSourceDetail
रिपोर्ट में मौजूद डेटा को, रेफ़रर के आधार पर एग्रीगेट किया जाता है. ये रेफ़रर, किसी वीडियो और किसी ट्रैफ़िक सोर्स टाइप के लिए सबसे ज़्यादा व्यू जनरेट करते हैं. यहां दी गई सूची में, उन ट्रैफ़िक सोर्स की जानकारी दी गई है जिनके लिए यह रिपोर्ट उपलब्ध है. हर ट्रैफ़िक सोर्स के लिए, सूची में यह जानकारी दी गई है कि insightTrafficSourceDetail डाइमेंशन कौनसी जानकारी देता है.
  • ADVERTISING – विज्ञापन का वह टाइप जिसकी वजह से व्यू मिले. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • क्लिक-टू-प्ले वाला यूज़र ऐक्टिविटी बढ़ाने में मदद करने वाला विज्ञापन
    • सहभागिता विज्ञापन
    • Google Search Network में दिखने वाले विज्ञापन
    • मुख्यपृष्ठ वीडियो विज्ञापन
    • स्किप किए जा सकने वाले इन-स्ट्रीम विज्ञापन के लिए रिज़र्व की गई इन्वेंट्री
    • 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 – वह वीडियो जिसकी वजह से व्यू मिले.

उदाहरण

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

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

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

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

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

डिवाइस

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 Analytics रिपोर्ट में डेमोग्राफ़िक डेटा के बारे में ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.

ageGroup (कोर डाइमेंशन)
इस डाइमेंशन से, रिपोर्ट के डेटा से जुड़े उन उपयोगकर्ताओं के उम्र समूह की पहचान होती है जिन्होंने लॉगिन किया है. एपीआई इन उम्र समूहों का इस्तेमाल करता है:
  • 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.

यहां दी गई टेबल में, डाइमेंशन की मान्य वैल्यू दी गई हैं:
शेयर करने की सेवा एपीआई वैल्यू
Ameba AMEBA
Android Email ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android पर मैसेज भेजने की सुविधा ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
क्लिपबोर्ड पर कॉपी करें COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
जोड़ें EMBED
ईमेल MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook पेज FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC से मिला मैसेज HTC_MMS
Google Inbox INBOX
iOS सिस्टम ऐक्टिविटी डायलॉग IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE ईमेल LGE_EMAIL
लाइन LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
आस-पास शेयर करने की सुविधा NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
अन्य OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
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
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! जापान YAHOO
आपके लिए, YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

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

उदाहरण

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

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

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

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

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

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

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

API, हर वीडियो के लिए 100 डेटा पॉइंट दिखाता है. इनकी अनुपात वैल्यू, 0.01 से लेकर 1.0 तक होती है. वीडियो चलाने के दौरान, डेटा को एक ही समय पर मेज़र किया जाता है. इसका मतलब है कि दो मिनट के वीडियो के लिए, डेटा पॉइंट के बीच का अंतराल 1.2 सेकंड है. हालांकि, दो घंटे के वीडियो के लिए, डेटा पॉइंट के बीच का इंटरवल 72 सेकंड होता है. डाइमेंशन की वैल्यू, इंटरवल के खत्म होने का समय दिखाती है.
audienceType (filter only)
डाइमेंशन वैल्यू से, रिपोर्ट के डेटा से जुड़े ट्रैफ़िक के टाइप की पहचान होती है. 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 डाइमेंशन के काम करने वाले कॉम्बिनेशन का इस्तेमाल किया जाता है.