Method: accountTypes.accounts.insights.retrieve

אחזור תובנות לגבי נתוני שיווק עבור רשימת משתמשים מסוימת.

התכונה הזו זמינה רק לשותפי נתונים.

כותרות הרשאות:

ה-method הזה תומך בכותרות האופציונליות הבאות כדי להגדיר איך ה-API מאשר גישה לבקשה:

  • ‫login-account: (אופציונלי) שם המשאב של החשבון שבו חשבון Google של פרטי הכניסה הוא משתמש. אם לא מגדירים את הפרמטר, ברירת המחדל היא החשבון של הבקשה. פורמט: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • ‫linked-account: (אופציונלי) שם המשאב של החשבון עם קישור מוצר מוגדר אל login-account. פורמט: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

בקשת HTTP

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

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

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

פרמטרים
parent

string

חובה. חשבון ההורה שהוא הבעלים של רשימת המשתמשים. פורמט: accountTypes/{accountType}/accounts/{account}

גוף הבקשה

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

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

object (Baseline)

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

string

חובה. מזהה רשימת המשתמשים שעבורה מתבקשות תובנות.

גוף התשובה

הודעת התגובה של 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 נקבה.