Method: accountTypes.accounts.insights.retrieve

检索指定用户名单的营销数据分析。

此功能仅适用于数据合作伙伴。

授权标头：

此方法支持以下可选标头，用于定义 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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。拥有相应用户列表的父账号。格式：accountTypes/{accountType}/accounts/{account}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
字段
baseline

object (Baseline)

必需。所请求数据分析的基准。
userListId

string

必需。请求获取效果分析的用户名单 ID。

响应正文

针对 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 一种有购买意向的用户兴趣。
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 女性。