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

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

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

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

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

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

إرسال طلب إلى نقطة نهاية الإصدار الأولي

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

في ما يلي مثال على عبارة SELECT في لغة MCQL يمكنك استخدامها للحصول على أفضل 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. تجمع طريقة العرض هذه المقاييس حسب المنتجات الفردية المُشار إليها، بما في ذلك عناوينها ومعرّفات عروضها الترويجية.

في ما يلي مثال على عبارة SELECT في MCQL يمكنك استخدامها للحصول على أهم 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.

في ما يلي مثال على عبارة SELECT في لغة MCQL يمكنك استخدامها للحصول على أفضل 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. تجمع طريقة العرض هذه المقاييس من جميع الحملات، بما في ذلك أسماء الحملات وتواريخ البدء والانتهاء وأعداد صنّاع المحتوى النشطين ومقاييس المبيعات والتفاعل.

استخدِم عبارة MCQL SELECT التالية للحصول على أفضل 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. تجمع طريقة العرض هذه المقاييس لكل صانع محتوى ضمن حملة معيّنة، بما في ذلك عناوين القنوات وعدد الفيديوهات وعناوين المنتجات المُشار إليها.

استخدِم عبارة MCQL SELECT التالية للحصول على أهم 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. تعرض هذه الصفحة مقاييس الأداء على مستوى الفيديو لصانع محتوى في حملة معيّنة، بما في ذلك عناوين الفيديوهات وأشكالها والمنتجات المُشار إليها.

استخدِم عبارة MCQL SELECT التالية للحصول على أفضل 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:
    • 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
  • وقت الاستجابة: يعتمد وقت استجابة طلبات البحث على حجم البيانات المطلوبة. تستغرق طلبات البحث التي تغطي مجموعات بيانات كبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.
السابق
Explore your competitive landscape
التالي
Analyze UCP agentic performance (Alpha)