Method: customers.recommendations.generate

Genera recomendaciones según los recommendationTypes solicitados.

Lista de errores arrojados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

Solicitud HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate

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 que genera recomendaciones.

Cuerpo de la solicitud

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

Representación JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Campos
recommendationTypes[]

enum (RecommendationType)

Obligatorio. Lista de recommendationTypes aptas para generar. Si los criterios subidos no son suficientes para realizar una recomendación o si la campaña ya está en el estado recomendado, no se mostrará ninguna recomendación para ese tipo. Por lo general, se muestra una recomendación si se suben todos los campos obligatorios para ese recommendationType, pero hay casos en los que esto no es suficiente.

Se admiten los siguientes tipos de recomendación para la generación de recomendaciones: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

Obligatorio. Es el tipo de canal de publicidad de la campaña. Los siguientes advertisingChannelTypes son compatibles para la generación de recomendaciones: PERFORMANCE_MAX y SEARCH
adGroupInfo[]

object (AdGroupInfo)

Opcional. Información actual del grupo de anuncios. Admite información de un solo grupo de anuncios. Este campo es opcional para los siguientes recommendationTypes: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opcional. Estado actual del seguimiento de conversiones. Este campo es necesario para las siguientes opciones de recomendación: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.
biddingInfo

object (BiddingInfo)

Opcional. Es la información de ofertas actual de la campaña. Este campo es necesario para las siguientes opciones de recomendación: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.
seedInfo

object (SeedInfo)

Opcional. Información inicial para las palabras clave. Este campo es necesario para el siguiente recommendationTypes: KEYWORD

Cuerpo de la respuesta

Mensaje de respuesta para RecommendationService.GenerateRecommendations.

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

Representación JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Campos
recommendations[]

object (Recommendation)

Es la lista de recomendaciones generadas a partir del conjunto pasado de recommendationTypes solicitados. Si no hay datos suficientes para generar una recomendación para el recommendationTypes solicitado, el conjunto de resultados no contendrá una recomendación para ese tipo.

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.

BiddingInfo

Información sobre las ofertas actuales de la campaña. Proporciona un wrapper para los indicadores relacionados con las ofertas que informan las recomendaciones.

Representación JSON 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
Campos
biddingStrategyType

enum (BiddingStrategyType)

Estrategia de ofertas actual. Este campo es necesario para los siguientes recommendationTypes: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
Campo de unión bidding_strategy_target_info. Detalles opcionales relacionados con bidding_strategy_type. Las direcciones (bidding_strategy_target_info) solo pueden ser una de las siguientes opciones:
targetCpaMicros

string (int64 format)

CPA objetivo actual en micros Puede completar esta información para las campañas que tengan un tipo de estrategia de ofertas de TARGET_CPA o MAXIMIZE_CONVERSIONS.
targetRoas

number

TargetRoas actual. Puede completar esta información para las campañas que tengan un tipo de estrategia de ofertas de TARGET_ROAS o MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Es la información actual del grupo de anuncios de la campaña.

Representación JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Campos
keywords[]

object (KeywordInfo)

Opcional. Palabras clave actuales Este campo es opcional para los siguientes recommendationTypes si se configura adGroupInfo: KEYWORD
adGroupType

enum (AdGroupType)

Opcional. Es el tipo de grupo de anuncios del grupo de anuncios. Este campo es necesario para el siguiente recommendationTypes si se establece adGroupInfo: KEYWORD

SeedInfo

Un valor inicial de palabra clave y una URL específica para generar palabras clave.

Representación JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Campos
keywordSeeds[]

string

Opcional. Palabras clave o frases a partir de las cuales generar ideas, por ejemplo: automóviles o "concesionario de automóviles cerca de mí".
urlSeed

string

Una URL específica para generar ideas, por ejemplo: www.example.com/automóviles.