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