Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

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

ध्यान दें कि यह सुविधा, पब्लिक ऐल्फ़ा वर्शन में उपलब्ध है. इसलिए, इसका एंडपॉइंट अलग है. Youtube Affiliate की परफ़ॉर्मेंस का डेटा पाने के लिए, आपको v1alpha एंडपॉइंट पर POST अनुरोध भेजना होगा. अनुरोध का एक सैंपल यहां दिया गया है:

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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' \
  --compressed

क्रिएटर के हिसाब से परफ़ॉर्मेंस देखना

यह जानने के लिए कि किन YouTube क्रिएटर्स की वजह से सबसे ज़्यादा दिलचस्पी और बिक्री हो रही है, आप youtube_creator_performance_view के बारे में क्वेरी कर सकते हैं. इस व्यू में, YouTube के हर क्रिएटर के हिसाब से मेट्रिक को एग्रीगेट किया जाता है. इसमें क्रिएटर के टाइटल और चैनल आईडी शामिल होते हैं.

यहां MCQL का SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, बिक्री के हिसाब से सबसे ज़्यादा परफ़ॉर्म करने वाले तीन क्रिएटर्स की जानकारी 1 मई, 2025 से 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 मई, 2025 से 2 मई, 2025 के बीच, यह MCQL स्टेटमेंट accounts.reports.search तरीके में पास करें:

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 जनवरी, 2026 से 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 स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, कुल बिक्री के हिसाब से सबसे ज़्यादा परफ़ॉर्म करने वाले 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 प्रॉडक्ट के बिक्री डेटा, कमीशन, और अहम मेट्रिक की जानकारी मिलती है.

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

• तारीखें: रिपोर्टिंग अवधि तय करने के लिए, अपनी क्वेरी को हमेशा WHERE क्लॉज़ का इस्तेमाल करके, date के हिसाब से फ़िल्टर करें. तारीखें, YYYY-MM-DD फ़ॉर्मैट में होती हैं.
• लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा की वॉल्यूम पर निर्भर करती है. बड़े डेटा सेट को कवर करने वाली क्वेरी में ज़्यादा समय लगता है. साथ ही, इनमें टाइम आउट हो सकता है.