रिपोर्टिंग सब-एपीआई का इस्तेमाल करके, YouTube Shopping affiliate program में हिस्सा लेने वाले प्रॉडक्ट के लिए, परफ़ॉर्मेंस की मुख्य मेट्रिक वापस पाई जा सकती हैं. इस गाइड में, YouTube से जुड़े अफ़िलिएट डेटा को क्वेरी करने का तरीका बताया गया है. जैसे, अलग-अलग क्रिएटर्स, वीडियो कॉन्टेंट, प्रॉडक्ट, और टारगेट किए गए कैंपेन से जुड़ी बिक्री, कमीशन, ऑर्डर, व्यू, और क्लिक.
YouTube Affiliate Program APIs और उनसे जुड़े डेटा का इस्तेमाल, YouTube Shopping के डेवलपर के लिए बनी नीतियों के मुताबिक होना चाहिए.
Merchant Center Query Language (MCQL) का इस्तेमाल करके, YouTube Shopping से मिले कमीशन के लिए खास तौर पर तैयार किए गए व्यू से मेट्रिक और डाइमेंशन चुने जा सकते हैं. ये आपकी क्वेरी में टेबल की तरह काम करते हैं.
ज़रूरी शर्तें
इस गाइड का इस्तेमाल करने से पहले, पक्का करें कि:
- एपीआई कॉल की पुष्टि करने के लिए इस्तेमाल किए गए खाते के पास, परफ़ॉर्मेंस और अहम जानकारी की भूमिका होनी चाहिए. इससे परफ़ॉर्मेंस मेट्रिक का ऐक्सेस मिलता है.
- आपका Google Merchant Center खाता, YouTube Shopping affiliate program में शामिल हो.
ऐल्फ़ा एंडपॉइंट को क्वेरी करना
यह सुविधा पब्लिक ऐल्फ़ा वर्शन में है. इसलिए, इसका एंडपॉइंट अलग है. YouTube Shopping के अफ़िलिएट प्रोग्राम की परफ़ॉर्मेंस का डेटा वापस पाने के लिए, आपको 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 क्रिएटर के हिसाब से मेट्रिक इकट्ठा की जाती हैं. इसमें क्रिएटर के टाइटल और चैनल आईडी शामिल होते हैं.
यहां MCQL 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 वीडियो के हिसाब से मेट्रिक को इकट्ठा किया जाता है. इसमें वीडियो के टाइटल और आईडी भी शामिल होते हैं.
1 मई और 2 मई, 2025 के बीच व्यू के हिसाब से सबसे ज़्यादा देखे गए तीन वीडियो पाने के लिए,
accounts.reports.search
तरीके में यह MCQL स्टेटमेंट पास करें:
SELECT title, video_id, gross_sales, net_sales, 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
इस क्वेरी से, वीडियो का टाइटल, वीडियो आईडी, और अहम मेट्रिक मिलती हैं. ये मेट्रिक, तारीख की तय सीमा के दौरान, views की कुल संख्या के हिसाब से रैंक किए गए टॉप तीन वीडियो के लिए होती हैं.
टैग किए गए उन प्रॉडक्ट को देखना जिनमें दर्शकों ने सबसे ज़्यादा दिलचस्पी दिखाई
टैग किए गए किन प्रॉडक्ट में लोगों ने सबसे ज़्यादा दिलचस्पी दिखाई और किनसे सबसे ज़्यादा बिक्री हुई, यह जानने के लिए youtube_product_tagged_stats_view को क्वेरी किया जा सकता है.
इस व्यू में, टैग किए गए हर प्रॉडक्ट के हिसाब से मेट्रिक को एग्रीगेट किया जाता है. इसमें उनके टाइटल और ऑफ़र आईडी शामिल होते हैं.
यहां MCQL 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_sold_stats_view को क्वेरी किया जा सकता है.
यहां MCQL 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 कैंपेन की जानकारी पाने के लिए, यहां दिया गया MCQL 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 क्रिएटर्स की जानकारी पाने के लिए, यहां दिया गया MCQL 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 वीडियो पाने के लिए, यहां दिया गया MCQL 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
इस क्वेरी से, वीडियो का टाइटल, वीडियो का फ़ॉर्मैट (content_type),
टैग किए गए प्रॉडक्ट के टाइटल, और परफ़ॉर्मेंस की मुख्य मेट्रिक मिलती हैं. ये मेट्रिक, किसी क्रिएटर
चैनल, कैंपेन, और तारीख के हिसाब से, views की कुल संख्या के आधार पर रैंक किए गए टॉप 10 वीडियो
के लिए होती हैं.
प्रॉडक्ट के हिसाब से कैंपेन की परफ़ॉर्मेंस देखना
किसी कैंपेन में अलग-अलग प्रॉडक्ट की परफ़ॉर्मेंस जानने के लिए, youtube_campaign_products_stats_view को क्वेरी करें.
इस व्यू में, किसी कैंपेन के अंदर प्रॉडक्ट के लेवल की परफ़ॉर्मेंस मेट्रिक दिखती हैं. इनमें प्रॉडक्ट के टाइटल, उससे जुड़े वीडियो की जानकारी, और बिक्री की मेट्रिक शामिल होती हैं.
20 जून, 2026 को किसी कैंपेन के लिए, व्यू के हिसाब से सबसे लोकप्रिय 10 प्रॉडक्ट पाने के लिए, यहां दिया गया MCQL SELECT स्टेटमेंट इस्तेमाल करें:
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 प्रॉडक्ट के लिए होती हैं.
विचार करने वाली ज़रूरी बातें
- तारीखें: रिपोर्टिंग अवधि तय करने के लिए, अपनी क्वेरी को हमेशा
WHEREक्लॉज़ का इस्तेमाल करकेdateके हिसाब से फ़िल्टर करें. तारीखें,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.
- लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा के वॉल्यूम पर निर्भर करती है. बड़े डेटा सेट को कवर करने वाली क्वेरी में ज़्यादा समय लगता है और इससे टाइमआउट हो सकता है.