Method: customers.generateAudienceOverlapInsights

Devuelve una colección de atributos de público junto con estimaciones de la superposición entre su alcance potencial en YouTube y el de un atributo de entrada determinado.

Lista de errores generados: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Es obligatorio. El ID del cliente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Campos
countryLocation

object (LocationInfo)

Es obligatorio. Es el país en el que se calcularán los tamaños y las superposiciones de los públicos.
primaryAttribute

object (AudienceInsightsAttribute)

Es obligatorio. Es el atributo de público que se debe cruzar con todos los demás públicos aptos. Debe ser un UserInterest de afinidad o en el mercado, un AgeRange o un Gender.
dimensions[]

enum (AudienceInsightsDimension)

Es obligatorio. Son los tipos de atributos de los que se debe calcular la superposición con primaryAttribute. Los valores deben ser un subconjunto de AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE y GENDER.
customerInsightsGroup

string

Es el nombre del cliente para el que se planifica. Este es un valor definido por el usuario.

Cuerpo de la respuesta

Mensaje de respuesta para AudienceInsightsService.GenerateAudienceOverlapInsights.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Campos
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Metadatos del atributo principal, incluido el alcance potencial de YouTube
dimensionResults[]

object (DimensionOverlapResult)

Son listas de atributos y su superposición con el atributo principal, una lista por dimensión solicitada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

DimensionOverlapResult

Es una lista de atributos de público de una sola dimensión, incluida su superposición con un atributo principal, que se muestra como parte de un GenerateAudienceOverlapInsightsResponse.

Representación JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Campos
dimension

enum (AudienceInsightsDimension)

Es la dimensión de todos los atributos de esta sección.
items[]

object (AudienceOverlapItem)

Los atributos y su superposición con el atributo principal

AudienceOverlapItem

Un atributo de público, con metadatos que incluyen la superposición entre el alcance potencial de YouTube de este atributo y el de un atributo principal.

Representación JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Campos
attributeMetadata

object (AudienceInsightsAttributeMetadata)

El atributo y sus metadatos, incluido el alcance potencial de YouTube
potentialYoutubeReachIntersection

string (int64 format)

Es el tamaño estimado de la intersección de este atributo del público con el atributo principal, es decir, la cantidad de usuarios de YouTube alcanzables que coinciden CON EL ATRIBUTO PRINCIPAL Y CON ESTE.