Analyze Youtube Affiliate Performance (Alpha)

يمكنك استرداد مقاييس الأداء الرئيسية لمنتجاتك المشارِكة في برنامج شركاء YouTube باستخدام واجهة برمجة التطبيقات الفرعية Reporting. يشرح هذا الدليل كيفية طلب بيانات الشركاء التابعين الخاصة بمنصة YouTube، مثل المبيعات والعمولات والطلبات والمشاهدات والنقرات، والتي يتم تحديد مصدرها على أنّها من صنّاع محتوى مختلفين ومحتوى فيديو ومنتجات فردية.

يمكنك استخدام Merchant Center Query Language (MCQL) لاختيار المقاييس والسمات من طرق العرض المخصّصة في "برنامج شركاء YouTube"، والتي تعمل مثل الجداول في طلبات البحث.

المتطلبات الأساسية

قبل استخدام هذا الدليل، تأكَّد مما يلي:

• يجب أن يكون الحساب المستخدَم للمصادقة على طلبات البيانات من واجهة برمجة التطبيقات لديه دور الأداء والإحصاءات الذي يمنح إذن الوصول إلى مقاييس الأداء.
• يشارك حسابك على Google Merchant Center في برنامج التسويق بالعمولة من YouTube.

طلب البحث من نقطة نهاية الإصدار الأوّلي

يُرجى العِلم أنّ نقطة النهاية تختلف لأنّ هذه الميزة متاحة في إصدار ألفا العام. لاسترداد بيانات أداء "برنامج شركاء التسوّق في YouTube"، عليك إرسال طلب POST إلى نقطة النهاية v1alpha. في ما يلي نموذج للطلب:

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 يمكنك استخدامها للحصول على أفضل 3 صنّاع محتوى من حيث المبيعات بين 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

يجلب طلب البحث هذا عنوان صانع المحتوى ومعرّف القناة ومقاييس الأداء الرئيسية لأهم 3 صنّاع محتوى مرتّبين حسب مقياس إجمالي المبيعات ضمن النطاق الزمني المحدّد.

الاطّلاع على الأداء حسب المحتوى

للاطّلاع على فيديوهات YouTube المحدّدة التي تحقّق أفضل أداء، يمكنك طلب البحث عن youtube_content_performance_view. تجمع طريقة العرض هذه المقاييس حسب فيديوهات YouTube الفردية، وتشمل عناوين الفيديوهات ومعرّفاتها.

لاسترداد أفضل 3 فيديوهات حسب عدد المشاهدات بين 1 مايو و2 مايو 2025، مرِّر عبارة MCQL التالية إلى الطريقة 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

يستردّ هذا الطلب عنوان الفيديو ورقم تعريفه والمقاييس الرئيسية لأفضل 3 فيديوهات مرتّبة حسب إجمالي عدد views في النطاق الزمني المحدّد.

الاطّلاع على المنتجات المُشار إليها التي حصدت أكبر قدر من التفاعل

لمعرفة المنتجات التي تمّت الإشارة إليها والتي حصدت أعلى نسبة تفاعل ومبيعات، يمكنك إرسال طلب بحث إلى youtube_product_tagged_stats_view. تجمع طريقة العرض هذه المقاييس حسب المنتجات الفردية التي تمت الإشارة إليها، بما في ذلك عناوينها ومعرّفات العروض.

في ما يلي مثال على عبارة MCQL SELECT يمكنك استخدامها للحصول على أفضل 10 منتجات حسب عدد المشاهدات بين 20 و21 يناير 2026:

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

يستردّ طلب البحث هذا العناوين وعدد الفيديوهات التي تمّت الإشارة فيها إلى منتجات والمقاييس الرئيسية لأهم 10 منتجات مرتّبة حسب إجمالي عدد views في النطاق الزمني المحدّد.

الاطّلاع على المنتجات الأكثر مبيعًا

لمعرفة المنتجات التي حقّقت أكبر عدد من المبيعات، يمكنك طلب البحث عن youtube_product_sold_stats_view.

في ما يلي مثال على عبارة MCQL SELECT يمكنك استخدامها للحصول على أفضل 10 منتجات مرتبة حسب إجمالي المبيعات بين 20 و21 يناير 2026:

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 منتجات تم طلبها حسب إجمالي المبيعات، وذلك في النطاق الزمني المحدّد.

اعتبارات مهمة

• التواريخ: احرص دائمًا على فلترة طلبات البحث حسب date باستخدام عبارات WHERE لتحديد الفترة التي سيتم إعداد التقارير بشأنها. التواريخ بالتنسيق YYYY-MM-DD
• وقت الاستجابة: يعتمد وقت الاستجابة لطلبات البحث على حجم البيانات المطلوبة. تستغرق طلبات البحث التي تغطي مجموعات بيانات كبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.