Method: customers.generateInsightsFinderReport

Cria um relatório salvo que pode ser visualizado na ferramenta Insights Finder.

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

Solicitação HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

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 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Campos
baselineAudience

object (BasicInsightsAudience)

Obrigatório. Um público-alvo de referência para este relatório, normalmente todas as pessoas de uma região.
specificAudience

object (BasicInsightsAudience)

Obrigatório. O público específico de interesse desse relatório. Os insights do relatório terão como base os atributos mais comuns nesse público-alvo do que no público-alvo de referência.
customerInsightsGroup

string

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

Corpo da resposta

A mensagem de resposta para AudienceInsightsService.GenerateInsightsFinderReport, contendo o URL compartilhável do relatório.

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

Representação JSON 
{
  "savedReportUrl": string
}
Campos
savedReportUrl

string

Um URL HTTPS que fornece um link direto para a interface do Insights Finder com as entradas do relatório preenchidas de acordo com a solicitação.

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.

BasicInsightsAudience

É a descrição de um público-alvo usado para solicitar insights.

Representação JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Campos
countryLocation[]

object (LocationInfo)

Obrigatório. Os países para este público-alvo.
subCountryLocations[]

object (LocationInfo)

Atributos de localização geográfica de sub-países. Caso esteja presente, cada um deles precisa estar em um dos países desse público-alvo.
gender

object (GenderInfo)

Gênero para o público-alvo. Se ausente, o público-alvo não vai fazer a restrição por gênero.
ageRanges[]

object (AgeRangeInfo)

Faixas etárias do público-alvo. Se ausente, o público-alvo vai representar todas as pessoas maiores de 18 anos que correspondem aos outros atributos.
userInterests[]

object (UserInterestInfo)

Interesses dos usuários que definem esse público-alvo. Os públicos-alvo no mercado e de afinidade são compatíveis.
topics[]

object (AudienceInsightsTopic)

Tópicos, representados por entidades do Mapa de informações e/ou categorias de produtos e serviços em que esse público-alvo está interessado.

AudienceInsightsTopic

Uma entidade ou categoria que representa um tópico que define um público-alvo.

Representação JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Campos
Campo de união topic. Um atributo de entidade ou categoria. topic pode ser apenas de um dos tipos a seguir:
entity

object (AudienceInsightsEntity)

Uma entidade do Mapa de informações
category

object (AudienceInsightsCategory)

Uma categoria de produtos e serviços