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 に設定すると、サービスは分析情報のベースラインの場所を自動的に検出します。

場所

リクエストのベースライン ロケーション。ベースラインの場所は、リクエストされたリージョンの 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 アフィニティ UserInterest。
IN_MARKET_USER_INTEREST 購買意向の強い UserInterest。
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 女性。