Method: customers.generateSuggestedTargetingInsights

مجموعه‌ای از بینش‌های هدف (مثلاً مخاطبان قابل هدف) را که به مخاطبان درخواستی مرتبط هستند، برمی‌گرداند.

فهرست خطاهای پرتاب شده: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateSuggestedTargetingInsights

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
زمینه های
audience

object ( InsightsAudience )

ضروری. مخاطب مورد علاقه که بینش برای آنها درخواست شده است.

baselineAudience

object ( InsightsAudience )

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

dataMonth

string

اختیاری. محدوده یک ماهه داده‌های تاریخی که برای اطلاعات آماری استفاده می‌شود، در قالب «yyyy-mm». اگر تنظیم نشود، اطلاعات آماری برای داده‌های سی روز گذشته بازگردانده می‌شود.

customerInsightsGroup

string

اختیاری. نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است.

بدن پاسخگو

پیام پاسخ برای AudienceInsightsService.GenerateSuggestedTargetingInsights .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
زمینه های
suggestions[]

object ( TargetingSuggestionMetrics )

بینش پیشنهادی برای مخاطبان قابل هدف.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

TargetingSuggestionMetrics

یک مخاطب قابل هدف پیشنهادی مرتبط با مخاطب درخواستی.

نمایندگی JSON
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
زمینه های
locations[]

object ( AudienceInsightsAttributeMetadata )

مکان یابی پیشنهادی همه این ویژگی‌ها دارای ابعاد GEO_TARGET_COUNTRY یا SUB_COUNTRY_LOCATION هستند

ageRanges[]

object ( AgeRangeInfo )

هدف گذاری سنی پیشنهادی؛ ممکن است خالی باشد که نشان دهنده عدم هدف سنی است.

gender

object ( GenderInfo )

هدف گذاری جنسیتی پیشنهادی اگر وجود داشته باشد، این ویژگی دارای بعد جنس است.

userInterests[]

object ( AudienceInsightsAttributeMetadata )

بخش های پیشنهادی مخاطب برای هدف قرار دادن همه این ویژگی‌ها دارای بعد AFFINITY_USER_INTEREST یا IN_MARKET_USER_INTEREST هستند

coverage

number

کسری (از 0 تا 1 شامل) از مخاطبان درخواستی که می توان با استفاده از هدف گذاری پیشنهادی به آنها رسید.

index

number

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

potentialYoutubeReach

string ( int64 format)

تعداد تقریبی تخمینی افرادی که می‌توان با استفاده از این هدف‌گیری در YouTube به آنها دسترسی داشت.