Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

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

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

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

टैग किए गए उन प्रॉडक्ट को देखना जिनमें दर्शकों ने सबसे ज़्यादा दिलचस्पी दिखाई

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

यहां MCQL SELECT स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 20 और 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 स्टेटमेंट का एक उदाहरण दिया गया है. इसका इस्तेमाल करके, 20 और 21 जनवरी, 2026 के बीच कुल बिक्री के हिसाब से रैंक किए गए टॉप 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 फ़ॉर्मैट में हैं.
• लेटेंसी: क्वेरी की लेटेंसी, अनुरोध किए गए डेटा के वॉल्यूम पर निर्भर करती है. बड़े डेटा सेट को कवर करने वाली क्वेरी में ज़्यादा समय लगता है और इससे टाइमआउट हो सकता है.