इस दस्तावेज़ में, YouTube Analytics API और YouTube Reporting API की मदद से, YouTube Analytics में मौजूद डेटा को ऐक्सेस करने के तरीकों की समानताएं और अंतर के बारे में बताया गया है. इससे, आपको अपने ऐप्लिकेशन के लिए सही एपीआई चुनने में मदद मिलेगी.
दोनों एपीआई की मदद से, YouTube Analytics का डेटा वापस पाया जा सकता है. इसके अलावा, दोनों एपीआई, YouTube चैनल के मालिकों और YouTube कॉन्टेंट के मालिकों के साथ काम करते हैं. इनमें से हर कोई, रिपोर्ट का एक खास सेट ऐक्सेस कर सकता है:
-
चैनल रिपोर्ट में, किसी खास चैनल के लिए उपयोगकर्ता गतिविधि की मेट्रिक शामिल होती हैं.
-
कॉन्टेंट के मालिक के लिए रिपोर्ट में, किसी YouTube कॉन्टेंट के मालिक से जुड़े सभी चैनलों की मेट्रिक शामिल होती हैं. उदाहरण के लिए, कोई रिकॉर्ड लेबल, वह रिपोर्ट हासिल कर सकता है जिसमें लेबल के सभी कलाकारों के YouTube चैनलों के मिले-जुले आंकड़े शामिल हैं. कॉन्टेंट के मालिक की कुछ रिपोर्ट में, उपयोगकर्ता गतिविधि की मेट्रिक शामिल होती हैं. वहीं, दूसरी रिपोर्ट में रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक शामिल होती हैं.
Reporting API की मदद से, कुछ कॉन्टेंट मालिक, सिस्टम से मैनेज की जाने वाली विज्ञापन से होने वाली आय की रिपोर्ट भी ऐक्सेस कर सकते हैं. सिस्टम से मैनेज की जाने वाली रिपोर्ट का डेटा, सिर्फ़ Reporting API की मदद से वापस पाया जा सकता है.
YouTube Analytics और YouTube Reporting API के सभी अनुरोधों को, उस चैनल या कॉन्टेंट के मालिक की अनुमति लेनी होगी जिसके पास अनुरोध किया गया डेटा है.
कॉन्टेंट की शिकायत करना
एपीआई से मिली रिपोर्ट में दो तरह का डेटा होता है:
-
डाइमेंशन, डेटा इकट्ठा करने के लिए इस्तेमाल की जाने वाली सामान्य शर्तें होती हैं. जैसे, उपयोगकर्ता गतिविधि की तारीख या वह देश जहां उपयोगकर्ता मौजूद थे.
किसी रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का यूनीक कॉम्बिनेशन होता है. इसलिए, हर लाइन की डाइमेंशन वैल्यू का कॉम्बिनेशन, उस लाइन की प्राइमरी की तरह काम करता है.
-
मेट्रिक, उपयोगकर्ता गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित रेवेन्यू के अलग-अलग मेज़रमेंट होते हैं. उपयोगकर्ता गतिविधि की मेट्रिक में, वीडियो के व्यू की संख्या और रेटिंग (पसंद और नापसंद) जैसी चीज़ें शामिल होती हैं.
अपने ऐप्लिकेशन के लिए सही एपीआई चुनना
- YouTube Analytics API
- YouTube Analytics API में रीयल-टाइम में टारगेट की गई क्वेरी मौजूद होती हैं, जिससे YouTube Analytics की कस्टम रिपोर्ट जनरेट की जा सकती हैं. एपीआई, फ़िल्टर करने और क्रम से लगाने के पैरामीटर उपलब्ध कराता है. इसलिए, कॉल करने वाले ऐप्लिकेशन को इन फ़ंक्शन के साथ काम करने की ज़रूरत नहीं होती.
हर एपीआई अनुरोध में, तारीख की वह सीमा तय होती है जिसके लिए डेटा दिखाया जाएगा. इस एपीआई की मदद से, हर हफ़्ते और महीने का डेटा सेट भी वापस पाया जा सकता है. इसलिए, कॉल करने वाले ऐप्लिकेशन को, वापस लाए गए डेटा सेट को सेव करने या तारीख की सीमाओं के हिसाब से आंकड़ों को इकट्ठा करने की ज़रूरत नहीं होती. - YouTube Reporting API
- YouTube Reporting API, बल्क रिपोर्ट से डेटा लेता है. इन रिपोर्ट में, YouTube Analytics में मौजूद, कॉन्टेंट के मालिक या चैनल की परफ़ॉर्मेंस से जुड़ा डेटा मौजूद होता है. इसे उन ऐप्लिकेशन के लिए डिज़ाइन किया गया है जो बड़े डेटा सेट इंपोर्ट कर सकते हैं. साथ ही, इन ऐप्लिकेशन में डेटा को फ़िल्टर करने, क्रम से लगाने, और उसकी जांच करने के लिए टूल भी होते हैं.
हर रिपोर्ट में फ़ील्ड का एक सेट पहले से मौजूद होता है. रिपोर्टिंग जॉब शेड्यूल करने के लिए, एपीआई का इस्तेमाल किया जाता है. हर रिपोर्ट में, YouTube को जनरेट करनी वाली रिपोर्ट की पहचान की जाती है. इसके बाद, YouTube हर दिन एक रिपोर्ट जनरेट करता है. इसे अलग-अलग समय पर डाउनलोड किया जा सकता है. हर रिपोर्ट में 24 घंटे की किसी खास अवधि का डेटा होता है.
इसके अलावा, YouTube उन कॉन्टेंट के मालिकों के लिए, सिस्टम से मैनेज की जाने वाली रिपोर्ट का एक सेट अपने-आप जनरेट करता है जिनके पास YouTube Creator Studio में इन रिपोर्ट का ऐक्सेस है. ये रिपोर्ट, विज्ञापन से होने वाली आय के डेटा का प्रोग्रामैटिक ऐक्सेस देती हैं.
काम करने वाली रिपोर्ट
नीचे दी गई टेबल में, अलग-अलग तरह की रिपोर्ट के बारे में बताया गया है. इन्हें एपीआई का इस्तेमाल करके वापस पाया जा सकता है. टारगेट की गई क्वेरी, YouTube Analytics API का इस्तेमाल करके देखी जा सकती हैं. साथ ही, YouTube Reporting API का इस्तेमाल करके एक साथ कई रिपोर्ट देखी जा सकती हैं.
ऐसा हो सकता है कि एक एपीआई में उपलब्ध डेटा, दूसरे एपीआई में उपलब्ध न हो. उदाहरण के लिए, YouTube Analytics API की मदद से, हर हफ़्ते या महीने के हिसाब से उपयोगकर्ता गतिविधि की मेट्रिक हासिल की जा सकती हैं. हालांकि, YouTube Reporting API की मदद से, आपको खुद ही उस डेटा को इकट्ठा करना होगा. दूसरी ओर, YouTube Reporting API, कॉन्टेंट के मालिकों के लिए एसेट रिपोर्ट की सुविधा देता है. हालांकि, यह डेटा YouTube Analytics API से उपलब्ध नहीं होता.
रिपोर्ट प्रकार | |
---|---|
वीडियो रिपोर्ट | यह चैनलों (क्वेरी या एक साथ कई) और कॉन्टेंट के मालिकों (क्वेरी या एक साथ कई) के लिए काम करता है. वीडियो की रिपोर्ट में, चैनल के वीडियो या कॉन्टेंट के मालिक के वीडियो से जुड़ी उपयोगकर्ता गतिविधि के आंकड़े मिलते हैं. उदाहरण के लिए, इन रिपोर्ट में आपके वीडियो पर मिले व्यू की संख्या शामिल होती है. YouTube Analytics API में, कॉन्टेंट के मालिक की कुछ वीडियो रिपोर्ट में अनुमानित रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस की मेट्रिक भी शामिल होती हैं. |
प्लेलिस्ट की रिपोर्ट | यह चैनलों (क्वेरी या एक साथ कई) और कॉन्टेंट के मालिकों (क्वेरी या एक साथ कई) के लिए काम करता है. प्लेलिस्ट की रिपोर्ट में, खास तौर पर प्लेलिस्ट में मौजूद वीडियो के व्यू से जुड़े आंकड़े मिलते हैं. YouTube Reporting API, प्लेलिस्ट के लिए दर्शक बनाए रखने की रिपोर्ट दिखाता है. हालांकि, YouTube Analytics API ऐसी रिपोर्ट नहीं दिखाता. |
विज्ञापन परफ़ॉर्मेंस रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (क्वेरी या एक साथ कई). विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, वीडियो चलाने के दौरान दिखने वाले विज्ञापनों के लिए इंप्रेशन पर आधारित मेट्रिक मिलती हैं. इन मेट्रिक में हर विज्ञापन इंप्रेशन की गिनती की जाती है. साथ ही, हर वीडियो प्लेबैक से कई इंप्रेशन मिल सकते हैं. |
अनुमानित रेवेन्यू की रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (एक साथ कई). अनुमानित रेवेन्यू की रिपोर्ट में, Google के बेचे गए विज्ञापन स्रोतों और विज्ञापन के अलावा अन्य स्रोतों से, वीडियो से मिलने वाले कुल अनुमानित रेवेन्यू की जानकारी मिलती है. इन रिपोर्ट में विज्ञापन की परफ़ॉर्मेंस से जुड़ी कुछ मेट्रिक भी शामिल होती हैं. ध्यान दें कि सिस्टम से मैनेज की जाने वाली रिपोर्ट में असल आय शामिल होती है. |
ऐसेट रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (एक साथ कई). ऐसेट रिपोर्ट से, कॉन्टेंट के मालिक की ऐसेट से जुड़े वीडियो से जुड़ी उपयोगकर्ता गतिविधि की मेट्रिक मिलती हैं. किसी वीडियो को कॉन्टेंट के मालिक की रिपोर्ट में तब शामिल किया जाता है, जब कॉन्टेंट के मालिक ने उस वीडियो पर दावा किया हो कि वह उसकी किसी ऐसेट से मेल खाता है. वीडियो को कॉन्टेंट के मालिक या किसी दूसरे YouTube उपयोगकर्ता ने अपलोड किया हो सकता है. |
सिस्टम से मैनेज की जाने वाली रिपोर्ट | यह सुविधा उन कॉन्टेंट के मालिकों के लिए उपलब्ध है जिनके पास YouTube के Creator Studio के रिपोर्ट मेन्यू में, उससे जुड़ी रिपोर्ट का ऐक्सेस है. सिस्टम से मैनेज की जाने वाली रिपोर्ट, ऐसेट और वीडियो से होने वाली आय का असल डेटा देती हैं. एक अन्य रिपोर्ट में, दावा किए गए वीडियो और उनसे मैच होने वाली ऐसेट की सूची होती है. Creator Studio की सभी रिपोर्ट, एपीआई में उपलब्ध नहीं हैं. ध्यान दें: YouTube, कॉन्टेंट के मालिकों के लिए सिस्टम से मैनेज की जाने वाली रिपोर्ट अपने-आप जनरेट करता है. हालांकि, इसके लिए ज़रूरी है कि उनके पास Creator Studio में इन रिपोर्ट का ऐक्सेस हो. इस वजह से, इन रिपोर्ट को वापस पाने की प्रोसेस, इस सूची में मौजूद दूसरी तरह की रिपोर्ट से अलग है. ज़्यादा जानकारी के लिए, सिस्टम से मैनेज की जाने वाली रिपोर्ट के दस्तावेज़ देखें. |
मुख्य अंतर
यहां दी गई टेबल में, YouTube Analytics और Reporting API के बीच के अहम अंतर को हाइलाइट किया गया है.
सुविधा | YouTube Analytics API | YouTube Reporting API |
---|---|---|
डेटा वापस पाने की प्रोसेस | हर एपीआई अनुरोध में, दिखाए जाने वाले डाइमेंशन और मेट्रिक के साथ-साथ वह समयावधि भी तय की जाती है जिसके लिए डेटा दिखाया जाएगा. | ऐप्लिकेशन, रिपोर्टिंग जॉब शेड्यूल करते हैं. हर जॉब के लिए, YouTube हर दिन रिपोर्ट जनरेट करता है. इन्हें अलग-अलग समय पर डाउनलोड किया जा सकता है. |
तारीख सीमाएं | कुछ एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि की तारीख की जानकारी होती है. इनमें से कुछ रिपोर्ट में डाइमेंशन की सुविधा होती है, ताकि उपयोगकर्ता गतिविधि की मेट्रिक को महीने के हिसाब से इकट्ठा किया जा सके. | सभी एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि होने की तारीख की जानकारी होती है. एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन, समय-समय पर डेटा इकट्ठा करने की सुविधाएं लागू कर सकते हैं. |
डेटा फ़िल्टर करना | रिपोर्ट को फ़िल्टर करके, सिर्फ़ उन लाइनों को शामिल किया जा सकता है जिनके लिए डाइमेंशन की कोई खास वैल्यू है. एपीआई में कुछ ऐसे डाइमेंशन भी काम करते हैं जिनका इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जाता है. जैसे, continent और subContinent. | एपीआई की मदद से, पूरे डेटा सेट को एक साथ डाउनलोड किया जा सकता है. यह सिर्फ़ फ़िल्टर वाले डाइमेंशन के लिए, फ़िल्टर करने या डेटा दिखाने की सुविधा नहीं देता. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को सेव करता है और डेटा को फ़िल्टर करने के लिए अपनी सुविधाएं लागू करता है. |
क्रम से लगाना | रिपोर्ट को, मेट्रिक की रिटर्न की गई वैल्यू के आधार पर क्रम में लगाया जा सकता है. कुछ रिपोर्ट में सिर्फ़ सीमित संख्या में नतीजे दिखते हैं. उदाहरण के लिए, चैनल के सबसे ज़्यादा देखे गए वीडियो की सूची वाली रिपोर्ट में, ज़्यादा से ज़्यादा 200 लाइनें दिखती हैं. | इस एपीआई की मदद से, पूरे डेटा सेट को एक साथ डाउनलोड किया जा सकता है. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को क्रम से लगाने के लिए, अपनी सुविधाएं लागू कर सकते हैं. |
एनुमरेशन | एपीआई रिपोर्ट में टेक्स्ट वैल्यू होती हैं, जैसे कि "ANDROID" या "CHANNEL". इनकी मदद से, एनोटेट किए गए डाइमेंशन की वैल्यू की पहचान की जाती है. | एपीआई रिपोर्ट में पूर्णांक होते हैं, जिन्हें टेक्स्ट वैल्यू पर मैप किया जा सकता है. |
अनुरोध भेजने की तय सीमा | एपीआई सर्वर, कोटा की लागत तय करने के लिए हर क्वेरी का आकलन करता है. कोटा के इस्तेमाल सेक्शन में, इस तरीके के बारे में ज़्यादा जानकारी दी गई है. | कोटा के इस्तेमाल से कोई समस्या नहीं होती, क्योंकि डेटा को एक बार फिर से ऐप्लिकेशन में फ़िल्टर, क्रम से लगाया जाता है, और उस पर क्वेरी की जाती है. |
यूनीक रिपोर्ट |
|
|
यूनीक डाइमेंशन | group (सिर्फ़ फ़िल्टर के लिए डाइमेंशन) continent (सिर्फ़ फ़िल्टर के लिए डाइमेंशन) subContinent (सिर्फ़ फ़िल्टर के लिए डाइमेंशन) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
यूनीक मेट्रिक | यूनीक दर्शक relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
एपीआई के नामों में अंतर
डाइमेंशन और मेट्रिक की पहचान करने के लिए, दोनों एपीआई नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. YouTube Analytics API के नामों में कैमेल केस का इस्तेमाल किया जाता है, जैसे कि adType
. YouTube Reporting API के नाम छोटे अक्षरों में होते हैं और इनमें अंडरस्कोर का इस्तेमाल किया जाता है, जैसे कि ad_type
.
यहां दी गई टेबल में, उन अलग-अलग नामों की जानकारी दी गई है जिनका इस्तेमाल दोनों एपीआई, एक ही मेट्रिक और डाइमेंशन की पहचान करने के लिए करते हैं. कुछ मामलों में, दोनों नामों के बीच का अंतर, किसी नाम को कैमेल केस से अंडरस्कोर में बदलने के बाद मिलने वाले अंतर से ज़्यादा होता है. उदाहरण के लिए, YouTube Analytics API में video
डाइमेंशन को YouTube Reporting API में video_id
कहा जाता है.