تحليل أداء برنامج الشركاء التابعين في YouTube (إصدار أوّلي)

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

يجب أن يتوافق استخدامكم لواجهات برمجة التطبيقات في "برنامج الشركاء التابعين على YouTube" والبيانات المرتبطة بها مع سياسات المطوّرين في "التسوّق على YouTube".

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

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

قبل استخدام هذا الدليل، يُرجى التأكّد مما يلي:

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

تجريبي: إنّ طرق عرض الأداء في "برنامج شركاء YouTube" في واجهة برمجة التطبيقات الفرعية Merchant Reporting هي في إصدار أولي. قد تتغيّر الميزات والوظائف وقد يتم تعديلها أو إيقافها نهائيًا.

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

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

HTTP

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --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 الفردية وتشمل عناوين الفيديوهات ومعرّفاتها. بالنسبة إلى الأسواق، يجب تضمين account_id لتقسيم الأداء حسب حسابات البائعين الفرعية الفردية. للاطّلاع على مبالغ العمولات التي يموّلها البائعون الفرعيون ومنصة السوق، يجب تضمين seller_commissions وplatform_commissions.

لاسترداد أفضل 3 فيديوهات حسب المشاهدات بين 1 مايو و2 مايو 2025، يجب تمرير عبارة MCQL التالية إلى accounts.reports.search طريقة:

SELECT
  title,
  video_id,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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
    

يستردّ هذا الطلب عنوان الفيديو ومعرّفه ومعرّف حساب البائع الفرعي (account_id) وإجمالي العمولات (commissions)، والعمولات التي يموّلها البائع (seller_commissions)، والعمولات التي تموّلها المنصة (platform_commissions)، والمقاييس الرئيسية الأخرى لأفضل 3 فيديوهات مرتّبة حسب إجمالي عدد views في النطاق الزمني المحدّد. ملاحظة: لا يمكنكم استخدام account_id في عبارة WHERE بلغة MCQL لفلترة النتائج.

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

لمعرفة المنتجات المُشار إليها التي تحقّق أكبر قدر من التفاعل والمبيعات، يمكنكم طلب البيانات من 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_category_tagged_stats_view. تجمع طريقة العرض هذه المقاييس حسب فئة المنتجات (product_type) في تصنيف منتجاتكم، بما في ذلك عدد صنّاع المحتوى والفيديوهات المميّزة التي تضمّ منتجات في كل فئة.

استخدِموا عبارة SELECT التالية بلغة MCQL للحصول على أفضل 10 فئات منتجات مُشار إليها مرتّبة حسب إجمالي المبيعات في 1 سبتمبر 2026:

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10
    

يستردّ هذا الطلب فئة المنتجات (product_type)، عدد صنّاع المحتوى المُشار إليهم وعدد الفيديوهات المُشار إليها ومقاييس الأداء الرئيسية لأفضل 10 فئات منتجات مرتّبة حسب gross_sales في التاريخ المحدّد.

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

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

الاطّلاع على الأداء في جميع الحملات

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

استخدِموا عبارة SELECT التالية بلغة MCQL للحصول على أفضل 10 حملات حسب الطلبات في 23 أبريل 2026:

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10
    

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

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

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

استخدِموا عبارة SELECT التالية بلغة MCQL للحصول على أفضل 10 صنّاع محتوى حسب المشاهدات لحملة معيّنة في 23 أبريل 2026:

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

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

الاطّلاع على أداء الحملة حسب الفيديو

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

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

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10
    

يستردّ هذا الطلب عنوان الفيديو وتنسيقه (content_type)، وعناوين المنتجات المُشار إليها ومقاييس الأداء الرئيسية لأفضل 10 فيديوهات مرتّبة حسب إجمالي عدد views لقناة صانع المحتوى والحملة والتاريخ المحدّدَين.

الاطّلاع على أداء الحملة حسب المنتج

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

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

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

يستردّ هذا الطلب عنوان قناة صانع المحتوى وعنوان المنتج وعنوان الفيديو عنوان URL للفيديو ومقاييس الأداء الرئيسية لأفضل 10 منتجات مرتّبة حسب إجمالي عدد views ضمن الحملة والتاريخ المحدّدَين.

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

• التواريخ: يجب دائمًا فلترة طلبات البحث حسب date باستخدام WHERE عبارات لـ تحديد فترة إعداد التقارير. تكون التواريخ بالتنسيق YYYY-MM-DD.
• الفلاتر المطلوبة: تتطلّب بعض طرق عرض الحملات فلاتر إضافية في عبارة WHERE clause:
  • youtube_individual_campaign_stats_view: campaign_id وdate
  • youtube_campaign_videos_stats_view: campaign_id وchannel_id وdate
  • youtube_campaign_products_stats_view: campaign_id وdate
• المدة الزمنية: تعتمد المدة الزمنية لطلبات البحث على حجم البيانات المطلوبة. تستغرق طلبات البحث التي تشمل مجموعات بيانات كبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.