بینش سازنده YouTube

توجه: این ویژگی در نسخه بتا است و فقط برای توسعه‌دهندگانی که در فهرست مجاز قرار دارند، در دسترس است.

با استفاده از ویژگی creator insights، می‌توانید در مورد سازندگان ویدیو در یوتیوب اطلاعات کسب کنید و آنها را بیابید. این ویژگی می‌تواند برای آژانس‌ها و تبلیغ‌کنندگانی که می‌خواهند سازندگانی مرتبط با مخاطبان هدف خود پیدا کنند، مفید باشد.

این API چهار عملکرد اصلی دارد:

1. قابلیت کشف خالق: خالقان مرتبط را برای مجموعه‌ای از موضوعات، جمعیت‌شناسی، مخاطبان یا ویژگی‌های خالق پیدا کنید.
2. بینش‌های موضوعی خالق: بینش‌هایی درباره خالقان مرتبط که درباره موضوعات مشخص‌شده محتوا تولید می‌کنند، دریافت کنید.
3. بینش‌های خالق: بینش‌هایی درباره کانال‌های خاص یوتیوب، مانند تعداد مشترکین، تعداد بازدیدها و آمار جمعیتی مخاطبان آنها، دریافت کنید.
4. بینش‌های مربوط به روندها: بر اساس مخاطبان یا موضوعات خاص، بینش‌هایی در مورد روندهای خاص دریافت کنید.

کشف خالق محلی (یافتن خالقانی که در یک کشور مشخص مستقر هستند یا از آنجا پست می‌گذارند و در آن کشور دیده می‌شوند) هنگام استفاده از کشف خالق مبتنی بر موضوع یا بینش‌های روند با درخواست داده‌های تکمیلی پشتیبانی می‌شود.

شرایط لازم برای واجد شرایط بودن

GenerateCreatorInsights یک جزء خصوصی از API گوگل ادز است که با مجوز داده غیر انحصاری و بدون حق امتیاز ارائه می‌شود. شرکای امضا شده می‌توانند از کتابخانه‌های استاندارد کلاینت گوگل ادز برای بررسی سازندگان و محتوای یوتیوب استفاده کنند. برای واجد شرایط بودن، شرکا باید شرایط زیر را داشته باشند:

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

برای اطلاعات بیشتر با نماینده گوگل خود تماس بگیرید.

بینش‌های خالق را ایجاد کنید

برای تولید بینش‌های خالق، درخواستی را به متد GenerateCreatorInsights ارسال کنید. این متد محدودیت ۵ پرس‌وجو در ثانیه (QPS) دارد. بسته به اینکه آیا می‌خواهید قابلیت کشف خالق را انجام دهید، خالقان مرتبط را بر اساس موضوعات جستجو کنید یا بینش‌های خالق را دریافت کنید، انواع مختلفی از ورودی را دریافت می‌کند. شما باید مکان‌های کشوری را که می‌خواهید داده‌ها را از آنجا دریافت کنید، ارائه دهید.

1. قابلیت کشف خالق: شما می‌توانید فهرستی از ویژگی‌های مخاطب، مانند سن، جنسیت و علایق کاربر (از جمله وابستگی، مخاطبان درون بازار و مخاطبان رویدادهای زندگی) ارائه دهید. API فهرستی از خالقانی را که مخاطبانشان با این ویژگی‌ها مطابقت دارند، برمی‌گرداند. همچنین می‌توانید ویژگی‌های خالق را برای فیلتر کردن خالقانی که محتوای آنها به طور خاص با ویژگی‌های خالق وارد شده شما مطابقت دارد، ارائه دهید.

   شما می‌توانید ویژگی‌های موجود مخاطبان را با استفاده از ListAudienceInsightsAttributes بازیابی کنید، با ارائه ابعادی که برای آنها ویژگی‌هایی می‌خواهید، مانند KNOWLEDGE_GRAPH برای موضوعات مورد علاقه.

   از API نسخه ۲۳ گوگل ادز، می‌توانید روابط پیچیده‌ای بین ویژگی‌های مخاطبان با استفاده از audience_combinations تعیین کنید. این فیلد به شما امکان می‌دهد مخاطبان را با منطق بولی (AND/OR) تعریف کنید که با audience_attributes امکان‌پذیر نیست.

   در حالی که audience_attributes برای هدف‌گیری بر اساس لیستی از ویژگی‌های متحد (ترکیب شده با OR) مناسب است (مثلاً کاربرانی که به "ورزش" یا "سفر" یا ... علاقه‌مند هستند)، audience_combinations کنترل جزئی‌تری ارائه می‌دهد. هر InsightsAudienceAttributeGroup در audience_combinations ویژگی‌ها را با یک OR منطقی ترکیب می‌کند. سپس این گروه‌ها با یک AND منطقی ترکیب می‌شوند.

   برای مثال، برای هدف قرار دادن مخاطبی که به ("مراقبت از پوست" یا "مراقبت از مو") و همچنین به "لوازم آرایشی" علاقه دارد، باید از دو آیتم InsightsAudienceAttributeGroup در audience_combinations استفاده کنید. "مراقبت از پوست"، "مراقبت از مو" و "لوازم آرایشی" موضوعات مورد علاقه هستند که توسط موجودیت‌های نمودار دانش (به عنوان مثال، /m/014trl برای لوازم آرایشی) نمایش داده می‌شوند. گروه اول شامل ویژگی‌های موجودیت نمودار دانش برای "مراقبت از پوست" و "مراقبت از مو" و گروه دوم شامل ویژگی موجودیت نمودار دانش برای "لوازم آرایشی" خواهد بود.

   توجه داشته باشید که اگر موجودیت‌های نمودار دانش، دسته‌بندی‌های محصول و خدمات یا علایق کاربر را در audience_attributes مشخص کنید، نمی‌توانید audience_combinations استفاده کنید. اگر audience_combinations استفاده می‌کنید، باید این ویژگی‌ها را در audience_combinations مشخص کنید و نه در audience_attributes ؛ با این حال، همچنان می‌توانید audience_attributes برای انواع دیگر ویژگی‌ها مانند داده‌های جمعیتی همراه با audience_combinations استفاده کنید.

2. بینش‌های موضوع خالق: فهرستی از موضوعات محتوا را با استفاده از فیلد search_topics ارائه دهید. API، خالقان مرتبطی را که در مورد موضوعات مشخص‌شده محتوا تولید می‌کنند، برمی‌گرداند. داده‌های جمع‌آوری‌شده بر اساس کشور مشخص‌شده در country_locations است. توجه داشته باشید که این گزینه امکان جستجوی فقط یک کشور را فراهم می‌کند.

   موجودیت‌های پشتیبانی‌شده در فیلد SearchTopics باید با قابلیت CONTENT_TRENDING_INSIGHTS یا CREATOR_TOPIC_INSIGHTS برچسب‌گذاری شوند. برای بازیابی قابلیت‌های موجودیت پشتیبانی‌شده، از متد ListAudienceInsightsAttributes استفاده کنید.

   نکته: گزینه search_brand در نسخه ۲۴.۲ منسوخ و در نسخه ۲۵ حذف شد. به جای آن search_topics استفاده کنید.

3. بینش‌های سازنده: فهرستی از شناسه‌های کانال یوتیوب را با استفاده از فیلد search_channels ارائه دهید. API بینش‌هایی درباره آن کانال‌های خاص ارائه می‌دهد.

داده‌های تکمیلی و تولیدکنندگان محلی

به طور پیش‌فرض، فقط داده‌های بینش اصلی بازگردانده می‌شوند. شما می‌توانید با تنظیم فیلد تکراری supplemental_data ویژگی‌های اختیاری و داده‌های اضافی را در پاسخ خود درخواست کنید.

برای مثال، می‌توانید با اضافه کردن مقدار شمارشی LOCAL_CREATOR_DATA به فیلد supplemental_data ، داده‌های تولیدکننده محلی را درخواست کنید. اگر با استفاده از search_topics به دنبال تولیدکننده‌ها می‌گردید (و موضوع یک موجودیت نمودار دانش با قابلیت CREATOR_TOPIC_INSIGHTS است)، API فیلد local_creator_insights را در پاسخ با تولیدکننده‌های محلی که موافقت خود را برای اشتراک‌گذاری داده‌های موقعیت مکانی خود اعلام کرده‌اند، پر می‌کند.

به مشخصات زیر برای کشف خالق محلی توجه کنید:

• تعریف: «سازندگان محلی» سازندگانی هستند که در کشور انتخاب‌شده مستقر هستند یا از آنجا پست می‌گذارند و در آن کشور مشاهده می‌شوند.
• محدودیت: وقتی sub_country_locations در درخواست تنظیم شده باشد، کشف خالق محلی پشتیبانی نمی‌شود .
• قابلیت‌ها: می‌توانید فهرست موجودیت‌های گراف دانش پشتیبانی‌شده و قابلیت‌های آن‌ها را با استفاده از ListAudienceInsightsAttributes بازیابی کنید.

متد generateCreatorInsights یک شیء GenerateCreatorInsightsResponse برمی‌گرداند. این شیء شامل فیلدهای زیر است:

• creator_insights : فهرستی از اشیاء YouTubeCreatorInsights که با معیارهای اصلی شما مطابقت دارند.
• local_creator_insights : فهرستی از اشیاء YouTubeCreatorInsights برای سازندگان محلی. این فقط در صورتی پر می‌شود که LOCAL_CREATOR_DATA درخواست شده باشد و معیار مورد استفاده search_topics باشد.

هر شیء YouTubeCreatorInsights شامل اطلاعات زیر در مورد یک سازنده است:

• نام خالق
• کانال یوتیوب
• معیارهای کل خالق اثر
• فهرست بینش‌های کانال یوتیوب

شیء YouTubeMetrics شامل معیارهای زیر است:

• تعداد مشترکین
• تعداد مشاهده
• تعداد ویدیوها
• فعال است و خالق شورت است.
• فرصت‌های مشارکت (شروع از نسخه ۲۳)

برای تشخیص اینکه آیا یک تولیدکننده واجد شرایط مشارکت در تولید محتوای برند اصلی است یا خیر، partnership_opportunities را بررسی کنید؛ تولیدکننده‌ای واجد شرایط است که لیست شامل مقدار CREATOR_PARTNERSHIPS باشد.

شیء YouTubeChannelInsights شامل اطلاعات زیر در مورد یک کانال یوتیوب است:

• نام کانال
• شناسه کانال
• آدرس کانال
• توضیحات کانال
• معیارهای کانال
• ویژگی‌های مخاطبان کانال (مانند سن، جنسیت و تفکیک علایق کاربر)
• ویدیوهای برتر
• نوع کانال
• زبان‌های مرتبط با محتوای کانال
• امتیاز مرتبط بودن (فقط برای جستجوهای مربوط به روند موضوعی)
• اینکه آیا سازنده برای به اشتراک گذاشتن معیارهای غیرعمومی رضایت داده است یا خیر

بینش‌های پرطرفدار ایجاد کنید

برای تولید بینش‌های مربوط به روندها، درخواستی را به روش GenerateTrendingInsights ارسال کنید. این روش محدودیت ۵ پرس‌وجو در ثانیه (QPS) دارد. بسته به اینکه می‌خواهید روند مخاطبان یا روند موضوعات را دریافت کنید، دو نوع ورودی دریافت می‌کند. شما باید موقعیت مکانی کشور خاصی را که می‌خواهید روندها را از آنجا دریافت کنید، ارائه دهید.

1. روندهای مخاطبان: شما می‌توانید فهرستی از ویژگی‌های مخاطبان، مانند سن، جنسیت و علایق کاربر (از جمله مخاطبان وابسته، مخاطبان درون بازار و مخاطبان رویدادهای زندگی) ارائه دهید. API فهرستی از بینش‌های روندها را برای آن مخاطبان برمی‌گرداند، از جمله معیارهایی مانند درصد تغییر در مقدار روند در دوره مقایسه.

   شما می‌توانید ویژگی‌های موجود مخاطبان را با استفاده از ListAudienceInsightsAttributes بازیابی کنید، با ارائه ابعادی که برای آنها ویژگی‌هایی می‌خواهید، مانند KNOWLEDGE_GRAPH برای موضوعات مورد علاقه.

   از API نسخه ۲۳ گوگل ادز، می‌توانید روابط پیچیده‌ای بین ویژگی‌های مخاطبان با استفاده از audience_combinations تعیین کنید. این فیلد به شما امکان می‌دهد مخاطبان را با منطق بولی (AND/OR) تعریف کنید که با audience_attributes امکان‌پذیر نیست.

   در حالی که audience_attributes برای هدف‌گیری بر اساس لیستی از ویژگی‌های متحد (ترکیب شده با OR) مناسب است (مثلاً کاربرانی که به "ورزش" یا "سفر" یا ... علاقه‌مند هستند)، audience_combinations کنترل جزئی‌تری ارائه می‌دهد. هر InsightsAudienceAttributeGroup در audience_combinations ویژگی‌ها را با یک OR منطقی ترکیب می‌کند. سپس این گروه‌ها با یک AND منطقی ترکیب می‌شوند.

   برای مثال، برای هدف قرار دادن مخاطبی که به ("مراقبت از پوست" یا "مراقبت از مو") و همچنین به "لوازم آرایشی" علاقه دارد، باید از دو آیتم InsightsAudienceAttributeGroup در audience_combinations استفاده کنید. "مراقبت از پوست"، "مراقبت از مو" و "لوازم آرایشی" موضوعات مورد علاقه هستند که توسط موجودیت‌های نمودار دانش (به عنوان مثال، /m/014trl برای لوازم آرایشی) نمایش داده می‌شوند. گروه اول شامل ویژگی‌های موجودیت نمودار دانش برای "مراقبت از پوست" و "مراقبت از مو" و گروه دوم شامل ویژگی موجودیت نمودار دانش برای "لوازم آرایشی" خواهد بود.

   توجه داشته باشید که اگر موجودیت‌های نمودار دانش، دسته‌بندی‌های محصول و خدمات یا علایق کاربر را در audience_attributes مشخص کنید، نمی‌توانید audience_combinations استفاده کنید. اگر audience_combinations استفاده می‌کنید، باید این ویژگی‌ها را در audience_combinations مشخص کنید و نه در audience_attributes ؛ با این حال، همچنان می‌توانید audience_attributes برای انواع دیگر ویژگی‌ها مانند داده‌های جمعیتی همراه با audience_combinations استفاده کنید.

   ویژگی‌های KNOWLEDGE_GRAPH دارای یک یا چند تگ InsightsKnowledgeGraphEntityCapabilities خواهند بود. ویژگی‌های پشتیبانی شده برای Trending Insights دارای تگ‌های مرتبط در فراداده پاسخ خود خواهند بود.

   توجه داشته باشید که توسعه‌دهندگانی که به ContentCreatorInsightsService دسترسی دارند، به صورت خودکار به AudienceInsightsService.ListAudienceInsightsAttributes نیز دسترسی خواهند داشت. سایر نقاط انتهایی در AudienceInsightsService به یک فرآیند مستقل برای لیست مجاز نیاز دارند.

   مستندات بیشتر در مورد ListAudienceInsightsAttributes را می‌توانید در راهنمای Audience Insights بیابید.

2. روندهای موضوعی: فهرستی از موضوعات محتوا ارائه دهید. API فهرستی از بینش‌های رونددار برای آن موضوعات، از جمله معیارهایی مانند درصد تغییر در مقدار روند در دوره مقایسه، را برمی‌گرداند.

داده‌های تکمیلی و تولیدکنندگان محلی

مشابه تولید بینش‌های خالق، می‌توانید با تنظیم فیلد تکراری supplemental_data به LOCAL_CREATOR_DATA ، ویژگی‌های اختیاری را در بینش‌های رونددار درخواست کنید.

اگر درخواست ترند شما search_topics استفاده کند، این فیلد related_local_creators را در اشیاء TrendInsight برگردانده شده با سازندگان محلی مرتبط برای موضوع درخواستی که موافقت خود را برای به اشتراک گذاشتن داده‌های موقعیت مکانی خود اعلام کرده‌اند، پر می‌کند. کشف سازنده محلی نیز مشمول همان تعریف و محدودیت‌ها (مانند ناسازگاری با sub_country_locations ) است.

فراداده‌های بینش‌های پرطرفدار

متد GenerateTrendingInsights فهرستی از اشیاء TrendInsight را برمی‌گرداند که هر کدام شامل موارد زیر است:

• trend_attribute : فراداده‌ی اصلی AudienceInsightsAttributeMetadata برای روند.
• trend_metrics : معیارهای مربوط به روند، مانند درصد تغییر در دوره مقایسه.
• trend_data_points : نقاط داده تاریخی برای روند. فقط برای روندها با استفاده search_topics پر می‌شود.
• related_videos : فهرستی از اشیاء AudienceInsightsAttributeMetadata برای ویدیوهای پرطرفدار مرتبط با موضوع آن موضوع. فقط برای ویدیوهای پرطرفداری که از search_topics استفاده می‌کنند، پر می‌شود. برای این ویژگی‌ها، YouTubeVideoAttributeMetadata تودرتو پر می‌شود که شامل متادیتای سطح ویدیو (مانند URL ویدیو، URL تصویر کوچک و تعداد بازدید یا لایک) و متادیتای سطح کانال (مانند شناسه کانال، نام و URL) است.