- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- TargetingSuggestionMetrics
- آن را امتحان کنید!
مجموعهای از بینشهای هدف (مثلاً مخاطبان قابل هدف) را که به مخاطبان درخواستی مرتبط هستند، برمیگرداند.
فهرست خطاهای پرتاب شده: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:generateSuggestedTargetingInsights
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "audience": { object ( |
زمینه های | |
---|---|
audience | ضروری. مخاطب مورد علاقه که بینش برای آنها درخواست شده است. |
baselineAudience | اختیاری. مخاطبان پایه پیشفرض، اگر مشخص نشده باشد، همه افراد در یک کشور به عنوان مخاطب مورد علاقه هستند. |
dataMonth | اختیاری. محدوده یک ماهه دادههای تاریخی که برای اطلاعات آماری استفاده میشود، در قالب «yyyy-mm». اگر تنظیم نشود، اطلاعات آماری برای دادههای سی روز گذشته بازگردانده میشود. |
customerInsightsGroup | اختیاری. نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است. |
بدن پاسخگو
پیام پاسخ برای AudienceInsightsService.GenerateSuggestedTargetingInsights
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"suggestions": [
{
object ( |
زمینه های | |
---|---|
suggestions[] | بینش پیشنهادی برای مخاطبان قابل هدف. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
TargetingSuggestionMetrics
یک مخاطب قابل هدف پیشنهادی مرتبط با مخاطب درخواستی.
نمایندگی JSON |
---|
{ "locations": [ { object ( |
زمینه های | |
---|---|
locations[] | مکان یابی پیشنهادی همه این ویژگیها دارای ابعاد GEO_TARGET_COUNTRY یا SUB_COUNTRY_LOCATION هستند |
ageRanges[] | هدف گذاری سنی پیشنهادی؛ ممکن است خالی باشد که نشان دهنده عدم هدف سنی است. |
gender | هدف گذاری جنسیتی پیشنهادی اگر وجود داشته باشد، این ویژگی دارای بعد جنس است. |
userInterests[] | بخش های پیشنهادی مخاطب برای هدف قرار دادن همه این ویژگیها دارای بعد AFFINITY_USER_INTEREST یا IN_MARKET_USER_INTEREST هستند |
coverage | کسری (از 0 تا 1 شامل) از مخاطبان درخواستی که می توان با استفاده از هدف گذاری پیشنهادی به آنها رسید. |
index | نسبت پوشش به پوشش مخاطبان پایه یا صفر اگر این نسبت تعریف نشده باشد یا معنی دار نباشد. |
potentialYoutubeReach | تعداد تقریبی تخمینی افرادی که میتوان با استفاده از این هدفگیری در YouTube به آنها دسترسی داشت. |