شما می‌توانید با استفاده از Reports API، معیارهای کلیدی عملکرد را برای محصولات خود که در برنامه همکاری در فروش یوتیوب شرکت می‌کنند، بازیابی کنید. این راهنما نحوه جستجوی داده‌های همکاری در فروش مخصوص یوتیوب، مانند فروش، کمیسیون، سفارش، بازدید و کلیک، نسبت داده شده به سازندگان مختلف، محتوای ویدیویی و محصولات جداگانه را توضیح می‌دهد.
شما می‌توانید از MCQL برای انتخاب معیارها و ابعاد از «بازدیدهای» اختصاصی وابسته به یوتیوب استفاده کنید که مانند جداول در کوئری‌های شما عمل می‌کنند.
پیش‌نیازها
قبل از استفاده از این راهنما، مطمئن شوید که:
- حسابی که برای احراز هویت فراخوانی‌های API استفاده می‌شود، نقش Performance and insights را دارد که دسترسی به معیارهای عملکرد را فراهم می‌کند.
- حساب مرکز بازرگانان گوگل شما در برنامه همکاری در فروش یوتیوب (YouTube Affiliate Program) شرکت می‌کند.
پرس و جو از نقطه پایانی آلفا
توجه داشته باشید که با توجه به اینکه این در نسخه آلفای عمومی است، نقطه پایانی متفاوت است. برای بازیابی داده‌های عملکرد YouTube Affiliate، باید درخواست 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,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
این کوئری عنوان سازنده، شناسه کانال و معیارهای کلیدی عملکرد را برای ۳ سازنده برتر که بر اساس معیار فروش در محدوده تاریخ مشخص شده رتبه‌بندی شده‌اند، دریافت می‌کند.
عملکرد را بر اساس محتوا ببینید
برای دیدن اینکه کدام ویدیوهای خاص یوتیوب بهترین عملکرد را دارند، می‌توانید از youtube_content_performance_view استفاده کنید. این نما، معیارها را بر اساس ویدیوهای یوتیوب به صورت جداگانه جمع‌آوری می‌کند و شامل عناوین و شناسه‌های ویدیو می‌شود.
در اینجا یک مثال از دستور SELECT در MCQL آورده شده است که می‌توانید از آن برای یافتن ۳ ویدیوی برتر بر اساس بازدید بین ۱ تا ۲ مه ۲۰۲۵ استفاده کنید.
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
این کوئری عنوان ویدیو، شناسه ویدیو و معیارهای کلیدی را برای ۳ ویدیوی برتر که بر اساس تعداد کل views در محدوده تاریخ مشخص شده رتبه‌بندی شده‌اند، بازیابی می‌کند.
مشاهده عملکرد بر اساس محصول
برای تجزیه و تحلیل عملکرد محصولات منحصر به فرد در برنامه همکاری در فروش یوتیوب، می‌توانید youtube_product_performance_view استفاده کنید. این نما، معیارها را بر اساس محصول جمع‌آوری می‌کند و شامل عناوین محصول و شناسه‌های پیشنهاد می‌شود.
در اینجا یک مثال از دستور SELECT در MCQL آورده شده است که می‌توانید از آن برای یافتن ۳ محصول برتر بر اساس میزان فروش بین ۱ تا ۲ مه ۲۰۲۵ استفاده کنید:
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
این کوئری عنوان محصول، شناسه پیشنهاد و معیارهای عملکرد را برای ۳ محصول برتر، که بر اساس معیار sales مرتب شده‌اند، در طول دوره مشخص شده، برمی‌گرداند.
ملاحظات مهم
- تاریخ‌ها: همیشه کوئری‌های خود را بر اساس
dateبا استفاده از عبارت‌هایWHEREفیلتر کنید تا دوره گزارش‌دهی مشخص شود. تاریخ‌ها به صورتYYYY-MM-DDهستند. - تأخیر: تأخیر پرس‌وجوها به حجم داده‌های درخواستی بستگی دارد. پرس‌وجوهای بزرگ زمان بیشتری طول می‌کشند و ممکن است باعث وقفه شوند.