Method: customers.generateSuggestedTargetingInsights

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v16/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 באמצעות הטירגוט הזה.