रिपोर्टिंग सब-एपीआई का इस्तेमाल करके, YouTube अफ़िलिएट प्रोग्राम में शामिल अपने प्रॉडक्ट की परफ़ॉर्मेंस से जुड़ी मुख्य मेट्रिक देखी जा सकती हैं. इस गाइड में, YouTube से जुड़े अफ़िलिएट डेटा को क्वेरी करने का तरीका बताया गया है. जैसे, बिक्री, कमीशन, ऑर्डर, व्यू, और क्लिक. यह डेटा अलग-अलग क्रिएटर्स, वीडियो कॉन्टेंट, अलग-अलग प्रॉडक्ट, प्रॉडक्ट कैटगरी, और टारगेट किए गए कैंपेन के हिसाब से होता है.
YouTube Affiliate Program के एपीआई और उनसे जुड़े डेटा का इस्तेमाल, YouTube Shopping की डेवलपर नीतियों के मुताबिक होना चाहिए.
Merchant Center क्वेरी लैंग्वेज (एमसीक्यूएल) का इस्तेमाल करके, YouTube अफ़िलिएट के खास व्यू से मेट्रिक और डाइमेंशन चुने जा सकते हैं. ये व्यू, आपकी क्वेरी में टेबल की तरह काम करते हैं.
ज़रूरी शर्तें
इस गाइड का इस्तेमाल करने से पहले, पक्का करें कि:
- एपीआई कॉल की पुष्टि करने के लिए इस्तेमाल किए गए खाते के पास, परफ़ॉर्मेंस और अहम जानकारी की भूमिका होती है. इससे परफ़ॉर्मेंस मेट्रिक को ऐक्सेस किया जा सकता है.
- आपका Google Merchant Center खाता, YouTube Shopping affiliate program में शामिल हो.
ऐल्फ़ा एंडपॉइंट को क्वेरी करना
यह सुविधा सार्वजनिक ऐल्फ़ा वर्शन में है. इसलिए, एंडपॉइंट अलग है. YouTube Affiliate की परफ़ॉर्मेंस का डेटा पाने के लिए, आपको v1alpha एंडपॉइंट पर POST अनुरोध भेजना होगा. रिपोर्ट वापस पाने के बारे में ज़्यादा जानने के लिए, accounts.reports.search देखें.
अनुरोध का एक सैंपल यहां दिया गया है:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key={YOUR_API_KEY}' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--compressed
क्रिएटर के हिसाब से परफ़ॉर्मेंस देखना
यह जानने के लिए कि YouTube के कौनसे क्रिएटर्स सबसे ज़्यादा यूज़र ऐक्टिविटी और बिक्री बढ़ा रहे हैं, youtube_creator_performance_view से क्वेरी की जा सकती है.
इस व्यू में, हर YouTube क्रिएटर के हिसाब से मेट्रिक एग्रीगेट की जाती हैं. इसमें क्रिएटर के टाइटल और चैनल आईडी शामिल होते हैं.
यहां एमसीक्यूएल SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 1 मई से 2 मई, 2025 के बीच बिक्री के आधार पर, सबसे अच्छा परफ़ॉर्म करने वाले तीन क्रिएटर्स की जानकारी हासिल की जा सकती है:
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
यह क्वेरी, तय की गई तारीख की सीमा के दौरान कुल बिक्री मेट्रिक के हिसाब से, टॉप तीन क्रिएटर्स के लिए क्रिएटर का टाइटल, चैनल आईडी, और मुख्य परफ़ॉर्मेंस मेट्रिक फ़ेच करती है.
कॉन्टेंट के हिसाब से परफ़ॉर्मेंस देखना
यह देखने के लिए कि कौनसे YouTube वीडियो सबसे अच्छा परफ़ॉर्म कर रहे हैं, youtube_content_performance_view को क्वेरी किया जा सकता है.
इस व्यू में, हर YouTube वीडियो के हिसाब से मेट्रिक को एग्रीगेट किया जाता है. इसमें वीडियो के टाइटल और आईडी शामिल होते हैं. मार्केटप्लेस के लिए, account_id को शामिल करें, ताकि हर सब-सेलर खाते के हिसाब से परफ़ॉर्मेंस को अलग-अलग किया जा सके. सब-सेलर और मार्केटप्लेस प्लैटफ़ॉर्म से मिलने वाले कमीशन की रकम देखने के लिए, seller_commissions और platform_commissions को शामिल करें.
1 मई से 2 मई, 2025 के बीच सबसे ज़्यादा व्यू वाले तीन वीडियो की जानकारी पाने के लिए,
accounts.reports.search
मेथड में यह एमसीक्यूएल स्टेटमेंट पास करें:
SELECT title, video_id, account_id, gross_sales, net_sales, commissions, seller_commissions, platform_commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY views DESC LIMIT 3
यह क्वेरी, वीडियो का टाइटल, वीडियो आईडी, सब-सेलर खाते का आईडी (account_id), कुल कमीशन (commissions), सेलर से मिलने वाला कमीशन (seller_commissions), प्लैटफ़ॉर्म से मिलने वाला कमीशन (platform_commissions), और अन्य अहम मेट्रिक की जानकारी देती है. यह जानकारी, तय की गई तारीख की सीमा में views की कुल संख्या के हिसाब से, टॉप तीन वीडियो के लिए मिलती है. ध्यान दें: नतीजों को फ़िल्टर करने के लिए, एमसीक्यूएल के WHERE क्लॉज़ में account_id का इस्तेमाल नहीं किया जा सकता.
टैग किए गए ऐसे प्रॉडक्ट देखना जिनमें दर्शकों ने सबसे ज़्यादा दिलचस्पी दिखाई
टैग किए गए किन प्रॉडक्ट में लोगों ने सबसे ज़्यादा दिलचस्पी दिखाई और किन प्रॉडक्ट की सबसे ज़्यादा बिक्री हुई, यह जानने के लिए
youtube_product_tagged_stats_view
को क्वेरी करें.
इस व्यू में, टैग किए गए हर प्रॉडक्ट के हिसाब से मेट्रिक एग्रीगेट की जाती हैं. इनमें प्रॉडक्ट के टाइटल और ऑफ़र आईडी शामिल होते हैं.
यहां एमसीक्यूएल SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 20 और 21 जनवरी, 2026 के बीच सबसे ज़्यादा देखे गए 10 प्रॉडक्ट की जानकारी पाई जा सकती है:
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
यह क्वेरी, चुनी गई तारीख की सीमा में views की कुल संख्या के हिसाब से, टॉप 10 प्रॉडक्ट के टाइटल, टैग किए गए वीडियो की संख्या, और मुख्य मेट्रिक को फ़ेच करती है.
टैग किए गए प्रॉडक्ट की कैटगरी के हिसाब से परफ़ॉर्मेंस देखना
टैग की गई किन प्रॉडक्ट कैटगरी से सबसे ज़्यादा यूज़र ऐक्टिविटी और बिक्री होती है, यह जानने के लिए youtube_product_category_tagged_stats_view को क्वेरी करें.
इस व्यू में, आपके प्रॉडक्ट की अलग-अलग कैटगरी (product_type) के हिसाब से मेट्रिक को एग्रीगेट किया जाता है. इसमें हर कैटगरी में प्रॉडक्ट टैग करने वाले क्रिएटर्स और वीडियो की संख्या शामिल होती है.
SELECT एमसीक्यूएल स्टेटमेंट का इस्तेमाल करके, 1 सितंबर, 2026 को कुल बिक्री के हिसाब से, टैग किए गए प्रॉडक्ट की टॉप 10 कैटगरी की जानकारी पाएं:
SELECT product_type, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_category_tagged_stats_view WHERE date = '2026-09-01' ORDER BY gross_sales DESC LIMIT 10
यह क्वेरी, प्रॉडक्ट कैटगरी (product_type), टैग किए गए क्रिएटर की संख्या, टैग किए गए वीडियो की संख्या, और परफ़ॉर्मेंस मेट्रिक को वापस लाती है. यह जानकारी, तय की गई तारीख पर gross_sales के हिसाब से रैंक की गई टॉप 10 प्रॉडक्ट कैटगरी के लिए होती है.
सबसे ज़्यादा बिकने वाले प्रॉडक्ट देखना
यह जानने के लिए कि किन प्रॉडक्ट की बिक्री सबसे ज़्यादा हुई है, youtube_product_sold_stats_view से क्वेरी की जा सकती है.
यहां एमसीक्यूएल SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 20 से 21 जनवरी, 2026 के बीच कुल बिक्री के हिसाब से, टॉप 10 प्रॉडक्ट की जानकारी पाई जा सकती है:
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
यह क्वेरी, तय की गई तारीख की सीमा में कुल बिक्री के हिसाब से ऑर्डर किए गए टॉप 10 प्रॉडक्ट की बिक्री का डेटा, कमीशन, और मुख्य मेट्रिक को वापस लाती है.
सभी कैंपेन की परफ़ॉर्मेंस देखना
आपके अफ़िलिएट कैंपेन की परफ़ॉर्मेंस कैसी है, यह जानने के लिए youtube_campaigns_stats_view को क्वेरी करें.
इस व्यू में, सभी कैंपेन की मेट्रिक को एग्रीगेट किया जाता है. इसमें कैंपेन के नाम, शुरू और खत्म होने की तारीखें, ऐक्टिव क्रिएटर्स की संख्या, और बिक्री और यूज़र ऐक्टिविटी मेट्रिक शामिल हैं.
23 अप्रैल, 2026 को ऑर्डर के हिसाब से सबसे अच्छा परफ़ॉर्म करने वाले 10 कैंपेन की जानकारी पाने के लिए, इस एमसीक्यूएल SELECT स्टेटमेंट का इस्तेमाल करें:
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
यह क्वेरी, कैंपेन आईडी, कैंपेन का नाम, तारीख की सीमा, ऐक्टिव क्रिएटर की संख्या, और सबसे अच्छा परफ़ॉर्म करने वाले 10 कैंपेन की मुख्य परफ़ॉर्मेंस मेट्रिक को वापस लाती है. इन कैंपेन को तय की गई तारीख पर, orders की कुल संख्या के हिसाब से रैंक किया जाता है.
क्रिएटर के हिसाब से कैंपेन की परफ़ॉर्मेंस देखना
किसी कैंपेन में हिस्सा लेने वाले अलग-अलग क्रिएटर्स की परफ़ॉर्मेंस का विश्लेषण करने के लिए, youtube_individual_campaign_stats_view को क्वेरी करें.
इस व्यू में, कैंपेन में शामिल हर क्रिएटर की मेट्रिक एग्रीगेट की जाती हैं. इनमें चैनल के टाइटल, वीडियो की संख्या, और टैग किए गए प्रॉडक्ट के टाइटल शामिल हैं.
23 अप्रैल, 2026 को किसी कैंपेन के लिए, व्यू के हिसाब से टॉप 10 क्रिएटर्स की जानकारी पाने के लिए, यहां दिए गए एमसीक्यूएल SELECT स्टेटमेंट का इस्तेमाल करें:
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
यह क्वेरी, क्रिएटर के चैनल का टाइटल, वीडियो की संख्या, प्रॉडक्ट के टाइटल, और परफ़ॉर्मेंस की मुख्य मेट्रिक को वापस लाती है. यह जानकारी, कैंपेन और तारीख के हिसाब से, कुल व्यू के आधार पर टॉप 10 क्रिएटर्स के लिए होती है.
वीडियो के हिसाब से कैंपेन की परफ़ॉर्मेंस देखना
किसी कैंपेन में क्रिएटर के वीडियो की परफ़ॉर्मेंस देखने के लिए, youtube_campaign_videos_stats_view को क्वेरी करें.
इस व्यू में, कैंपेन में शामिल किसी क्रिएटर के वीडियो की परफ़ॉर्मेंस से जुड़ी मेट्रिक दिखती हैं. इनमें वीडियो के टाइटल, वीडियो के फ़ॉर्मैट, और टैग किए गए प्रॉडक्ट शामिल हैं.
20 मई, 2026 को किसी क्रिएटर और कैंपेन के लिए, सबसे ज़्यादा व्यू वाले 10 वीडियो की जानकारी पाने के लिए, एमसीक्यूएल SELECT स्टेटमेंट का इस्तेमाल करें:
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
इस क्वेरी से, टॉप 10 वीडियो के टाइटल, वीडियो फ़ॉर्मैट (content_type), टैग किए गए प्रॉडक्ट के टाइटल, और परफ़ॉर्मेंस की मुख्य मेट्रिक की जानकारी मिलती है. इन वीडियो की रैंकिंग, क्रिएटर के चैनल, कैंपेन, और तारीख के हिसाब से views की कुल संख्या के आधार पर तय की जाती है.
प्रॉडक्ट के हिसाब से कैंपेन की परफ़ॉर्मेंस देखना
किसी कैंपेन में अलग-अलग प्रॉडक्ट की परफ़ॉर्मेंस को समझने के लिए,
youtube_campaign_products_stats_view
को क्वेरी करें.
इस व्यू में, किसी कैंपेन में प्रॉडक्ट-लेवल की परफ़ॉर्मेंस मेट्रिक दिखती हैं. इनमें प्रॉडक्ट के टाइटल, उनसे जुड़े वीडियो की जानकारी, और बिक्री की मेट्रिक शामिल हैं.
SELECT के लिए, इस एमसीक्यूएल स्टेटमेंट का इस्तेमाल करें. इससे आपको 20 जून, 2026 को किसी खास कैंपेन के लिए, व्यू के हिसाब से टॉप 10 प्रॉडक्ट की जानकारी मिलेगी:
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
यह क्वेरी, क्रिएटर के चैनल का टाइटल, प्रॉडक्ट का टाइटल, वीडियो का टाइटल, वीडियो का यूआरएल, और परफ़ॉर्मेंस की मुख्य मेट्रिक को फ़ेच करती है. यह जानकारी, तय किए गए कैंपेन और तारीख के हिसाब से, views की कुल संख्या के आधार पर रैंक किए गए टॉप 10 प्रॉडक्ट के लिए होती है.
विचार करने वाली ज़रूरी बातें
- तारीखें: अपनी क्वेरी को हमेशा
dateके हिसाब से फ़िल्टर करें. इसके लिए,WHEREक्लॉज़ का इस्तेमाल करके रिपोर्टिंग अवधि तय करें. तारीखेंYYYY-MM-DDफ़ॉर्मैट में हैं. - ज़रूरी फ़िल्टर: कैंपेन के कुछ व्यू के लिए,
WHEREक्लॉज़ में अतिरिक्त फ़िल्टर की ज़रूरत होती है:youtube_individual_campaign_stats_view:campaign_idऔरdate.youtube_campaign_videos_stats_view:campaign_id,channel_id, औरdate.youtube_campaign_products_stats_view:campaign_idऔरdate.
- लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा के वॉल्यूम पर निर्भर करती है. बड़े डेटा सेट वाली क्वेरी में ज़्यादा समय लगता है. साथ ही, इनकी वजह से टाइम आउट हो सकता है.