Method: customers.generateAudienceOverlapInsights

Retorna uma coleção de atributos de público-alvo com estimativas da sobreposição entre o alcance potencial do YouTube e o de um determinado atributo de entrada.

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

Solicitação HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

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 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Campos
countryLocation

object (LocationInfo)

Obrigatório. O país em que os tamanhos e as sobreposições dos públicos-alvo são calculados.
primaryAttribute

object (AudienceInsightsAttribute)

Obrigatório. O atributo de público-alvo que precisa ser cruzado com todos os outros públicos-alvo qualificados. Precisa ser um interesse do usuário de afinidade ou no mercado, uma faixa etária ou um gênero.
dimensions[]

enum (AudienceInsightsDimension)

Obrigatório. Os tipos de atributos para calcular a sobreposição com o atributo principal. Os valores precisam ser um subconjunto de AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE e GENDER.
customerInsightsGroup

string

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

Corpo da resposta

Mensagem de resposta para AudienceInsightsService.GenerateAudienceOverlapInsights.

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

Representação JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Campos
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Metadados do atributo principal, incluindo o possível alcance do YouTube.
dimensionResults[]

object (DimensionOverlapResult)

Listas de atributos e sobreposição com o atributo principal, uma lista por dimensão solicitada.

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.

DimensionOverlapResult

Uma lista de atributos de público-alvo de uma única dimensão, incluindo a sobreposição com um atributo principal, retornada como parte de um GenerateAudienceOverlapInsightsResponse.

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

enum (AudienceInsightsDimension)

A dimensão de todos os atributos nesta seção.
items[]

object (AudienceOverlapItem)

Os atributos e a sobreposição deles com o atributo principal.

AudienceOverlapItem

Um atributo de público-alvo, com metadados que incluem a sobreposição entre o potencial de alcance do YouTube desse atributo e o de um atributo principal.

Representação JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Campos
attributeMetadata

object (AudienceInsightsAttributeMetadata)

O atributo e os metadados dele, incluindo o possível alcance no YouTube.
potentialYoutubeReachIntersection

string (int64 format)

O tamanho estimado da interseção desse atributo de público-alvo com o atributo principal, ou seja, o número de usuários do YouTube alcançáveis que correspondem AO ATRIBUTO PRINCIPAL E A ESTE.