Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

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

ध्यान दें कि यह सार्वजनिक ऐल्फ़ा वर्शन में है. इसलिए, इसका एंडपॉइंट अलग है. YouTube के अफ़िलिएट प्रोग्राम की परफ़ॉर्मेंस का डेटा पाने के लिए, आपको 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 के बीच व्यू के हिसाब से टॉप तीन वीडियो की जानकारी पाने के लिए, accounts.reports.search तरीके में, Merchant Center क्वेरी लैंग्वेज का यह स्टेटमेंट पास करें:

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 की कुल संख्या के हिसाब से टॉप तीन वीडियो के टाइटल, वीडियो आईडी, और मुख्य मेट्रिक की जानकारी मिलती है.

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

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