يمكنك استرداد مقاييس الأداء الرئيسية لمنتجاتك المشارِكة في برنامج شركاء "التسوّق على 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 في النطاق الزمني المحدّد.
اعتبارات مهمة
- التواريخ: احرص دائمًا على فلترة طلبات البحث حسب
dateباستخدام عباراتWHEREلتحديد الفترة الزمنية لإعداد التقارير. التواريخ بالتنسيقYYYY-MM-DD - وقت الاستجابة: يعتمد وقت استجابة طلبات البحث على حجم البيانات المطلوبة. ستستغرق الاستعلامات الكبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.