Method: insights.retrieveInsights

擷取指定目的地的行銷資料洞察資訊。

HTTP 要求

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

這個網址使用 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

如果設為 true，服務會嘗試自動偵測洞察資料的基準位置。

位置

要求的基準位置。基準位置位於所要求地區的 ISO 3166-1 alpha-2 地區代碼 OR 清單中。

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

可用於產生洞察資料的維度。

列舉
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED 不指定。
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN 這個版本不含這個值。
AFFINITY_USER_INTEREST 興趣相似使用者興趣。
IN_MARKET_USER_INTEREST 潛在目標消費者興趣。
AGE_RANGE 年齡層。
GENDER 性別。

MarketingDataInsightsAttribute

同一維度相關屬性集合的洞察資料。

JSON 表示法 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
欄位
userInterestId

string (int64 format)

使用者興趣 ID。
lift

number

與基準相比，目標對象的屬性值升幅。範圍 [0-1]。
ageRange

enum (AgeRange)

提供升幅資料的目標對象年齡層。
gender

enum (Gender)

提供升幅的目標對象性別。

年齡層

客層年齡範圍

列舉
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 歲以上。

性別

客層性別類型 (例如女性)。

列舉
GENDER_UNSPECIFIED 不指定。
GENDER_UNKNOWN 不明。
GENDER_MALE 男性。
GENDER_FEMALE 女性。