همه درخواست‌ها به AudienceInsightsService محدود به نرخ هستند. تعداد درخواست‌های مجاز روزانه برای generateAudienceCompositionInsights و generateSuggestedTargetingInsights کمتر از سایر روش‌های «اطلاعات آماری مخاطب» است. برای جزئیات بیشتر، سهمیه‌های میانای برنامه‌سازی کاربردی را ببینید.
AudienceInsightsService به شما امکان می‌دهد داده‌های اطلاعات آماری مخاطب Google را
در ابزارهای برنامه‌ریزی‌تان ادغام کنید. این داده‌ها به آژانس‌های تبلیغاتی رسانه‌ای و طراحان رسانه کمک می‌کند تا درک عمیق‌تری از مخاطبان هدف خود، ازجمله جمعیت‌شناسی، علایق، و رفتار آنلاین آن‌ها، به‌دست آورند.
اطلاعات آماری مخاطب با ارائه نمای کلی سطح بالا به شما کمک می‌کند مخاطب، دسته، موضوع، یا نمانام را درک کنید. با تحلیل رفتارهای کاربر در موضوعات مرتبط، می‌توانید از این اطلاعات آماری مخاطب برای آشکار کردن تداعی‌ها و ادراکاتی که مصرف‌کنندگان دارند استفاده کنید و بخش‌های مخاطب جدید را شناسایی کنید.
این API از سه مورد استفاده اصلی پشتیبانی می‌کند:
- پالایش و کشف مخاطبان: علایق و رفتارهای منحصربه‌فرد مصرف‌کنندگان را درک کنید تا مخاطبان جدیدی برای نمانام شناسایی کنید، شخصیت‌های مخاطب را توسعه دهید، و استراتژی‌های بخش‌بندی مخاطبان را پالایش کنید.
- اطلاع‌رسانی درباره برنامه‌ریزی پویش: بروندادهای داده را به مخاطبان هدف YouTube تبدیل کنید تا براساس آن‌ها برنامه‌ریزی کنید، دسترسی بالقوه مخاطبان هدف را تخمین بزنید، و هم‌پوشانی بین بخش‌های مخاطب را اندازه‌گیری کنید تا دسترسی پویش را به حداکثر برسانید.
- توسعه پیام‌های خلاقانه: پیام‌های خلاقانه را براساس موضوعات و علایقی که مخاطبان هدف شما بیشتر با آن‌ها تعامل دارند، برای آن‌ها سفارشی‌سازی کنید.
شرایط صلاحیت
برای واجدشرایط بودن برای AudienceInsightsService، شرکا باید شرایط زیر را برآورده کنند:
- درحال‌حاضر به Insights Finder دسترسی داشته باشید یا واجدشرایط دسترسی به آن باشید.
- ابزار برنامه‌ریزی یا میانای کاربری داشته باشید که میانای برنامه‌سازی کاربردی را ادغام کند.
- از میانای برنامه‌سازی کاربردی برای اهداف برنامه‌ریزی رسانه یا دیگر موارد استفاده مرتبط استفاده کنید.
- ارزیابی پیش‌غربالگری را تکمیل کنید.
- الزامات استفاده از داده را رعایت کنید و تحت ممیزی‌های دوره‌ای داده قرار بگیرید.
- شرایط خدمات Google Ads API و خط‌مشی استفاده از داده‌های مرتبط را بپذیرید.
برای کسب اطلاعات بیشتر با نماینده Google تماس بگیرید.
فهرست کردن تاریخ‌های واجدشرایط اطلاعات آماری
یک گردش کار معمولی با بررسی اینکه کدام ماه‌های تقویم و پنجره‌های تاریخ برای تجزیه‌وتحلیل دردسترس هستند شروع می‌شود. روش listInsightsEligibleDates یک
ListInsightsEligibleDatesResponse برمی‌گرداند که فیلد data_months آن
ماه‌هایی را (در قالب YYYY-MM) فهرست می‌کند که داده‌های اطلاعات آماری مخاطب برای آن‌ها دردسترس است.
فیلد last_thirty_days پاسخ حاوی محدوده تاریخ دقیقی است که
generateAudienceCompositionInsights وقتی data_month در درخواست تنظیم نشده باشد
از آن استفاده می‌کند.
فهرست کردن مشخصه‌های اطلاعات آماری مخاطب
قبل‌از پرسمان کردن ترکیب مخاطب یا سنجه‌های هم‌پوشانی، شناسه‌های مشخصه معتبر را بااستفاده از listAudienceInsightsAttributes پیدا کنید. این روش
ListAudienceInsightsAttributesResponse حاوی
مشخصه‌های دردسترس برای ابعاد درخواستی را برمی‌گرداند.
برای مثال، اگر AFFINITY_USER_INTEREST به‌عنوان بُعد در درخواست انتخاب شده باشد، این روش مخاطبان همگرای پشتیبانی‌شده‌ای مثل «طرفداران ورزش» یا «علاقه‌مندان به موسیقی» را برمی‌گرداند. سایر ابعاد پشتیبانی‌شده علایق کاربر عبارتند از
IN_MARKET_USER_INTEREST و LIFE_EVENT_USER_INTEREST. می‌توانید چند بعد را در یک درخواست تنظیم کنید. برای مشاهده فهرست کامل ابعاد پشتیبانی‌شده،
مرجع فیلد dimensions را ببینید.
هنگام جستجوی موجودیت‌های گنجینهٔ دانش (موضوعات) بااستفاده از
بُعد KNOWLEDGE_GRAPH، باید پُرسمان رشته‌ای در فیلد
query_text ارائه دهید (برای مثال، "football and the World Cup").
می‌توانید به‌طور اختیاری knowledge_graph_entity_search_options را برای سفارشی‌سازی جستجوی موضوعی‌تان اضافه کنید:
- فیلتر کردن براساس قابلیت‌ها: از
search_filterبرای محدود کردن نهادهای بازیابی‌شده به مواردی که از قابلیت‌های خاصی پشتیبانی می‌کنند استفاده کنید. برای مثال، می‌توانید با ارائهCREATOR_ATTRIBUTEدر فیلدentity_capability_filters، موضوعات پشتیبانی‌شده به‌عنوان مشخصه‌های محتواساز را فیلتر کنید. چندین قابلیت را می‌توان ارائه کرد و این قابلیت‌ها با منطقORترکیب می‌شوند. - بازیابی همه مشخصه‌های محتواساز:
get_all_creator_attributesرا رویtrueتنظیم کنید تا همه نهادهای «گنجینه دانش» دردسترس که به‌عنوان مشخصه‌های محتواساز برچسب‌گذاری شده‌اند بازیابی شوند. هنگام استفاده از این گزینه، بُعدKNOWLEDGE_GRAPHباید انتخاب شود،query_textباید خالی باشد، و نمی‌توانید این گزینه را باsearch_filterترکیب کنید.
ویژگی‌های برگردانده‌شده توسط این روش قابل‌کشف بودن می‌تواند به‌عنوان ورودی برای
دیگر روش‌های AudienceInsightsService استفاده شود.
هر شیء AudienceInsightsAttributeMetadata در
ListAudienceInsightsAttributesResponse نمایشی ساختاریافته از
مشخصه مخاطب را درکنار ویژگی‌های توصیفی و سنجه‌های تعامل ارائه می‌دهد.
این شامل تعریف اصلی مشخصه، نام نمایشی، نوع بُعد،
و دسترسی تخمینی مخاطب است. برای تعاریف فیلد،
مرجع AudienceInsightsAttributeMetadata را ببینید.
تولید تعریف مخاطب
روش generateAudienceDefinition شرح نوشتاری آزاد از مخاطب را به پیشنهادهای ساختاریافته ویژگی مخاطب ترجمه می‌کند که می‌توانید به روش‌های اطلاعات آماری پایین‌دست ارسال کنید.
تولید اطلاعات آماری هدف‌یابی پیشنهادی
روش generateSuggestedTargetingInsights مجموعه‌ای از اطلاعات آماری هدف‌یابی (مانند بخش‌های مخاطب هدف‌یابی‌شدنی) را که با مخاطب درخواست‌شده مرتبط است برمی‌گرداند.
می‌توانید مخاطب درخواستی را به‌صورت ساختاریافته
InsightsAudienceDefinition یا به‌صورت شرح نوشتاری در
InsightsAudienceDescription مشخص کنید.
درحالی‌که generateAudienceCompositionInsights اطلاعات آماری را برای بخش‌های مشخصه مجزا برمی‌گرداند، generateSuggestedTargetingInsights پیشنهادهای دسته‌بندی‌شده بخش‌های مخاطب Google Ads قابل‌هدف‌یابی را برمی‌گرداند. این روش به پاسخ دادن به سؤالاتی مثل «پیشنهادهای مخاطب هدف‌پذیر برای پدران ۳۰ تا ۴۰ ساله‌ای که به ماهی‌گیری علاقه دارند به من بده» کمک می‌کند.
تولید سنجه‌های پیشنهاد هدف‌یابی
روش generateTargetingSuggestionMetrics یک
GenerateTargetingSuggestionMetricsResponse برمی‌گرداند که حاوی جمعیت بالقوه
YouTube است که می‌توان برای هر تعریف مخاطب درخواست‌شده در
GenerateTargetingSuggestionMetricsRequest به آن دسترسی پیدا کرد.
این روش به پاسخ دادن به سؤالاتی ازاین‌قبیل کمک می‌کند: «به چند مرد ۱۸ سال به بالا در ایالات متحده که به اردو زدن علاقه دارند می‌توان در YouTube دسترسی پیدا کرد؟»
تولید اطلاعات آماری ترکیب مخاطب
روش generateAudienceCompositionInsights یک
GenerateAudienceCompositionInsightsResponse برمی‌گرداند که حاوی فهرستی از
مشخصه‌هایی است که مخاطب موردنظر درخواست‌شده را نشان می‌دهد، به‌همراه سنجه‌های
شاخص و سهم که سهم هر مشخصه از مخاطب را با یک
جمعیت پایه مقایسه می‌کند.
باید کشور هدف را برای مخاطب ارائه دهید. فهرست ابعاد پشتیبانی‌شده برای بازیابی اطلاعات آماری ترکیب‌بندی در فیلد dimensions از GenerateAudienceCompositionInsightsRequest مستند شده است.
این روش به پاسخ دادن به پرسش‌هایی ازاین‌قبیل کمک می‌کند: «مخاطبان هدف من درمقایسه با جمعیت عمومی به کدام علایق بیشتر گرایش دارند و احتمال تعامل آن‌ها با این علایق چقدر بیشتر است؟»
تولید اطلاعات آماری هم‌پوشانی مخاطب
روش generateAudienceOverlapInsights یک
GenerateAudienceOverlapInsightsResponse برمی‌گرداند که حاوی فهرستی از
مشخصه‌های مخاطب با تخمین هم‌پوشانی بین دسترسی بالقوه آن‌ها در
YouTube و دسترسی یک مشخصه اصلی است.
باید کشور هدف و مشخصه اصلی را ارائه دهید. گروه سنی، جنسیت، بخش‌های علاقه‌مندی، و بخش‌های واقعی بازار به‌عنوان ابعاد مخاطب پشتیبانی می‌شوند.
این روش به پاسخ دادن به سؤالاتی ازاین‌قبیل کمک می‌کند: «وقتی هم طرفداران ورزش و هم دوستداران موسیقی را در ایالات متحده هدف قرار می‌دهیم، اندازه مخاطبان افزایشی چقدر است؟»
تولید گزارش «یافته‌های اطلاعات آماری»
روش generateInsightsFinderReport گزارش ذخیره‌شده‌ای در
Insights Finder براساس ورودی‌های مشخص‌شده در
GenerateInsightsFinderReportRequest ایجاد می‌کند و
GenerateInsightsFinderReportResponse حاوی پیوند قابل‌دسترسی خارجی
برای باز کردن آن گزارش در واسط کاربر Insights Finder را برمی‌گرداند.
سامانه پیگیری Google
از Google Issue Tracker برای پرسیدن سؤالات پشتیبانی، گزارش اشکالات، یا ارسال درخواست‌های ویژگی استفاده کنید. Google درخواست‌های شما را مستقیماً در Issue Tracker پیگیری، اولویت‌بندی، و به‌روزرسانی می‌کند. برای اطلاعات بیشتر، ایجاد مشکل در Google Issue Tracker را ببینید.
بااستفاده از یکی از الگوهای Issue Tracker زیر، مشکلی ایجاد کنید:
- پرسیدن سؤال پشتیبانی عمومی یا ارسال بازخورد درباره اسناد
- گزارش کردن اشکال فنی
- ارسال درخواست ویژگی میانای برنامه‌سازی کاربردی
همه فیلدهای الگو را با اطلاعات دقیق تکمیل کنید تا Google بتواند درخواستتان را بازتولید و اولویت‌بندی کند. Google ممکن است گزارش‌های ناقص را ببندد و از شما بخواهد مشکل جدیدی را با جزئیات جاافتاده ارسال کنید.