تحلیل عملکرد برنامه همکاری YouTube (آلفا)

بااستفاده از زیرمیانای برنامه‌سازی کاربردی «گزارش‌دهی» می‌توانید سنجه‌های عملکرد کلیدی را برای محصولاتتان که در برنامه همکاری YouTube شرکت می‌کنند بازیابی کنید. این راهنما توضیح می‌دهد که چگونه داده‌های وابسته مختص YouTube، مانند فروش، کمیسیون، سفارش، بازدید، و کلیک، را که به محتواسازان مختلف، محتوای ویدیویی، محصولات فردی، دسته‌های محصول، و پویش‌های هدفمند نسبت داده شده‌اند، پُرسمان کنید.

استفاده شما از APIهای «برنامه فروش‌یاران YouTube» و داده‌های مرتبط باید با خط‌مشی‌های توسعه‌دهندگان «مرکز خرید YouTube» مطابقت داشته باشد.

می‌توانید از Merchant Center Query Language (MCQL) برای انتخاب سنجه‌ها و ابعاد از نماهای اختصاصی «برنامه همکاری YouTube» استفاده کنید که مانند جدول در پُرسمان‌های شما عمل می‌کنند.

پیش‌نیازها

قبل‌از استفاده از این راهنما، مطمئن شوید که:

  • حسابی که برای اصالت‌سنجی فراخوانی‌های میانای برنامه‌سازی کاربردی استفاده می‌شود، نقش عملکرد و اطلاعات آماری را دارد که دسترسی به سنجه‌های عملکرد را اعطا می‌کند.
  • حساب Google Merchant Center شما در برنامه فروش‌یار 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 به‌صورت جداگانه جمع‌آوری می‌کند و شامل عنوان‌های محتواساز و شناسه‌های کانال است.

در اینجا نمونه‌ای از عبارت MCQL SELECT آورده شده است که می‌توانید از آن برای دریافت ۳ محتواساز برتر ازنظر فروش بین ۱ مه و ۲ مه ۲۰۲۵ استفاده کنید: 

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

این پُرسمان عنوان محتواساز، شناسه کانال، و سنجه‌های عملکرد کلیدی را برای ۳ محتواساز برتر که براساس سنجه فروش ناخالص در محدوده تاریخ مشخص‌شده رتبه‌بندی شده‌اند واکشی می‌کند.

مشاهده عملکرد براساس محتوا

برای دیدن اینکه کدام ویدیوهای YouTube بهترین عملکرد را دارند، می‌توانید youtube_content_performance_view را پُرسمان کنید. این نما سنجه‌ها را براساس ویدیوهای YouTube تکی جمع‌آوری می‌کند و شامل عنوان‌ها و شناسه‌های ویدیو است. برای بازارگاه‌ها، account_id را اضافه کنید تا عملکرد را براساس حساب‌های زیرفروشنده تفکیک کنید. برای مشاهده مبالغ کارمزد تأمین‌شده توسط فروشندگان فرعی و پلاتفرم بازارگاه، seller_commissions و platform_commissions را اضافه کنید.

برای بازیابی ۳ ویدیو برتر براساس بازدید بین ۱ مه و ۲ مه ۲۰۲۵، عبارت 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)، و دیگر سنجه‌های کلیدی را برای ۳ ویدیو برتر رتبه‌بندی‌شده براساس تعداد کل views در محدوده تاریخ مشخص‌شده بازیابی می‌کند. توجه: نمی‌توانید از account_id در عبارت MCQL WHERE برای فیلتر کردن نتایج استفاده کنید.

دیدن محصولات برچسب‌گذاری‌شده با بیشترین تعامل

برای اینکه متوجه شوید کدام محصولات برچسب‌گذاری‌شده بیشترین تعامل و فروش را دارند، می‌توانید youtube_product_tagged_stats_view را پُرسمان کنید. این نما سنجه‌ها را براساس محصولات برچسب‌گذاری‌شده تکی، ازجمله عنوان‌ها و شناسه‌های پیشنهاد ویژه آن‌ها، انبوهش می‌کند.

در اینجا نمونه‌ای از عبارت MCQL SELECT آورده شده است که می‌توانید از آن برای دریافت ۱۰ محصول برتر براساس بازدید بین ۲۰ و ۲۱ ژانویه ۲۰۲۶ استفاده کنید: 

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

این پُرسمان عنوان‌ها، تعداد ویدیوهای برچسب‌گذاری‌شده، و سنجه‌های کلیدی را برای ۱۰ محصول برتر رتبه‌بندی‌شده براساس تعداد کل views در محدوده تاریخ مشخص‌شده بازیابی می‌کند.

دیدن عملکرد براساس دسته محصول برچسب‌گذاری‌شده

برای درک اینکه کدام دسته‌های محصول برچسب‌گذاری‌شده بیشترین تعامل و فروش را ایجاد می‌کنند، youtube_product_category_tagged_stats_view را پُرسمان کنید. این نما سنجه‌ها را براساس دسته محصول (product_type) در طبقه‌بندی محصول شما جمع‌آوری می‌کند، ازجمله تعداد محتواسازان و ویدیوهای متمایزی که محصولات را در هر دسته برچسب‌گذاری کرده‌اند.

از عبارت MCQL SELECT زیر برای دریافت ۱۰ دسته محصول برچسب‌گذاری‌شده برتر رتبه‌بندی‌شده براساس فروش ناخالص در ۱ سپتامبر ۲۰۲۶ استفاده کنید: 

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)، تعداد محتواسازان برچسب‌گذاری‌شده، تعداد ویدیوهای برچسب‌گذاری‌شده، و سنجه‌های عملکرد کلیدی را برای ۱۰ دسته محصول برتر رتبه‌بندی‌شده براساس gross_sales در تاریخ مشخص‌شده بازیابی می‌کند.

دیدن محصولاتی که بیشترین فروش را داشته‌اند

برای درک اینکه کدام محصولات بیشترین فروش را دارند، می‌توانید youtube_product_sold_stats_view را پُرسمان کنید.

در اینجا نمونه‌ای از عبارت MCQL SELECT آورده شده است که می‌توانید از آن برای دریافت ۱۰ محصول برتر براساس فروش ناخالص بین ۲۰ و ۲۱ ژانویه ۲۰۲۶ استفاده کنید: 

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

این پُرسمان داده‌های فروش، کارمزدها، و سنجه‌های کلیدی را برای ۱۰ محصول برتر براساس فروش ناخالص در محدوده تاریخ مشخص‌شده بازیابی می‌کند.

دیدن عملکرد در همه پویش‌ها

برای درک عملکرد کلی پویش‌های فروش‌یاری‌تان، youtube_campaigns_stats_view را پُرسمان کنید. این نما سنجه‌ها را در همه پویش‌ها، ازجمله نام پویش، تاریخ شروع و پایان، تعداد محتواسازان فعال، و سنجه‌های فروش و تعامل، تجمیع می‌کند.

از عبارت MCQL SELECT زیر برای دریافت ۱۰ پویش برتر براساس سفارش‌ها در ۲۳ آوریل ۲۰۲۶ استفاده کنید: 

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

این پُرسمان شناسه پویش، نام پویش، محدوده تاریخ، تعداد محتواسازان فعال، و سنجه‌های عملکرد کلیدی را برای ۱۰ پویش برتر رتبه‌بندی‌شده براساس تعداد کل orders در تاریخ مشخص‌شده بازیابی می‌کند.

دیدن عملکرد پویش براساس محتواساز

برای تحلیل عملکرد محتواسازان شرکت‌کننده در یک پویش خاص، youtube_individual_campaign_stats_view را پُرسمان کنید. این نما سنجه‌ها را برای هر محتواساز در پویش جمع‌آوری می‌کند، ازجمله عنوان کانال، تعداد ویدیو، و عنوان محصول برچسب‌گذاری‌شده.

از عبارت MCQL SELECT زیر برای دریافت ۱۰ محتواساز برتر براساس بازدید برای پویشی خاص در ۲۳ آوریل ۲۰۲۶ استفاده کنید: 

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

این پُرسمان عنوان کانال محتواساز، تعداد ویدیو، عنوان محصولات، و سنجه‌های کلیدی عملکرد را برای ۱۰ محتواساز برتر براساس تعداد کل بازدیدها در پویش و تاریخ مشخص‌شده بازیابی می‌کند.

دیدن عملکرد پویش براساس ویدیو

برای دیدن عملکرد ویدیوهای محتواساز خاص در پویش، youtube_campaign_videos_stats_view را پرس‌وجو کنید. این نما سنجه‌های عملکرد در سطح ویدیو را برای محتواساز در پویش ارائه می‌دهد، ازجمله عنوان ویدیو، قالب ویدیو، و محصولات برچسب‌گذاری‌شده.

از عبارت MCQL SELECT زیر برای دریافت ۱۰ ویدیو برتر براساس بازدید برای یک محتواساز و پویش خاص در ۲۰ مه ۲۰۲۶ استفاده کنید: 

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)، عنوان‌های محصول برچسب‌گذاری‌شده، و سنجه‌های عملکرد کلیدی را برای ۱۰ ویدیو برتر رتبه‌بندی‌شده براساس تعداد کل views برای کانال محتواساز، پویش، و تاریخ مشخص‌شده بازیابی می‌کند.

دیدن عملکرد پویش به‌تفکیک محصول

برای درک نحوه عملکرد محصولات تکی در یک پویش، youtube_campaign_products_stats_view را پُرسمان کنید. این نما سنجه‌های عملکرد در سطح محصول را در پویش ارائه می‌دهد، ازجمله عنوان محصول، جزئیات ویدیو مرتبط، و سنجه‌های فروش.

از عبارت MCQL SELECT زیر برای دریافت ۱۰ محصول برتر براساس بازدید برای پویشی خاص در ۲۰ ژوئن ۲۰۲۶ استفاده کنید: 

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

این پُرسمان عنوان کانال محتواساز، عنوان محصول، عنوان ویدیو، نشانی وب ویدیو، و سنجه‌های عملکرد کلیدی را برای ۱۰ محصول برتر رتبه‌بندی‌شده براساس تعداد کل 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)