इस दस्तावेज़ में, YouTube Analytics API और YouTube Reporting API के ज़रिए YouTube Analytics के डेटा को ऐक्सेस करने के तरीकों के बीच की समानताओं और अंतरों के बारे में बताया गया है. इससे आपको अपने ऐप्लिकेशन के लिए सही एपीआई चुनने में मदद मिलेगी.
इन दोनों एपीआई की मदद से, YouTube Analytics का डेटा वापस पाया जा सकता है. इसके अलावा, दोनों एपीआई, YouTube चैनल के मालिकों और YouTube कॉन्टेंट के मालिकों के साथ काम करते हैं. इनमें से हर कोई, रिपोर्ट के किसी खास सेट को ऐक्सेस कर सकता है:
-
चैनल रिपोर्ट में, किसी चैनल के लिए उपयोगकर्ता की गतिविधि की मेट्रिक होती हैं.
-
कॉन्टेंट के मालिक के लिए उपलब्ध रिपोर्ट में, YouTube पर कॉन्टेंट के मालिक के तौर पर चुने गए व्यक्ति या कंपनी से जुड़े सभी चैनलों की मेट्रिक शामिल होती हैं. उदाहरण के लिए, कोई रिकॉर्ड लेबल ऐसी रिपोर्ट हासिल कर सकता है जिसमें लेबल के सभी कलाकारों के YouTube चैनलों के मिले-जुले आंकड़े शामिल हैं. कॉन्टेंट के मालिक की कुछ रिपोर्ट में, उपयोगकर्ता की गतिविधि से जुड़ी मेट्रिक शामिल होती हैं. वहीं, अन्य रिपोर्ट में रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक शामिल होती हैं.
रिपोर्टिंग 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 Reporting API में, इस तरह की रिपोर्ट मिलती हैं:
| रिपोर्ट का टाइप | विवरण |
|---|---|
| वित्तीय और रेवेन्यू रिपोर्ट | |
| विज्ञापन से मिलने वाला रेवेन्यू | विज्ञापन से मिलने वाले रेवेन्यू की हर महीने/हफ़्ते की खास जानकारी. उदाहरण: content_owner_ad_revenue_summary_a1,
content_owner_estimated_revenue_a1 |
| सदस्यता से होने वाली आय | म्यूज़िक लेबल और पब्लिशर को सदस्यता से मिलने वाला रेवेन्यू. उदाहरण: music_content_owner_red_revenue_raw_a1,
content_owner_music_asset_red_revenue_raw_a1 |
| शॉर्ट वीडियो से रेवेन्यू | कॉन्टेंट के मालिक के शॉर्ट वीडियो से कमाई करने के लिए, अलग-अलग पूल. उदाहरण: music_content_owner_shorts_revenue_summary_a1 |
| कॉन्टेंट के मालिक और ऐसेट की रिपोर्ट | |
| एसेट की परफ़ॉर्मेंस | किसी ऐसेट (आईएसआरसी/यूपीसी) से जुड़े व्यू और यूज़र ऐक्टिविटी. इन्हें अधिकार रखने वाले लोगों के लिए डिज़ाइन किया गया है, ताकि वे अपने सभी चैनलों की परफ़ॉर्मेंस को ट्रैक कर सकें. उदाहरण: content_owner_asset_basic_a3,
content_owner_asset_demographics_a1 |
| दावे और रेफ़रंस | यह रिपोर्ट, ऐसे दावों को ट्रैक करती है जिन पर कार्रवाई चल रही है. साथ ही, संभावित विवादों और रेफ़रंस ओवरलैप को भी ट्रैक करती है. इसे अधिकार रखने वालों के लिए डिज़ाइन किया गया है, ताकि वे अपने सभी चैनलों की परफ़ॉर्मेंस को ट्रैक कर सकें. उदाहरण: content_owner_active_claims_a3,
content_owner_asset_conflict_a3 |
| वीडियो और प्लेलिस्ट के आंकड़े | |
| वीडियो और प्लेलिस्ट के आंकड़े | किसी खास वीडियो या प्लेलिस्ट के लिए परफ़ॉर्मेंस का ज़्यादा जानकारी वाला डेटा. जैसे, ट्रैफ़िक सोर्स, डिवाइस टाइप/ओएस, वीडियो चलाने की जगहें, और दर्शक की डेमोग्राफ़िक्स. उदाहरण: channel_traffic_source_a3,
playlist_device_os_a2 |
इसके अलावा, YouTube कॉन्टेंट के मालिकों के लिए, सिस्टम से मैनेज की जाने वाली रिपोर्ट का एक सेट अपने-आप जनरेट करता है. इन रिपोर्ट को YouTube Studio में ऐक्सेस किया जा सकता है. इन रिपोर्ट से, विज्ञापन से मिलने वाले रेवेन्यू के डेटा का प्रोग्रामैटिक ऐक्सेस मिलता है.
रिपोर्टिंग के लिए उपलब्ध सुविधाएं
यहां दी गई टेबल में, अलग-अलग तरह की उन रिपोर्ट के बारे में बताया गया है जिन्हें एपीआई का इस्तेमाल करके वापस पाया जा सकता है. YouTube Analytics API का इस्तेमाल करके, टारगेट की गई क्वेरी उपलब्ध होती हैं. साथ ही, YouTube Reporting API का इस्तेमाल करके, कई रिपोर्ट उपलब्ध होती हैं.
ऐसा हो सकता है कि एक एपीआई में उपलब्ध डेटा, दूसरे एपीआई में उपलब्ध न हो. उदाहरण के लिए, YouTube Analytics API की मदद से, हफ़्ते या महीने के हिसाब से उपयोगकर्ता गतिविधि की मेट्रिक को वापस पाया जा सकता है. हालांकि, YouTube Reporting API के लिए, आपको उस डेटा को खुद एग्रीगेट करना होगा. दूसरी ओर, YouTube Reporting API की मदद से, कॉन्टेंट के मालिकों के लिए ऐसेट रिपोर्ट देखी जा सकती हैं. हालांकि, यह डेटा YouTube Analytics API से नहीं मिलता.
| रिपोर्ट प्रकार | |
|---|---|
| वीडियो रिपोर्ट | यह सुविधा, चैनलों (query या bulk) और कॉन्टेंट के मालिकों (query या bulk) के लिए उपलब्ध है. वीडियो की रिपोर्ट से, चैनल या कॉन्टेंट के मालिक के वीडियो से जुड़ी सभी उपयोगकर्ता गतिविधियों के आंकड़े मिलते हैं. उदाहरण के लिए, इन रिपोर्ट में आपके वीडियो पर मिले व्यू की संख्या शामिल होती है. YouTube Analytics API में, कॉन्टेंट के मालिक के लिए उपलब्ध वीडियो रिपोर्ट में अनुमानित रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक भी शामिल होती हैं. |
| पहुंच से जुड़ी रिपोर्ट | यह सुविधा, चैनलों (कई) और कॉन्टेंट के मालिकों (कई) के लिए उपलब्ध है. पहुंच से जुड़ी रिपोर्ट में, वीडियो के थंबनेल के इंप्रेशन और क्लिक मिलने की दर (सीटीआर) के आंकड़े मिलते हैं. |
| प्लेलिस्ट की रिपोर्ट | यह सुविधा, चैनलों (query या bulk) और कॉन्टेंट के मालिकों (query या bulk) के लिए उपलब्ध है. प्लेलिस्ट की रिपोर्ट में, ऐसे आंकड़े मिलते हैं जो खास तौर पर प्लेलिस्ट में मौजूद वीडियो के व्यू से जुड़े होते हैं. YouTube Reporting API में, प्लेलिस्ट के लिए दर्शक बनाए रखने की रिपोर्ट देखी जा सकती है. हालांकि, YouTube Analytics API में ऐसी रिपोर्ट देखने की सुविधा उपलब्ध नहीं है. |
| विज्ञापन परफ़ॉर्मेंस रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (query या bulk). विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, वीडियो प्लेबैक के दौरान दिखाए गए विज्ञापनों के लिए, इंप्रेशन-आधारित मेट्रिक शामिल होती हैं. इन मेट्रिक में हर विज्ञापन इंप्रेशन को शामिल किया जाता है. साथ ही, हर वीडियो प्लेबैक से कई इंप्रेशन मिल सकते हैं. |
| अनुमानित रेवेन्यू की रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (एक साथ कई वीडियो). अनुमानित रेवेन्यू की रिपोर्ट में, Google के बेचे गए विज्ञापन के स्रोतों और विज्ञापन के अलावा अन्य स्रोतों से मिलने वाले कुल अनुमानित रेवेन्यू की जानकारी मिलती है. इन रिपोर्ट में, विज्ञापन की परफ़ॉर्मेंस से जुड़ी कुछ मेट्रिक भी शामिल होती हैं. ध्यान दें कि सिस्टम मैनेज की गई रिपोर्ट में असल रेवेन्यू की जानकारी होती है. |
| ऐसेट रिपोर्ट | कॉन्टेंट के मालिकों के लिए उपलब्ध है (एक साथ कई वीडियो). ऐसेट रिपोर्ट में, कॉन्टेंट के मालिक की ऐसेट से लिंक किए गए वीडियो से जुड़ी उपयोगकर्ता गतिविधि की मेट्रिक शामिल होती हैं. किसी वीडियो को कॉन्टेंट के मालिक की रिपोर्ट में तब शामिल किया जाता है, जब कॉन्टेंट का मालिक उस वीडियो पर यह दावा करता है कि वह उसकी किसी एक ऐसेट से मिलता-जुलता है. वीडियो को कॉन्टेंट के मालिक या YouTube का इस्तेमाल करने वाले किसी दूसरे व्यक्ति ने अपलोड किया हो सकता है. |
| सिस्टम से मैनेज की गई रिपोर्ट | यह सुविधा, कॉन्टेंट के उन मालिकों के लिए उपलब्ध है जिनके पास YouTube Studio के रिपोर्ट मेन्यू में, इससे जुड़ी रिपोर्ट का ऐक्सेस है. सिस्टम मैनेज की गई रिपोर्ट में, ऐसेट और वीडियो से होने वाली आय का असल डेटा मिलता है. एक अन्य रिपोर्ट में, दावा किए गए वीडियो और उनसे मिलती-जुलती ऐसेट की सूची दी गई है. Creator Studio की सभी रिपोर्ट, एपीआई में उपलब्ध नहीं हैं. ध्यान दें: YouTube, कॉन्टेंट के मालिकों के लिए सिस्टम से मैनेज की जाने वाली रिपोर्ट अपने-आप जनरेट करता है. इन मालिकों के पास, Creator Studio में मौजूद रिपोर्ट का ऐक्सेस होता है. इसलिए, इन रिपोर्ट को वापस पाने की प्रोसेस, इस सूची में मौजूद अन्य तरह की रिपोर्ट से अलग है. ज़्यादा जानकारी के लिए, सिस्टम मैनेज किए गए रिपोर्ट का दस्तावेज़ देखें. |
मुख्य अंतर
यहां दी गई टेबल में, YouTube Analytics और Reporting APIs के बीच के अहम अंतर को हाइलाइट किया गया है.
| सुविधा | YouTube Analytics API | YouTube Reporting API |
|---|---|---|
| डेटा वापस पाने की प्रोसेस | हर एपीआई अनुरोध में, उन डाइमेंशन और मेट्रिक के बारे में बताया जाता है जिन्हें वापस भेजना है. साथ ही, उस समयावधि के बारे में भी बताया जाता है जिसके लिए डेटा वापस भेजा जाएगा. | ऐप्लिकेशन, रिपोर्टिंग जॉब शेड्यूल करते हैं. हर नौकरी के लिए, YouTube हर दिन रिपोर्ट जनरेट करता है. इन्हें एसिंक्रोनस तरीके से डाउनलोड किया जा सकता है. |
| तारीख सीमाएं | कुछ एपीआई रिपोर्ट में, उपयोगकर्ता की गतिविधि की तारीख दी जाती है. इनमें से कुछ रिपोर्ट में, उपयोगकर्ता गतिविधि की मेट्रिक को महीने के हिसाब से एग्रीगेट करने के लिए डाइमेंशन का इस्तेमाल किया जा सकता है. | सभी एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि की तारीख दी जाती है. एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन, समय-समय पर डेटा इकट्ठा करने की सुविधा लागू कर सकते हैं. |
| डेटा फ़िल्टर करना | रिपोर्ट को फ़िल्टर करके, सिर्फ़ उन लाइनों को शामिल किया जा सकता है जिनके लिए डाइमेंशन की कोई खास वैल्यू है. एपीआई, कुछ ऐसे डाइमेंशन के साथ भी काम करता है जिनका इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जाता है. जैसे, महाद्वीप और 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 |
| यूनीक मेट्रिक | uniques 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 कहा जाता है.