Dimensions

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

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

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

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

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

जब YouTube Analytics API, सेवा की शर्तें, नॉन-कोर डाइमेंशन (और नॉन-कोर मेट्रिक) नीति के तहत आता है. इस पेज की परिभाषाओं में, कोर डाइमेंशन कोर डाइमेंशन साफ़ तौर पर बताया गया हो.

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

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

फ़िल्टर

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

क्वेरी रिपोर्ट को फिर से पाने के अनुरोध में, वैकल्पिक 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 देश कोड भी हैं. यह अमेरिका के अलावा, अन्य देशों के सबडिविज़न में भी शामिल नहीं होती.

dma
3 अंकों वाला ऐसा आइडेंटिफ़ायर जिसका इस्तेमाल Nielsen, खास तौर पर बनाए गए बाज़ार (डीएमए) की पहचान करने के लिए करता है डेटा लाइन में बताए गए, व्यू इवेंट से जुड़ा होता है.
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.
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 के Android ऐप्लिकेशन जैसे किसी आधिकारिक YouTube ऐप्लिकेशन से मिले व्यू की जानकारी देता है.

  • YT_OTHER – यह डेटा, उन व्यू की जानकारी देता है जिन्हें किसी अन्य कैटगरी में नहीं रखा जाता.

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

उदाहरण

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

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

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

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

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

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

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

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

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

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

यहां दी गई टेबल में डाइमेंशन की वैल्यू की सूची दी गई है:
वैल्यू
CORE उपयोगकर्ता की ऐसी गतिविधि जो किसी खास YouTube ऐप्लिकेशन (YouTube Gaming, YouTube Kids या YouTube Music) में नहीं की गई है. अपवाद: YouTube Music में 1 मार्च, 2021 से पहले की गई उपयोगकर्ता की गतिविधि को CORE में शामिल किया जाता है.
GAMING YouTube Gaming में हुई उपयोगकर्ता गतिविधि.
KIDS YouTube Kids में उपयोगकर्ता की गतिविधि हुई.
MUSIC 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 "Spotlight वीडियो" पेज.
  • RELATED_VIDEO – वीडियो पर मिले व्यू, किसी दूसरे वीडियो के वॉच पेज पर मौजूद मिलती-जुलती वीडियो लिस्टिंग से मिले. इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर करने पर, insightTrafficSourceDetail फ़ील्ड उस वीडियो के लिए वीडियो आईडी की जानकारी देता है.
  • 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
  • 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 ईमेल 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
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
Skyrock SKYBLOG
Sony के साथ बातचीत SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
मैसेज TEXT_MESSAGE
Tuenti TUENTI
Tumblr. TUMBLR
Twitter TWITTER
अज्ञात UNKNOWN
Verizon मैसेज VERIZON_MMS
Viber VIBER
VKontakte (VATонтакте) 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 प्रतिशत हिस्सा खत्म हो जाने के बाद, उससे जुड़ी रिपोर्ट का डेटा, निजी डेटा के रखरखाव का डेटा दिखाता है.

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

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

उदाहरण

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

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

उदाहरण

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

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

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

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

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

प्लेलिस्ट

isCurated (सिर्फ़ फ़िल्टर के लिए)
यह फ़िल्टर बताता है कि अनुरोध में उन वीडियो व्यू का डेटा हासिल किया जा रहा है जो प्लेलिस्ट के संदर्भ को शामिल करता है.

उदाहरण

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

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

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

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

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

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

उदाहरण

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