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

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

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