يمكنك استرداد مقاييس الأداء الرئيسية لمنتجاتك المشارِكة في برنامج شركاء "التسوّق على YouTube" باستخدام Reports API. يوضّح هذا الدليل كيفية طلب بيانات برنامج الشركاء التابعين الخاصة بمنصة YouTube، مثل المبيعات والعمولات والطلبات والمشاهدات والنقرات، والتي يتم تحديد مصدرها لصنّاع محتوى مختلفين ومحتوى فيديو ومنتجات فردية.
يمكنك استخدام MCQL لاختيار المقاييس والسمات من "المشاهدات" المخصّصة في "برنامج شركاء YouTube"، والتي تعمل مثل الجداول في طلبات البحث.
المتطلبات الأساسية
قبل استخدام هذا الدليل، تأكَّد مما يلي:
- يجب أن يكون الحساب المستخدَم للمصادقة على طلبات البيانات من واجهة برمجة التطبيقات مزوّدًا بدور الأداء والإحصاءات الذي يمنح إذن الوصول إلى مقاييس الأداء.
- يشارك حسابك على Google Merchant Center في برنامج الشركاء التابعين في YouTube.
طلب البحث من نقطة نهاية الإصدار الأوّلي
يُرجى العِلم أنّ نقطة النهاية تختلف لأنّ هذه الميزة في مرحلة الإصدار الأوّلي العلني. لاسترداد بيانات أداء "برنامج الشركاء التابعين" في YouTube، عليك إرسال طلب POST إلى نقطة النهاية v1alpha.
في ما يلي نموذج للطلب:
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 ويتضمّن عناوين صنّاع المحتوى ومعرّفات القنوات.
في ما يلي مثال على جملة SELECT في MCQL يمكنك استخدامها للحصول على أفضل 3 صنّاع محتوى أداءً حسب المبيعات بين 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
يجلب هذا الطلب عنوان صانع المحتوى ومعرّف القناة ومقاييس الأداء الرئيسية لأهم 3 صنّاع محتوى مرتّبين حسب مقياس المبيعات ضمن النطاق الزمني المحدّد.
الاطّلاع على الأداء حسب المحتوى
للاطّلاع على فيديوهات YouTube المحدّدة التي تحقّق أفضل أداء، يمكنك طلب البحث عن
youtube_content_performance_view.
تجمع طريقة العرض هذه المقاييس حسب فيديوهات YouTube الفردية، وتشمل عناوين الفيديوهات ومعرّفاتها.
في ما يلي مثال على عبارة SELECT في MCQL يمكنك استخدامها للحصول على أفضل 3 فيديوهات حسب عدد المشاهدات بين 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
يستردّ هذا الطلب عنوان الفيديو ورقم تعريفه والمقاييس الرئيسية لأفضل 3 فيديوهات مرتّبة حسب العدد الإجمالي views في النطاق الزمني المحدّد.
الاطّلاع على الأداء حسب المنتج
لتحليل أداء المنتجات الفردية ضمن "برنامج التسويق بالعمولة من YouTube"، يمكنك طلب البحث عن youtube_product_performance_view.
يجمع هذا العرض المقاييس حسب المنتج ويتضمّن عناوين المنتجات ومعرّفات العروض.
في ما يلي مثال على عبارة SELECT في MCQL يمكنك استخدامها للعثور على أفضل 3 منتجات حسب مبلغ المبيعات بين 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
يعرض هذا الطلب عنوان المنتج ورقم تعريف العرض ومقاييس الأداء لأفضل 3 منتجات، مرتّبة حسب المقياس sales، خلال الفترة المحدّدة.
اعتبارات مهمة
- التواريخ: عليك دائمًا فلترة طلبات البحث حسب
dateباستخدام عباراتWHEREلتحديد الفترة الزمنية لإعداد التقارير. التواريخ بالتنسيقYYYY-MM-DD - وقت الاستجابة: يعتمد وقت استجابة طلبات البحث على حجم البيانات المطلوبة. ستستغرق الاستعلامات الكبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.