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

कॉन्टेंट के मालिक की रिपोर्ट में, channel डाइमेंशन का अक्सर इस्तेमाल किया जाता है, क्योंकि आम तौर पर इन रिपोर्ट में कई चैनलों का डेटा इकट्ठा होता है.
ग्रुप (सिर्फ़ फ़िल्टर)
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 देश कोड होते हैं. यह अमेरिका के अलावा, किसी भी अन्य देश के सबग्रुप में उपलब्ध नहीं है.

city
रिपोर्ट की लाइन में मौजूद मेट्रिक से जुड़ा अनुमानित शहर. इस डाइमेंशन के लिए 1 जनवरी, 2022 से डेटा उपलब्ध है.
महाद्वीप (सिर्फ़ फ़िल्टर)
संयुक्त राष्ट्र (UN) का सांख्यिकीय क्षेत्र का कोड. एपीआई में ये वैल्यू इस्तेमाल की जा सकती हैं:
वैल्यू
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:00 बजे (यूटीसी-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 क्लाइंट पर मिले व्यू की जानकारी देता है. इसमें मोबाइल डिवाइस भी शामिल हैं.

    YouTube Analytics की रिपोर्ट में, 10 सितंबर, 2013 से, वीडियो को 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) में नहीं हुई थी. अपवाद: YouTube Music में 1 मार्च, 2021 से पहले हुई उपयोगकर्ता गतिविधि को 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 पर खोज नतीजों से मिलने वाले रेफ़रल शामिल होते हैं.
  • HASHTAGS – यह व्यू, वीओडी (वीडियो ऑन डिमांड) हैशटैग पेजों या शॉर्ट वीडियो वाले हैशटैग पिवट पेजों से मिला.
  • LIVE_REDIRECT - वीडियो पर मिले व्यू, लाइव रीडायरेक्ट की मदद से मिले हैं.
  • NO_LINK_EMBEDDED – वीडियो देखते समय, उसे किसी दूसरी वेबसाइट पर एम्बेड कर दिया गया था.
  • NO_LINK_OTHER – YouTube को ट्रैफ़िक के लिए, रेफ़रर की पहचान नहीं मिली. इस कैटगरी में, किसी वीडियो पर आने वाले डायरेक्ट ट्रैफ़िक के साथ-साथ, मोबाइल ऐप्लिकेशन पर आने वाला ट्रैफ़िक भी शामिल होता है.
  • NOTIFICATION – वीडियो पर मिले व्यू, YouTube से मिले ईमेल या सूचना के ज़रिए मिले हैं.
  • PLAYLIST – जब वीडियो को प्लेलिस्ट के तौर पर चलाया जा रहा था, तब उस पर व्यू मिले. इसमें प्लेलिस्ट वाले पेज से आने वाला ट्रैफ़िक भी शामिल होता है.
  • PRODUCT_PAGE - वीडियो व्यू, प्रॉडक्ट पेज से रेफ़र किए गए.
  • PROMOTED – वीडियो पर मिले व्यू, YouTube के एक मुफ़्त प्रमोशन से मिले थे. जैसे, YouTube "Spotlight वीडियो" पेज.
  • RELATED_VIDEO – वीडियो पर मिले व्यू, किसी दूसरे वीडियो के वॉच पेज पर मौजूद मिलती-जुलती वीडियो लिस्टिंग से मिले. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर लगाया जाता है, तो insightTrafficSourceDetail फ़ील्ड उस वीडियो का वीडियो आईडी बताता है.
  • SHORTS – शॉर्ट वीडियो देखने के दौरान, पिछले वीडियो को वर्टिकल स्वाइप करने की वजह से दर्शक को रेफ़र किया गया.
  • SOUND_PAGE – Shorts के साउंड पिवट पेजों से मिले व्यू.
  • SUBSCRIBER – वीडियो व्यू, YouTube होम पेज पर मौजूद फ़ीड या YouTube की सदस्यता सुविधाओं के ज़रिए रेफ़र किए गए थे. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड में होम पेज के फ़ीड आइटम या ऐसे अन्य पेज दिखते हैं जिनसे व्यू रेफ़र किए गए थे.
  • YT_CHANNEL – वीडियो को किसी चैनल पेज पर देखा गया. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड उस चैनल के चैनल आईडी की जानकारी देता है.
  • YT_OTHER_PAGE – वीडियो व्यू, YouTube पेज पर दिखाए गए खोज के नतीजे या मिलते-जुलते वीडियो लिंक के बजाय किसी अन्य लिंक से रेफ़र किए गए. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड से पेज की पहचान होती है.
  • YT_SEARCH – वीडियो पर मिले व्यू, YouTube के खोज नतीजों से रेफ़र किए गए हैं. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड, खोज के लिए इस्तेमाल हुए शब्द के बारे में बताता है.
  • VIDEO_REMIXES – वीडियो पर मिले व्यू, Shorts प्लेयर में रीमिक्स किए गए वीडियो के लिंक से आए हैं. अगर इस ट्रैफ़िक सोर्स के हिसाब से फ़िल्टर किया जाता है, तो insightTrafficSourceDetail फ़ील्ड उस वीडियो के बारे में बताता है जिससे दर्शक को रेफ़र किया गया है.
insightTrafficSourceDetail
रिपोर्ट में डेटा, उन रेफ़रर के आधार पर इकट्ठा किया जाता है जिनसे किसी वीडियो और किसी खास तरह के ट्रैफ़िक सोर्स के लिए सबसे ज़्यादा व्यू जनरेट हुए. नीचे दी गई सूची उन ट्रैफ़िक सोर्स की पहचान करती है जिनके लिए यह रिपोर्ट उपलब्ध है. हर ट्रैफ़िक सोर्स के लिए, इस सूची से उस जानकारी की पहचान होती है जो insightTrafficSourceDetail डाइमेंशन से मिलती है.
  • ADVERTISING – विज्ञापन का वह टाइप जिसकी वजह से वीडियो देखे गए. आपको ये वैल्यू दिख सकती हैं:
    • क्लिक-टू-प्ले सहभागिता विज्ञापन
    • सहभागिता विज्ञापन
    • Google सर्च विज्ञापन
    • मुख्यपृष्ठ वीडियो विज्ञापन
    • स्किप किया जा सकने वाला रिज़र्व किया गया इन-स्ट्रीम विज्ञापन
    • 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
  • 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 (मुख्य डाइमेंशन)
यह डाइमेंशन, रिपोर्ट डेटा से जुड़े लॉग-इन किए हुए उपयोगकर्ताओं के उम्र समूह की पहचान करता है. एपीआई इन उम्र समूहों का इस्तेमाल करता है:
  • 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.
लिंग (मुख्य डाइमेंशन)
यह डाइमेंशन, रिपोर्ट के डेटा से जुड़े लॉग-इन किए हुए उपयोगकर्ताओं के लिंग की पहचान करता है. मान्य वैल्यू 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 ईमेल ANDROID_EMAIL
Android मैसेंजर ANDROID_MESSENGER
Android की मैसेज सेवा ANDROID_MMS
BlackBerry मैसेंजर BBM
Blogger BLOGGER
क्‍लिपबोर्ड पर कॉपी करें COPY_PASTE
सायवर्ल्ड CYWORLD
डिग DIGG
Dropbox DROPBOX
जोड़ें EMBED
ईमेल MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook के पेज FACEBOOK_PAGES
फ़ोटका FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
एसएमएस पर जाएं GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC मैसेज HTC_MMS
Google इनबॉक्स INBOX
iOS की सिस्टम गतिविधि वाला डायलॉग बॉक्स IOS_SYSTEM_ACTIVITY_DIALOG
काकाओ की कहानी KAKAO_STORY
काकाओ (काकाओ टॉक) KAKAO
Kik KIK
LGE ईमेल LGE_EMAIL
लाइन LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
मेनेम MENEAME
mixi MIXI
Motorola मैसेज सेवा MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
आस-पास शेयर करने की सुविधा NEARBY_SHARE
NUjij NUJIJ
ऑडनोक्लास्निकी (ओ जाएँगेनियोक्ला कंगावटी) ODNOKLASSNIKI
अन्य OTHER
Pinterest PINTEREST
रकुतेन (楽天場) RAKUTEN
Reddit REDDIT
Skype SKYPE
स्काईरॉक SKYBLOG
Sony बातचीत SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
मैसेज TEXT_MESSAGE
टुएंटी TUENTI
tumblr. TUMBLR
Twitter TWITTER
जानकारी नहीं है UNKNOWN
Verizon के मैसेज VERIZON_MMS
Viber VIBER
VKontakte ({4}Коñтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
वाइकोप WYKOP
Yahoo! जापान YAHOO
आपके लिए, YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

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

उदाहरण

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

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

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

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

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

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

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 के बाद की किसी भी तारीख के लिए फ़िल्टर का इस्तेमाल नहीं करती हैं.

उदाहरण

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

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

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

विज्ञापन की परफ़ॉर्मेंस

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 – हम इस विज्ञापन प्रकार को वर्गीकृत नहीं कर सके.

उदाहरण

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

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

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

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

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

प्लेलिस्ट

isCurated (सिर्फ़ फ़िल्टर)
इस फ़िल्टर से पता चलता है कि अनुरोध, प्लेलिस्ट में वीडियो पर मिले व्यू का डेटा हासिल कर रहा है.

उदाहरण

प्लेलिस्ट की रिपोर्ट पाने वाले सभी सैंपल अनुरोध, isCurated फ़िल्टर का इस्तेमाल करते हैं.

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

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

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

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

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

उदाहरण

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