Method: insights.retrieveInsights

אחזור של תובנות לגבי נתוני שיווק עבור יעד נתון.

בקשת HTTP

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

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

ייצוג ב-JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
שדות
destination

object (Destination)

חובה. יעד שאליו מאחזרים את התובנות.
baseline

object (Baseline)

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

גוף התשובה

הודעת התגובה של DM API MarketingDataInsightsService.RetrieveInsights

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

ייצוג ב-JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
שדות
marketingDataInsights[]

object (MarketingDataInsight)

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

היקפי הרשאות

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

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

בסיס להשוואה

קריטריונים בסיסיים להשוואה של התובנות.

ייצוג ב-JSON 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
שדות
שדה איחוד baseline. מיקום בסיסי שאליו משווים את התובנות. הערך baseline יכול להיות רק אחד מהבאים:
baselineLocation

object (Location)

מיקום הבסיס של הבקשה. מיקום בסיסי הוא רשימת OR של האזורים המבוקשים.
locationAutoDetectionEnabled

boolean

אם המדיניות מוגדרת כ-True, השירות ינסה לזהות באופן אוטומטי את מיקום הבסיס לתובנות.

מיקום

מיקום הבסיס של הבקשה. מיקום בסיסי נמצא ברשימת OR של קודי אזור לפי תקן ISO 3166-1 alpha-2 של האזורים המבוקשים.

ייצוג ב-JSON 
{
  "regionCodes": [
    string
  ]
}
שדות
regionCodes[]

string

רשימה של קודי אזורים לפי תקן ISO 3166-1 alpha-2.

MarketingDataInsight

תובנות לגבי נתוני שיווק.

ייצוג ב-JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
שדות
dimension

enum (AudienceInsightsDimension)

המאפיין שאליו התובנה שייכת.
attributes[]

object (MarketingDataInsightsAttribute)

תובנות לגבי ערכים של מאפיין נתון.

AudienceInsightsDimension

מאפיינים אפשריים לשימוש ביצירת תובנות.

טיפוסים בני מנייה (enum)
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED לא צוין.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN הערך לא ידוע בגרסה הזו.
AFFINITY_USER_INTEREST ‫UserInterest מסוג Affinity.
IN_MARKET_USER_INTEREST UserInterest עם כוונת רכישה.
AGE_RANGE טווח גילאים.
GENDER מגדר.

MarketingDataInsightsAttribute

תובנות לגבי אוסף של מאפיינים קשורים מאותו מאפיין.

ייצוג ב-JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
שדות
userInterestId

string (int64 format)

מזהה תחום העניין של המשתמש.
lift

number

מדד העלייה שקהל מסוים משיג בערך המאפיין בהשוואה לערך הבסיס. הטווח [0-1].
ageRange

enum (AgeRange)

טווח הגילאים של הקהל שעבורו מוצגות נתוני העלייה.
gender

enum (Gender)

המגדר של הקהל שעבורו מסופקת העלייה.

טווח גילים

טווחי הגילאים הדמוגרפיים

טיפוסים בני מנייה (enum)
AGE_RANGE_UNSPECIFIED לא צוין.
AGE_RANGE_UNKNOWN לא ידוע.
AGE_RANGE_18_24 בגיל 18 עד 24.
AGE_RANGE_25_34 בגיל 25 עד 34.
AGE_RANGE_35_44 בגיל 35 עד 44.
AGE_RANGE_45_54 בגיל 45 עד 54.
AGE_RANGE_55_64 בגיל 55 עד 64.
AGE_RANGE_65_UP בגיל 65 ומעלה.

מגדר

סוג המגדר הדמוגרפי (לדוגמה, נקבה).

טיפוסים בני מנייה (enum)
GENDER_UNSPECIFIED לא צוין.
GENDER_UNKNOWN לא ידוע.
GENDER_MALE גברים.
GENDER_FEMALE נקבה.