تجزیه و تحلیل عملکرد همکاری در فروش یوتیوب (آلفا)، تجزیه و تحلیل عملکرد همکاری در فروش یوتیوب (آلفا)

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

شما می‌توانید از زبان پرس‌وجوی مرکز بازرگانان (MCQL) برای انتخاب معیارها و ابعاد از نماهای اختصاصی وابسته به یوتیوب استفاده کنید، که مانند جداول در پرس‌وجوهای شما عمل می‌کنند.

پیش‌نیازها

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

پرس و جو از نقطه پایانی آلفا

از آنجا که این ویژگی در نسخه آلفای عمومی است، نقطه پایانی متفاوت است. برای بازیابی داده‌های عملکرد Youtube Affiliate، باید درخواست POST را به نقطه پایانی v1alpha ارسال کنید. برای اطلاعات بیشتر در مورد بازیابی گزارش‌ها، به accounts.reports.search مراجعه کنید. در اینجا یک نمونه درخواست آمده است:

اچ‌تی‌پی 

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

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

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_content_performance_view استفاده کنید. این نما، معیارها را بر اساس ویدیوهای یوتیوب به صورت جداگانه جمع‌آوری می‌کند و شامل عناوین و شناسه‌های ویدیو می‌شود.

برای بازیابی ۳ ویدیوی برتر بر اساس بازدیدها بین ۱ تا ۲ می ۲۰۲۵ ، دستور 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

این کوئری عنوان ویدیو، شناسه ویدیو و معیارهای کلیدی را برای ۳ ویدیوی برتر که بر اساس تعداد کل views در محدوده تاریخ مشخص شده رتبه‌بندی شده‌اند، بازیابی می‌کند.

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

برای فهمیدن اینکه کدام محصولات برچسب‌گذاری شده بیشترین تعامل و فروش را دارند، می‌توانید از 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_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 استفاده کنید. این نما، معیارهای عملکرد سطح محصول در یک کمپین، از جمله عناوین محصول، جزئیات ویدیوی مرتبط و معیارهای فروش را ارائه می‌دهد.

از دستور MCQL SELECT زیر برای بدست آوردن 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

این کوئری عنوان کانال سازنده، عنوان محصول، عنوان ویدیو، آدرس اینترنتی ویدیو و معیارهای کلیدی عملکرد را برای 10 محصول برتر که بر اساس تعداد کل views در کمپین و تاریخ مشخص شده رتبه‌بندی شده‌اند، بازیابی می‌کند.

ملاحظات مهم

  • تاریخ‌ها : همیشه کوئری‌های خود را بر اساس date با استفاده از عبارت‌های WHERE فیلتر کنید تا دوره گزارش‌دهی مشخص شود. تاریخ‌ها به فرمت YYYY-MM-DD هستند.
  • فیلترهای مورد نیاز : برخی از نماهای کمپین به فیلترهای اضافی در عبارت WHERE نیاز دارند:
    • youtube_individual_campaign_stats_view : شناسه و date campaign_id .
    • youtube_campaign_videos_stats_view : campaign_id ، channel_id و date .
    • youtube_campaign_products_stats_view : campaign_id و date .
  • تأخیر : تأخیر پرس‌وجوها به حجم داده‌های درخواستی بستگی دارد. پرس‌وجوهایی که مجموعه داده‌های بزرگی را پوشش می‌دهند، زمان بیشتری طول می‌کشند و ممکن است باعث وقفه شوند.
قبلی
Explore your competitive landscape
بعدی
Use Merchant Center Query Language