Method: customers.generateInsightsFinderReport

יוצר דוח שמור שניתן להציג בכלי Insights Finder.

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

בקשת HTTP

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

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