Reports API का इस्तेमाल करके, YouTube Affiliate Program में शामिल प्रॉडक्ट के लिए, परफ़ॉर्मेंस की मुख्य मेट्रिक वापस पाई जा सकती हैं. इस गाइड में, YouTube के अफ़िलिएट डेटा के बारे में क्वेरी करने का तरीका बताया गया है. जैसे, अलग-अलग क्रिएटर्स, वीडियो कॉन्टेंट, और प्रॉडक्ट के लिए एट्रिब्यूट की गई बिक्री, कमीशन, ऑर्डर, व्यू, और क्लिक.
MCQL का इस्तेमाल करके, YouTube से जुड़े अफ़िलिएट "व्यू" से मेट्रिक और डाइमेंशन चुने जा सकते हैं. ये आपकी क्वेरी में टेबल की तरह काम करते हैं.
ज़रूरी शर्तें
इस गाइड का इस्तेमाल करने से पहले, पक्का करें कि:
- एपीआई कॉल की पुष्टि करने के लिए इस्तेमाल किए गए खाते के पास, परफ़ॉर्मेंस और अहम जानकारी की भूमिका होनी चाहिए. इससे परफ़ॉर्मेंस मेट्रिक को ऐक्सेस किया जा सकता है.
- आपका Google Merchant Center खाता, YouTube Affiliate Program में शामिल हो.
ऐल्फ़ा एंडपॉइंट से क्वेरी करना
ध्यान दें कि यह सार्वजनिक ऐल्फ़ा वर्शन में है. इसलिए, इसका एंडपॉइंट अलग है. YouTube अफ़िलिएट प्रोग्राम की परफ़ॉर्मेंस का डेटा पाने के लिए, आपको v1alpha एंडपॉइंट पर POST अनुरोध भेजना होगा.
अनुरोध का एक उदाहरण यहां दिया गया है:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
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' \
--compressed
क्रिएटर के हिसाब से परफ़ॉर्मेंस देखना
यह समझने के लिए कि किन YouTube क्रिएटर्स की वजह से सबसे ज़्यादा दिलचस्पी और बिक्री बढ़ी है, youtube_creator_performance_view को क्वेरी किया जा सकता है.
इस व्यू में, हर YouTube क्रिएटर के हिसाब से मेट्रिक को इकट्ठा किया जाता है. इसमें क्रिएटर के टाइटल और चैनल आईडी शामिल होते हैं.
यहां MCQL SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 1 मई से 2 मई, 2025 के बीच बिक्री के हिसाब से सबसे अच्छा परफ़ॉर्म करने वाले तीन क्रिएटर्स की जानकारी पाई जा सकती है.
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
इस क्वेरी से, तय की गई तारीख की सीमा में बिक्री की मेट्रिक के हिसाब से रैंक किए गए टॉप तीन क्रिएटर्स के लिए, क्रिएटर का टाइटल, चैनल आईडी, और परफ़ॉर्मेंस से जुड़ी मुख्य मेट्रिक मिलती हैं.
कॉन्टेंट के हिसाब से परफ़ॉर्मेंस देखना
यह देखने के लिए कि कौनसे YouTube वीडियो सबसे अच्छा परफ़ॉर्म कर रहे हैं, youtube_content_performance_view को क्वेरी किया जा सकता है.
इस व्यू में, YouTube वीडियो के हिसाब से मेट्रिक को इकट्ठा किया जाता है. इसमें वीडियो के टाइटल और आईडी भी शामिल होते हैं.
यहां MCQL SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 1 मई और 2 मई, 2025 के बीच सबसे ज़्यादा देखे गए तीन वीडियो की जानकारी पाई जा सकती है.
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
इस क्वेरी से, वीडियो का टाइटल, वीडियो आईडी, और मुख्य मेट्रिक मिलती हैं. ये मेट्रिक, तय की गई तारीख की सीमा में views की कुल संख्या के हिसाब से रैंक किए गए टॉप 3 वीडियो के लिए होती हैं.
प्रॉडक्ट के हिसाब से परफ़ॉर्मेंस देखना
YouTube Affiliate Program में शामिल अलग-अलग प्रॉडक्ट की परफ़ॉर्मेंस का विश्लेषण करने के लिए, youtube_product_performance_view को क्वेरी किया जा सकता है.
इस व्यू में, प्रॉडक्ट के हिसाब से मेट्रिक को इकट्ठा किया जाता है. इसमें प्रॉडक्ट के टाइटल और ऑफ़र आईडी शामिल होते हैं.
यहां MCQL SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 1 मई और 2 मई, 2025 के बीच बिक्री की रकम के हिसाब से सबसे ज़्यादा बिकने वाले तीन प्रॉडक्ट का पता लगाया जा सकता है:
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
इस क्वेरी से, सबसे ज़्यादा परफ़ॉर्म करने वाले तीन प्रॉडक्ट के टाइटल, ऑफ़र आईडी, और परफ़ॉर्मेंस मेट्रिक मिलती हैं. इन प्रॉडक्ट को, तय की गई अवधि के दौरान sales मेट्रिक के हिसाब से क्रम में लगाया जाता है.
विचार करने वाली ज़रूरी बातें
- तारीखें: रिपोर्टिंग की अवधि तय करने के लिए,
WHEREक्लॉज़ का इस्तेमाल करके, अपनी क्वेरी को हमेशाdateके हिसाब से फ़िल्टर करें. तारीखें,YYYY-MM-DDफ़ॉर्मैट में हैं. - लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा के वॉल्यूम पर निर्भर करेगी. बड़ी क्वेरी को पूरा होने में ज़्यादा समय लगेगा और इससे टाइमआउट हो सकता है.