Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

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

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

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

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