Method: customers.generateInsightsFinderReport

יוצר דוח שמור שיוצג בכלי Insights Finder.

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
שדות
baselineAudience

object (BasicInsightsAudience)

חובה. קהל הבסיס של הדוח הזה, בדרך כלל כל האנשים באזור מסוים.
specificAudience

object (BasicInsightsAudience)

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

string

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

גוף התשובה

הודעת התשובה של AudienceInsightsService.GenerateInsightsFinderReport, שמכילה את כתובת ה-URL שניתנת לשיתוף של הדוח.

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

ייצוג JSON 
{
  "savedReportUrl": string
}
שדות
savedReportUrl

string

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

היקפי הרשאות

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

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

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

BasicInsightsAudience

תיאור של הקהל המשמש לבקשת תובנות.

ייצוג JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
שדות
countryLocation[]

object (LocationInfo)

חובה. המדינות לקהל הזה.
subCountryLocations[]

object (LocationInfo)

מאפייני מיקום גיאוגרפי של מדינות משנה. אם הוא קיים, כל אחד מהפרטים האלה חייב להיכלל באחת מהמדינות בקהל הזה.
gender

object (GenderInfo)

מגדר עבור הקהל. אם השדה הזה חסר, הקהל לא מוגבל לפי מגדר.
ageRanges[]

object (AgeRangeInfo)

טווחי גילאים של הקהל. אם השדה הזה חסר, הקהל מייצג את כל האנשים מעל גיל 18 שתואמים למאפיינים האחרים.
userInterests[]

object (UserInterestInfo)

תחומי העניין של המשתמשים שמגדירים את הקהל הזה. יש תמיכה בקהלים עם תחום עניין משותף ובקהלים עם כוונת רכישה.
topics[]

object (AudienceInsightsTopic)

נושאים שמיוצגים על ידי ישויות של Knowledge Graph ו/או קטגוריות של מוצרים ושירותים, שהקהל הזה מתעניין בהם.

AudienceInsightsTopic

ישות או קטגוריה שמייצגות נושא שמגדיר קהל.

ייצוג JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
שדות
שדה איחוד topic. מאפיין של ישות או קטגוריה. topic יכול להיות רק אחד מהבאים:
entity

object (AudienceInsightsEntity)

ישות ב-Knowledge Graph
category

object (AudienceInsightsCategory)

קטגוריה של מוצר ושירות