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

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

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 का इस्तेमाल करने वाले ऐप्लिकेशन में चलाए गए वीडियो, इस वैल्यू का इस्तेमाल करके कैटगरी में बांटे जाएंगे.

  • 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 – शॉर्ट वीडियो पर मिले व्यू, रीमिक्स किए गए वीडियो के लिंक से मिले हैं. अगर इस ट्रैफ़िक सोर्स के हिसाब से फ़िल्टर किया जाता है, तो 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 – 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 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
ओडनोक्लास्निकी (Oдноклассники) 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 (सिर्फ़ फ़िल्टर के लिए)
इस फ़िल्टर से पता चलता है कि अनुरोध, प्लेलिस्ट में वीडियो को मिले व्यू का डेटा हासिल कर रहा है. यह फ़िल्टर किसी भी प्लेलिस्ट रिपोर्ट के लिए ज़रूरी है और इसकी वैल्यू 1 पर सेट होनी चाहिए.

उदाहरण

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

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

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

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

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

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

उदाहरण

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