Method: customers.generateSuggestedTargetingInsights

Muestra una colección de estadísticas de segmentación (p.ej., públicos a los que se puede orientar) que son relevantes para el público solicitado.

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

Solicitud HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateSuggestedTargetingInsights

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,
  "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)

Opcional. El público de referencia. Si no se especifica, el valor predeterminado es todas las personas del mismo país que el público de interés.
dataMonth

string

Opcional. 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.
customerInsightsGroup

string

Opcional. 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.GenerateSuggestedTargetingInsights.

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

Representación JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Campos
suggestions[]

object (TargetingSuggestionMetrics)

Estadísticas sugeridas para los públicos a los que puedes orientar los anuncios.

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.

TargetingSuggestionMetrics

Un público objetivo sugerido que es relevante para el público solicitado.

Representación JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Campos
locations[]

object (AudienceInsightsAttributeMetadata)

Segmentación geográfica sugerida Todos estos atributos tienen la dimensión GEO_TARGET_COUNTRY o SUB_COUNTRY_LOCATION.
ageRanges[]

object (AgeRangeInfo)

Segmentación por edad sugerida. Puede estar vacía, lo que indica que no hay segmentación por edad.
gender

object (GenderInfo)

Segmentación por género sugerida Si está presente, este atributo tiene la dimensión GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Segmentos de público sugeridos a los que se pueden orientar los anuncios. Todos estos atributos tienen la dimensión AFFINITY_USER_INTEREST o IN_MARKET_USER_INTEREST
coverage

number

Es la fracción (de 0 a 1 inclusive) del público solicitado a la que se puede llegar mediante la segmentación sugerida.
index

number

Es la proporción entre la cobertura y la cobertura del público de referencia, o cero si esta proporción no está definida o no es significativa.
potentialYoutubeReach

string (int64 format)

Es la cantidad aproximada de personas a las que se puede llegar en YouTube con esta segmentación.