با استفاده از ویژگی creator insights، می‌توانید در مورد سازندگان ویدیو در یوتیوب اطلاعات کسب کنید و آنها را بیابید. این ویژگی می‌تواند برای آژانس‌ها و تبلیغ‌کنندگانی که می‌خواهند سازندگانی مرتبط با مخاطبان هدف خود پیدا کنند، مفید باشد.
این API چهار عملکرد اصلی دارد:
- قابلیت کشف خالق: برترین خالقان را برای مجموعه‌ای از موضوعات، جمعیت‌شناسی، مخاطبان یا ویژگی‌های خالق پیدا کنید.
- بینش برند خالق: بینش‌هایی درباره خالقان مربوط به یک برند خاص دریافت کنید.
- بینش‌های خالق: بینش‌هایی درباره کانال‌های خاص یوتیوب، مانند تعداد مشترکین، تعداد بازدیدها و آمار جمعیتی مخاطبان آنها، دریافت کنید.
- بینش‌های مربوط به روندها: بر اساس مخاطبان یا موضوعات خاص، بینش‌هایی در مورد روندهای خاص دریافت کنید.
شرایط لازم برای واجد شرایط بودن
ContentCreatorInsightsService.GenerateCreatorInsights یک جزء خصوصی از API گوگل ادز است که با مجوز داده غیر انحصاری و بدون حق امتیاز ارائه می‌شود. شرکای امضا شده می‌توانند از کتابخانه‌های استاندارد کلاینت گوگل ادز برای بررسی سازندگان و محتوای یوتیوب استفاده کنند. برای واجد شرایط بودن، شرکا باید شرایط زیر را داشته باشند:
- یک ابزار برنامه‌ریزی یا رابط کاربری داشته باشید که API را ادغام کند.
- از API برای بررسی محتوای یوتیوب و سازندگان آن و یافتن فرصت‌های تبلیغاتی بالقوه استفاده کنید.
- برای اطمینان از واجد شرایط بودن، یک ارزیابی اولیه انجام دهید.
- الزامات استفاده از داده را رعایت کنید و مایل به انجام ممیزی‌های دوره‌ای داده‌ها باشید.
- یک توافقنامه صدور مجوز داده امضا کنید که الزامات استفاده از داده را به صورت قانونی اجرا کند.
- شرایط خدمات API تبلیغات گوگل را بپذیرید.
برای اطلاعات بیشتر با نماینده گوگل خود تماس بگیرید.
بینش‌های خالق را ایجاد کنید
برای تولید بینش‌های خالق، درخواستی را به متد ContentCreatorInsightsService.GenerateCreatorInsights ارسال کنید. این متد محدودیت ۵ پرس‌وجو در ثانیه (QPS) دارد و بسته به اینکه آیا می‌خواهید قابلیت کشف خالق، بینش برند خالق یا بینش خالق را انجام دهید، سه نوع ورودی دریافت می‌کند. شما باید مکان‌های کشوری را که می‌خواهید داده‌ها را از آنها دریافت کنید، ارائه دهید.
- قابلیت کشف خالق: شما می‌توانید فهرستی از ویژگی‌های مخاطبان، مانند سن، جنسیت و علایق، ارائه دهید. API فهرستی از خالقانی را که مخاطبانشان با آن ویژگی‌ها مطابقت دارند، برمی‌گرداند. همچنین می‌توانید ویژگی‌های خالق را برای فیلتر کردن خالقانی که محتوای آنها به طور خاص با ویژگی‌های خالق ورودی شما مطابقت دارد، ارائه دهید.
- بینش برند خالق: یک برند برای جستجوی خالقان برتر ارائه دهید. API بینش‌هایی در مورد کانال‌های منطبق ارائه می‌دهد.
- بینش‌های خالق: فهرستی از شناسه‌های کانال‌های یوتیوب ارائه دهید. API بینش‌هایی درباره آن کانال‌های خاص ارائه می‌دهد.
متد generateCreatorInsights یک شیء GenerateCreatorInsightsResponse را برمی‌گرداند. این شیء شامل لیستی از اشیاء YouTubeCreatorInsights است. هر شیء YouTubeCreatorInsights شامل اطلاعات زیر در مورد یک سازنده است:
- نام خالق
- کانال یوتیوب
- معیارهای کل خالق اثر
- فهرست بینش‌های کانال یوتیوب
شیء YouTubeMetrics شامل معیارهای زیر است:
- تعداد مشترکین
- تعداد مشاهده
- تعداد ویدیوها
- آیا خالق شلوارک‌های اکتیو است؟
شیء YouTubeChannelInsights شامل اطلاعات زیر در مورد یک کانال یوتیوب است:
- نام کانال
- شناسه کانال
- آدرس کانال
- توضیحات کانال
- معیارهای کانال
- ویژگی‌های مخاطبان کانال (مانند سن، جنسیت و تفکیک علایق کاربر)
- ویدیوهای برتر
- نوع کانال
بینش‌های پرطرفدار ایجاد کنید
برای تولید بینش‌های مربوط به روندها، درخواستی را به متد ContentCreatorInsightsService.GenerateTrendingInsights ارسال کنید. این متد محدودیت ۵ پرس‌وجو در ثانیه (QPS) دارد و بسته به اینکه می‌خواهید روند مخاطبان یا روند موضوعات را دریافت کنید، دو نوع ورودی دریافت می‌کند. شما باید موقعیت مکانی کشور خاصی را که می‌خواهید روندها را از آنجا دریافت کنید، ارائه دهید.
- روندهای مخاطبان: شما می‌توانید فهرستی از ویژگی‌های مخاطبان، مانند سن، جنسیت و علایق، ارائه دهید. API فهرستی از بینش‌های روندهای آن مخاطبان را برمی‌گرداند.
- روندهای موضوعی: فهرستی از موضوعات محتوا ارائه دهید. API فهرستی از بینش‌های پرطرفدار برای آن موضوعات را برمی‌گرداند.