Method: insights.retrieveInsights

Recupera insights de dados de marketing para um determinado destino.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Campos
destination

object (Destination)

Obrigatório. O destino para recuperar os insights.
baseline

object (Baseline)

Obrigatório. Valor de referência para os insights solicitados.

Corpo da resposta

Mensagem de resposta para DM API MarketingDataInsightsService.RetrieveInsights

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Campos
marketingDataInsights[]

object (MarketingDataInsight)

Contém os insights dos dados de marketing.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/datamanager

Valor de referência

Critérios de comparativo de mercado com que os insights são comparados.

Representação 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.
}
Campos
Campo de união baseline. Local de referência com que os insights são comparados. baseline pode ser apenas de um dos tipos a seguir:
baselineLocation

object (Location)

O local de referência da solicitação. O local de referência é uma lista OR das regiões solicitadas.
locationAutoDetectionEnabled

boolean

Se definido como "true", o serviço tentará detectar automaticamente o local de base para insights.

Local

O local de referência da solicitação. O local de referência está na lista OR de códigos de região ISO 3166-1 alpha-2 das regiões solicitadas.

Representação JSON 
{
  "regionCodes": [
    string
  ]
}
Campos
regionCodes[]

string

Lista de códigos de região ISO 3166-1 alfa-2.

MarketingDataInsight

Insights para dados de marketing.

Representação JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Campos
dimension

enum (AudienceInsightsDimension)

A dimensão a que o insight pertence.
attributes[]

object (MarketingDataInsightsAttribute)

Insights para valores de uma determinada dimensão.

AudienceInsightsDimension

Dimensões possíveis para uso na geração de insights.

Tipos enumerados
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Não especificado.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN O valor é desconhecido nesta versão.
AFFINITY_USER_INTEREST Um UserInterest de afinidade.
IN_MARKET_USER_INTEREST Um UserInterest no mercado.
AGE_RANGE Uma faixa etária.
GENDER Um gênero.

MarketingDataInsightsAttribute

Insights para um conjunto de atributos relacionados da mesma dimensão.

Representação JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Campos
userInterestId

string (int64 format)

O ID do interesse do usuário.
lift

number

Medida do Lift que o público-alvo tem para o valor do atributo em comparação com o valor de referência. Intervalo [0-1].
ageRange

enum (AgeRange)

Faixa etária do público-alvo para o qual o Lift é fornecido.
gender

enum (Gender)

Gênero do público-alvo para o qual o Lift é fornecido.

Faixa etária

As faixas etárias demográficas

Tipos enumerados
AGE_RANGE_UNSPECIFIED Não especificado.
AGE_RANGE_UNKNOWN Desconhecido.
AGE_RANGE_18_24 Entre 18 e 24 anos.
AGE_RANGE_25_34 Entre 25 e 34 anos.
AGE_RANGE_35_44 Entre 35 e 44 anos.
AGE_RANGE_45_54 Entre 45 e 54 anos.
AGE_RANGE_55_64 Entre 55 e 64 anos.
AGE_RANGE_65_UP 65 anos ou mais.

Gênero

O tipo de gênero demográfico (por exemplo, feminino).

Tipos enumerados
GENDER_UNSPECIFIED Não especificado.
GENDER_UNKNOWN Desconhecido.
GENDER_MALE Masculino.
GENDER_FEMALE Feminino.