Analyze Youtube Affiliate Performance (Alpha)

يمكنك استرداد مقاييس الأداء الرئيسية لمنتجاتك المشارِكة في الـ برنامج التسويق بالعمولة من YouTube باستخدام واجهة برمجة التطبيقات الفرعية لإعداد التقارير. يوضّح هذا الدليل كيفية طلب بيانات التسويق بالعمولة الخاصة بمنصة 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.
• وقت الاستجابة: يعتمد وقت استجابة طلبات البحث على حجم البيانات المطلوبة. تستغرق طلبات البحث التي تغطي مجموعات بيانات كبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.