Method: customers.generateAudienceCompositionInsights

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח.

גוף הבקשה

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

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

object (InsightsAudience)

חובה. קהל העניין שלגביו יש בקשה לתובנות.
baselineAudience

object (InsightsAudience)

קהל הבסיס שאליו מתבצעת השוואה של קהל העניין.
dataMonth

string

טווח של נתונים היסטוריים לחודש אחד שבהם המערכת תשתמש כדי לקבל תובנות, בפורמט "yyyy-mm". אם המדיניות לא מוגדרת, יוצגו תובנות מ-30 הימים האחרונים.
dimensions[]

enum (AudienceInsightsDimension)

חובה. מאפייני הקהל שעבורם יש להחזיר את מדדי ההרכב.
customerInsightsGroup

string

שם הלקוח המתוכנן. זהו ערך בהגדרת המשתמש.

גוף התשובה

הודעת תשובה לגבי AudienceInsightsService.GenerateAudienceCompositionInsights.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
שדות
sections[]

object (AudienceCompositionSection)

התוכן של דוח התובנות, מסודר לפי קטעים. כל קטע משויך לאחד מהערכים של AudienceInsightsInsights בבקשה. לכל מאפיין יכול להיות יותר מקטע אחד.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

AudienceCompositionSection

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

ייצוג JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
שדות
dimension

enum (AudienceInsightsDimension)

סוג המאפיינים בקטע הזה.
topAttributes[]

object (AudienceCompositionAttribute)

הפלחים הכי רלוונטיים לקהל הזה. אם המאפיין הוא GENDER, AGE_RANGE או PARENTAL_STATUS, רשימת המאפיינים הזו היא חלקית.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

מאפיינים נוספים לקהל הזה, מקובצים לאשכולות. יאוכלס רק אם המאפיין הוא YOUTUBE_CHANNEL.

AudienceCompositionAttribute

מאפיין קהל עם מטא-נתונים ומדדים.

ייצוג JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
שדות
attributeMetadata

object (AudienceInsightsAttributeMetadata)

המאפיין עם המטא-נתונים שלו.
metrics

object (AudienceCompositionMetrics)

שיתוף והוספה לאינדקס של מדדי המאפיין.

AudienceCompositionMetrics

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

ייצוג JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
שדות
baselineAudienceShare

number

השבר (מ-0 עד 1 כולל) של קהל הבסיס שתואם למאפיין.
audienceShare

number

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

number

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

number

ציון רלוונטיות מ-0 עד 1, כולל.

AudienceCompositionAttributeCluster

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

ייצוג JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
שדות
clusterDisplayName

string

השם של אשכול המאפיינים הזה
clusterMetrics

object (AudienceCompositionMetrics)

אם המאפיין המשויך לאשכול הזה הוא YOUTUBE_CHANNEL, clusterMetrics הם מדדים שמשויכים לאשכול כולו. למאפיינים אחרים, השדה הזה לא מוגדר.
attributes[]

object (AudienceCompositionAttribute)

המאפיינים הנפרדים שמרכיבים את האשכול הזה, עם מטא-נתונים ומדדים.