Method: customers.generateAudienceCompositionInsights

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v17/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)

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של 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 ל-baseAudienceShare, או אפס אם היחס הזה לא מוגדר או שהוא לא משמעותי.
score

number

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

AudienceCompositionAttributeCluster

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

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

string

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

object (AudienceCompositionMetrics)

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

object (AudienceCompositionAttribute)

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