- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- TargetingSuggestionMetrics
- Pruébala
Muestra una colección de estadísticas de segmentación (p.ej., públicos para los que se pueden segmentar anuncios) 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/v16/customers/{customerId}:generateSuggestedTargetingInsights
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
audience |
Obligatorio. Es el público de interés para el que se solicitan estadísticas. |
baselineAudience |
Opcional. El público de referencia. El valor predeterminado, si no se especifica, es todas las personas del mismo país que el público de interés. |
dataMonth |
Opcional. Es 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 |
Opcional. 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.GenerateSuggestedTargetingInsights
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"suggestions": [
{
object ( |
Campos | |
---|---|
suggestions[] |
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
Es un público objetivo sugerido y relevante para el público solicitado.
Representación JSON |
---|
{ "locations": [ { object ( |
Campos | |
---|---|
locations[] |
Segmentación geográfica sugerida Todos estos atributos tienen la dimensión GEO_TARGET_COUNTRY o SUB_COUNTRY_LOCATION. |
ageRanges[] |
Segmentación por edad sugerida. Puede estar vacía, lo que indica que no hay segmentación por edad. |
gender |
Segmentación por género sugerida. Si está presente, este atributo tiene la dimensión GENDER. |
userInterests[] |
Segmentos de público sugeridos a los cuales segmentar sus anuncios. Todos estos atributos tienen la dimensión AFFINITY_USER_INTEREST o IN_MARKET_USER_INTEREST |
coverage |
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 |
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 |
Es la cantidad aproximada de personas a las que se puede llegar en YouTube con esta segmentación. |