YouTube Shopping के अफ़िलिएट प्रोग्राम की परफ़ॉर्मेंस का विश्लेषण करना (ऐल्फ़ा वर्शन)

YouTube Affiliate Program में शामिल अपने प्रॉडक्ट की परफ़ॉर्मेंस से जुड़ी मुख्य मेट्रिक को वापस पाने के लिए, Reporting sub-API का इस्तेमाल किया जा सकता है. इस गाइड में, YouTube से जुड़े अफ़िलिएट डेटा को क्वेरी करने का तरीका बताया गया है. जैसे, बिक्री, कमीशन, ऑर्डर, व्यू, और क्लिक. यह डेटा अलग-अलग क्रिएटर्स, वीडियो कॉन्टेंट, अलग-अलग प्रॉडक्ट, प्रॉडक्ट कैटगरी, और टारगेट किए गए कैंपेन से जुड़ा होता है.

YouTube Affiliate Program के एपीआई और उनसे जुड़े डेटा का इस्तेमाल, YouTube Shopping के डेवलपर के लिए बनी नीतियों के मुताबिक होना चाहिए.

Merchant Center क्वेरी लैंग्वेज (एमसीक्यूएल) का इस्तेमाल करके, YouTube अफ़िलिएट के खास व्यू से मेट्रिक और डाइमेंशन चुने जा सकते हैं. ये व्यू, आपकी क्वेरी में टेबल की तरह काम करते हैं.

ज़रूरी शर्तें

इस गाइड का इस्तेमाल करने से पहले, पक्का करें कि:

• एपीआई कॉल की पुष्टि करने के लिए इस्तेमाल किए गए खाते के पास, परफ़ॉर्मेंस और अहम जानकारी की भूमिका होती है. इससे परफ़ॉर्मेंस मेट्रिक का ऐक्सेस मिलता है.
• आपका Google Merchant Center खाता, YouTube Shopping affiliate program में शामिल हो.

एक्सपेरिमेंट के तौर पर उपलब्ध: कारोबारी या कंपनी के लिए उपलब्ध रिपोर्टिंग सब-एपीआई में, YouTube अफ़िलिएट प्रोग्राम की परफ़ॉर्मेंस के व्यू, ऐल्फ़ा रिलीज़ में हैं. सुविधाओं और फ़ंक्शन में बदलाव हो सकता है. साथ ही, इन्हें अपडेट किया जा सकता है या बंद किया जा सकता है.

ऐल्फ़ा एंडपॉइंट से क्वेरी करना

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

यहां एमसीक्यूएल 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 तरीके को यह MCQL स्टेटमेंट पास करें:

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 की कुल संख्या के हिसाब से, टॉप 3 वीडियो के लिए मिलती है. ध्यान दें: नतीजों को फ़िल्टर करने के लिए, MCQL WHERE क्लॉज़ में account_id का इस्तेमाल नहीं किया जा सकता.

टैग किए गए ऐसे प्रॉडक्ट देखना जिनमें दर्शकों ने सबसे ज़्यादा दिलचस्पी दिखाई

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

1 सितंबर, 2026 को हुई कुल बिक्री के हिसाब से, टैग किए गए प्रॉडक्ट कैटगरी की टॉप 10 रैंकिंग पाने के लिए, यहां दिया गया MCQL SELECT स्टेटमेंट इस्तेमाल करें:

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
    

इस क्वेरी से, किसी तय तारीख को gross_sales के हिसाब से रैंक की गई टॉप 10 प्रॉडक्ट कैटगरी के लिए, प्रॉडक्ट कैटगरी (product_type), टैग किए गए क्रिएटर्स की संख्या, टैग किए गए वीडियो की संख्या, और मुख्य परफ़ॉर्मेंस मेट्रिक मिलती हैं.

सबसे ज़्यादा बिकने वाले प्रॉडक्ट देखना

यह जानने के लिए कि किन प्रॉडक्ट की बिक्री सबसे ज़्यादा हुई है, 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 कैंपेन की जानकारी पाने के लिए, इस एमसीक्यूएल 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
    

यह क्वेरी, टॉप 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 प्रॉडक्ट के लिए होती है.

विचार करने वाली ज़रूरी बातें

• तारीखें: रिपोर्टिंग अवधि तय करने के लिए, 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.
• लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा के वॉल्यूम पर निर्भर करती है. बड़े डेटा सेट वाली क्वेरी में ज़्यादा समय लगता है. साथ ही, इनकी वजह से टाइम आउट हो सकता है.