Introduction

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

आयाम

YouTube Analytics API का नाम YouTube Reporting API का नाम
adType ad_type
ageGroup age_group
asset asset_id
audienceType audience_retention_type
channel channel_id
claimedStatus claimed_status
contentOwner content_owner_id
country country_code
दिन date
deviceType device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
gender gender
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
operatingSystem operating_system
प्लेलिस्ट playlist_id
province province_code
sharingService sharing_service
subscribedStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
वीडियो video_id

मेट्रिक

YouTube Analytics API का नाम YouTube Reporting API का नाम
adImpressions ad_impressions
annotationClickableImpressions annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickThroughRate annotation_click_through_rate
annotationClosableImpressions annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate
annotationImpressions annotation_impressions
audienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
cardClickRate card_click_rate
cardClicks card_clicks
cardImpressions card_impressions
cardTeaserClickRate card_teaser_click_rate
cardTeaserClicks card_teaser_clicks
cardTeaserImpressions card_teaser_impressions
comments comments
सीपीएम estimated_cpm
नापसंद किए गए नापसंद किए गए
estimatedAdRevenue estimated_partner_ad_revenue
estimatedMinutesWatched watch_time_minutes
estimatedRevenue estimated_partner_revenue
grossRevenue estimated_youtube_ad_revenue
पसंद पसंद
monetizedPlaybacks estimated_monetized_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
शेयर शेयर
subscribersGained subscribers_gained
subscribersLost subscribers_lost
videosAddedToPlaylists videos_added_to_playlists
videosRemovedFromPlaylists videos_removed_from_playlist
viewerPercentage views_percentage
व्यू व्यू