Method: customers.generateSuggestedTargetingInsights

Retorna um conjunto de insights de segmentação (por exemplo, públicos-alvo segmentáveis) relevantes para o público-alvo solicitado.

Lista de erros gerados: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateSuggestedTargetingInsights

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente.

Corpo da solicitação

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

Representação JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Campos
audience

object (InsightsAudience)

Obrigatório. O público-alvo de interesse para o qual os insights estão sendo solicitados.
baselineAudience

object (InsightsAudience)

Opcional. O público-alvo de referência. Se não for especificado, o padrão será todas as pessoas no mesmo país do público-alvo de interesse.
dataMonth

string

Opcional. O intervalo de um mês de dados históricos a serem usados para insights, no formato "aaaa-mm". Se ela não for definida, serão retornados insights referentes aos últimos trinta dias de dados.
customerInsightsGroup

string

Opcional. O nome do cliente para quem está sendo planejado. Esse é um valor definido pelo usuário.

Corpo da resposta

Mensagem de resposta para AudienceInsightsService.GenerateSuggestedTargetingInsights.

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

Representação JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Campos
suggestions[]

object (TargetingSuggestionMetrics)

Insights sugeridos para públicos-alvo segmentáveis.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

TargetingSuggestionMetrics

Um público-alvo segmentável sugerido e relevante para o público-alvo solicitado.

Representação JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Campos
locations[]

object (AudienceInsightsAttributeMetadata)

Segmentação por local sugerida. Todos esses atributos têm a dimensão GEO_TARGET_COUNTRY ou SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

Segmentação por idade sugerida. Pode ficar em branco indicando que não há segmentação por idade.
gender

object (GenderInfo)

Segmentação por gênero sugerida. Se presente, esse atributo tem a dimensão GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Segmentos de público-alvo sugeridos para segmentação. Todos esses atributos têm a dimensão AFFINITY_USER_INTEREST ou IN_MARKET_USER_INTEREST
coverage

number

Fração (de 0 a 1) do público-alvo solicitado que pode ser alcançada usando a segmentação sugerida.
index

number

É a proporção entre a cobertura e o público-alvo de referência, ou zero, se essa proporção for indefinida ou não for significativa.
potentialYoutubeReach

string (int64 format)

O número aproximado de pessoas que podem ser alcançadas no YouTube com essa segmentação.