- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- TargetingSuggestionMetrics
- Faça um teste
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/v16/customers/{customerId}:generateSuggestedTargetingInsights
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
audience |
Obrigatório. O público-alvo de interesse para o qual os insights estão sendo solicitados. |
baselineAudience |
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 |
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 30 dias de dados. |
customerInsightsGroup |
Opcional. O nome do cliente para quem está 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 ( |
Campos | |
---|---|
suggestions[] |
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 ( |
Campos | |
---|---|
locations[] |
Segmentação por local sugerida. Todos esses atributos têm a dimensão GEO_TARGET_COUNTRY ou SUB_COUNTRY_LOCATION |
ageRanges[] |
Segmentação por idade sugerida. Pode estar em branco indicando que não há segmentação por idade. |
gender |
Segmentação sugerida por gênero. Se estiver presente, esse atributo terá a dimensão GENDER. |
userInterests[] |
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 |
Fração (de 0 a 1) do público-alvo solicitado que pode ser alcançado usando a segmentação sugerida. |
index |
A proporção entre a cobertura e a cobertura do público-alvo de referência, ou zero, se essa proporção for indefinida ou não for significativa. |
potentialYoutubeReach |
O número estimado de pessoas que podem ser alcançadas no YouTube com essa segmentação. |