Method: customers.generateSuggestedTargetingInsights

מחזירה אוסף של מדדי טירגוט (למשל קהלים שניתן לטרגט) שרלוונטיים לקהל המבוקש.

רשימת שגיאות התרעה: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. מספר הלקוח.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
שדות
audience

object (InsightsAudience)

חובה. קהל העניין שעבורו מבקשים לקבל תובנות.
baselineAudience

object (InsightsAudience)

אפשרות. קהל הבסיס. אם לא צוינה ברירת מחדל, ברירת המחדל היא כל האנשים שנמצאים באותה מדינה שבה נמצא קהל היעד.
dataMonth

string

אפשרות. טווח של חודש אחד של נתונים היסטוריים לשימוש בתובנות, בפורמט 'yyyy-mm'. אם המדיניות לא מוגדרת, התובנות יוחזרו עבור הנתונים של 30 הימים האחרונים.
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)

הצעה לטירגוט לפי מגדר. אם קיים, למאפיין הזה יש את המאפיין GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

הצעות לפלחי קהל יעד לטירגוט. לכל המאפיינים האלה יש את המאפיין AFFINITY_USER_INTEREST או IN_MARKET_USER_INTEREST
coverage

number

השבר (מ-0 עד 1, כולל) של הקהל המבוקש שניתן להגיע אליו באמצעות הטירגוט המוצע.
index

number

היחס בין הכיסוי לכיסוי של קהל הבסיס, או אפס אם היחס הזה לא מוגדר או לא משמעותי.
potentialYoutubeReach

string (int64 format)

המספר המשוער של אנשים שאפשר להגיע אליהם ב-YouTube באמצעות הטירגוט הזה.