Method: customers.generateAudienceOverlapInsights

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

Lista de errores arrojados: 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

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)

Obligatorio. Es el país en el que se calculan los tamaños y las superposiciones de los públicos.
primaryAttribute

object (AudienceInsightsAttribute)

Obligatorio. El atributo de público que debe cruzarse con todos los demás públicos aptos. Debe ser un interés de usuario en el mercado o afín, un rango de edad o un género.
dimensions[]

enum (AudienceInsightsDimension)

Obligatorio. Los tipos de atributos para los que se calculará la superposición con el principalAttribute. Los valores deben ser un subconjunto de AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE y GENDER.
customerInsightsGroup

string

El nombre del cliente para el que se realiza la planificación. 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)

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

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

DimensionOverlapResult

Es una lista de atributos del 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 posible alcance de YouTube.
potentialYoutubeReachIntersection

string (int64 format)

Es el tamaño estimado de la intersección de este atributo de público con el atributo principal, es decir, la cantidad de usuarios de YouTube a los que se puede llegar y que coinciden TANTO con este atributo como con este.