Method: customers.generateAudienceCompositionInsights

Muestra una colección de atributos que se representan en un público de interés, con métricas que comparan la porción del público de cada atributo con su porcentaje del público de referencia.

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

Solicitud HTTP

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

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 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Campos
audience

object (InsightsAudience)

Obligatorio. Es el público de interés para el que se solicitan las estadísticas.
baselineAudience

object (InsightsAudience)

Es el público de referencia con el que se compara el público de interés.
dataMonth

string

El rango de datos históricos de un mes que se usará para las estadísticas, en el formato “aaaa-mm”. Si no la estableces, se mostrarán estadísticas de los últimos treinta días.
dimensions[]

enum (AudienceInsightsDimension)

Obligatorio. Son las dimensiones de público para las que se deben mostrar las estadísticas de composición.
customerInsightsGroup

string

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.GenerateAudienceCompositionInsights.

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

Representación JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Campos
sections[]

object (AudienceCompositionSection)

Es el contenido del informe de estadísticas organizado en secciones. Cada sección está asociada con uno de los valores de AudienceInsightsDimension en la solicitud. Puede haber más de una sección por dimensión.

Permisos 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.

InsightsAudience

Es un conjunto de usuarios, definidos por varias características, para el que se pueden solicitar estadísticas en AudienceInsightsService.

Representación JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Campos
countryLocations[]

object (LocationInfo)

Obligatorio. Los países para el público.
subCountryLocations[]

object (LocationInfo)

Atributos de ubicación geográfica de subpaíses. Si están presentes, cada uno de ellos debe estar incluido en uno de los países de este público. Si está ausente, el público se dirige geográficamente a countryLocations, pero no más allá.
gender

object (GenderInfo)

El género del público. Si está ausente, el público no establece restricciones por género.
ageRanges[]

object (AgeRangeInfo)

Rangos de edad del público Si está ausente, el público representa a todas las personas mayores de 18 años que coinciden con los otros atributos.
parentalStatus

object (ParentalStatusInfo)

Estado parental del público Si está ausente, el público no se restringe por estado parental.
incomeRanges[]

object (IncomeRangeInfo)

Rangos de percentiles del ingreso familiar del público. Si está ausente, el público no restringe el rango de ingresos familiares.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Selecciones de contenido dinámicas que representen el contenido de YouTube que vio el público
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Es una combinación de atributos de entidad, categoría y interés del usuario que definen el público. La combinación tiene una estructura lógica con los operadores Y de O: los atributos de cada InsightsAudienceAttributeGroup se combinan con OR, y las combinaciones en sí se combinan con AND. Por ejemplo, la expresión (Entidad O afinidad) Y (Público OR categoría) se puede formar usando dos InsightsAudienceAttributeGroups con dos atributos cada uno.

InsightsAudienceAttributeGroup

Una lista de AudienceInsightsAttributes.

Representación JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Campos
attributes[]

object (AudienceInsightsAttribute)

Obligatorio. Es una colección de atributos de público que se combinarán con el operador lógico OR. No es necesario que todos los atributos tengan la misma dimensión. En este contexto, solo se admiten las entidades del Gráfico de conocimiento, las categorías de productos y servicios, y los públicos afines y en el mercado.

AudienceCompositionSection

Es una colección de atributos relacionados del mismo tipo en un informe de estadísticas de composición del público.

Representación JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Campos
dimension

enum (AudienceInsightsDimension)

Es el tipo de atributos en esta sección.
topAttributes[]

object (AudienceCompositionAttribute)

Son los segmentos más relevantes para este público. Si la dimensión es GENDER, AGE_RANGE o PARENTAL_STATUS, esta lista de atributos es exhaustiva.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Atributos adicionales para este público, agrupados en clústeres. Solo se completa si la dimensión es YOUTUBE_CHANNEL.

AudienceCompositionAttribute

Un atributo de público con metadatos y métricas.

Representación JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Campos
attributeMetadata

object (AudienceInsightsAttributeMetadata)

El atributo con sus metadatos
metrics

object (AudienceCompositionMetrics)

Indexa y comparte las métricas del atributo.

AudienceCompositionMetrics

Son las métricas de índice y porcentaje asociadas con un atributo en un informe de estadísticas de composición del público.

Representación JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Campos
baselineAudienceShare

number

Es la fracción (de 0 a 1 inclusive) del público de referencia que coincide con el atributo.
audienceShare

number

Es la fracción (de 0 a 1 inclusive) del público específico que coincide con el atributo.
index

number

Es la proporción entre AudienceShare y baselineAudienceShare, o cero si esta proporción no está definida o no es significativa.
score

number

Una puntuación de relevancia de 0 a 1 inclusive.

AudienceCompositionAttributeCluster

Una colección de atributos relacionados, con metadatos y métricas, en un informe de estadísticas de composición del público.

Representación JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Campos
clusterDisplayName

string

El nombre de este clúster de atributos
clusterMetrics

object (AudienceCompositionMetrics)

Si la dimensión asociada con este clúster es YOUTUBE_CHANNEL, los clusterMetrics son métricas asociadas con el clúster en su totalidad. Para otras dimensiones, este campo no está establecido.
attributes[]

object (AudienceCompositionAttribute)

Los atributos individuales que conforman este clúster, con metadatos y métricas.