Analyze Youtube Affiliate Performance (Alpha)

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

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

پیش‌نیازها

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

• حسابی که برای احراز هویت فراخوانی‌های API استفاده می‌شود، نقش Performance and insights را دارد که دسترسی به معیارهای عملکرد را فراهم می‌کند.
• حساب مرکز بازرگانان گوگل شما در برنامه همکاری در فروش یوتیوب شرکت می‌کند.

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

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

ملاحظات مهم

• تاریخ‌ها : همیشه کوئری‌های خود را بر اساس date با استفاده از عبارت‌های WHERE فیلتر کنید تا دوره گزارش‌دهی مشخص شود. تاریخ‌ها به فرمت YYYY-MM-DD هستند.
• تأخیر : تأخیر پرس‌وجوها به حجم داده‌های درخواستی بستگی دارد. پرس‌وجوهایی که مجموعه داده‌های بزرگی را پوشش می‌دهند، زمان بیشتری طول می‌کشند و ممکن است باعث وقفه شوند.