Method: insights.retrieveInsights

بینش‌های داده‌های بازاریابی را برای یک مقصد مشخص بازیابی می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش 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

اگر روی درست تنظیم شود، سرویس سعی می‌کند به‌طور خودکار موقعیت پایه را برای دریافت اطلاعات شناسایی کند.

مکان

مکان پایه درخواست. مکان پایه در فهرست OR کدهای منطقه ISO 3166-1 alpha-2 مناطق درخواستی قرار دارد.

نمایش JSON 
{
  "regionCodes": [
    string
  ]
}
فیلدها
regionCodes[]

string

فهرست کدهای منطقه‌ای ISO 3166-1 alpha-2.

بازاریابی داده‌ها

بینش‌هایی برای داده‌های بازاریابی.

نمایش JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
فیلدها
dimension

enum ( AudienceInsightsDimension )

بُعدی که بصیرت به آن تعلق دارد.

attributes[]

object ( MarketingDataInsightsAttribute )

بینش‌هایی برای مقادیر یک بعد معین.

بینش مخاطبان (AudienceInsights)

ابعاد ممکن برای استفاده در ایجاد بینش.

انوم‌ها
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED مشخص نشده است.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN مقدار در این نسخه ناشناخته است.
AFFINITY_USER_INTEREST یک کاربر با علاقه‌ی مشترک.
IN_MARKET_USER_INTEREST یک کاربر علاقه‌مند به بازار.
AGE_RANGE یک محدوده سنی.
GENDER یک جنسیت.

ویژگی بینش‌های بازاریابی

بینش‌هایی برای مجموعه‌ای از ویژگی‌های مرتبط با ابعاد یکسان.

نمایش 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 )

جنسیت مخاطبانی که آسانسور برای آنها در نظر گرفته شده است.

محدوده سنی

بازه‌های سنی جمعیتی

انوم‌ها
AGE_RANGE_UNSPECIFIED مشخص نشده است.
AGE_RANGE_UNKNOWN ناشناخته.
AGE_RANGE_18_24 بین ۱۸ تا ۲۴ سال سن.
AGE_RANGE_25_34 بین ۲۵ تا ۳۴ سال سن داشته باشد.
AGE_RANGE_35_44 بین ۳۵ تا ۴۴ سال سن داشته باشد.
AGE_RANGE_45_54 بین ۴۵ تا ۵۴ سال سن دارند.
AGE_RANGE_55_64 بین ۵۵ تا ۶۴ سال سن دارند.
AGE_RANGE_65_UP ۶۵ سال به بالا.

جنسیت

نوع جنسیت‌های جمعیتی (مثلاً زن).

انوم‌ها
GENDER_UNSPECIFIED مشخص نشده است.
GENDER_UNKNOWN ناشناخته.
GENDER_MALE مرد.
GENDER_FEMALE زن