Method: customers.recommendations.generate

Genera recomendaciones basadas en 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 aptos para generar. Si los criterios subidos no son suficientes para hacer una recomendación o la campaña ya se encuentra 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 recomendaciones para la generación de recomendaciones: KEYWORD, MAXIMIZE_Clics_OPT_IN, MAXIMIZE_conversions_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_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 publicitario de la campaña. Se admiten los siguientes AdvertisingChannelTypes para la generación de recomendaciones: PERFORMANCE_MAX y SEARCH.
adGroupInfo[]

object (AdGroupInfo)

Opcional. Información del grupo de anuncios actual. 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 los siguientes recommendationTypes: MAXIMIZE_ evento_click, 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. Información actual sobre las ofertas de la campaña Este campo es necesario para los siguientes recommendationTypes: MAXIMIZE_ evento_click, 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 de origen para las palabras clave. Este campo es necesario para los siguientes 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)

Lista de recomendaciones generadas a partir del conjunto aprobado de recommendationTypes solicitados. Si no hay datos suficientes para generar una recomendación para los recommendationTypes solicitados, el conjunto de resultados no contendrá una recomendación para ese tipo.

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.

BiddingInfo

Información actual sobre las ofertas de la campaña Proporciona un wrapper para los indicadores relacionados con las ofertas que fundamentan 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_ evento_click, 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. Este valor se puede propagar para campañas que tengan el tipo de estrategia de ofertas TARGET_CPA o MAXIMIZE_conversions.
targetRoas

number

ROAS objetivo actual. Puede propagarse para campañas que tengan un tipo de estrategia de ofertas TARGET_ROAS o MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Información del grupo de anuncios actual 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 adGroupInfo está configurado: KEYWORD
adGroupType

enum (AdGroupType)

Opcional. Es el tipo de grupo de anuncios del grupo de anuncios. Si se estableció adGroupInfo, este campo es necesario para los siguientes recommendationTypes: KEYWORD

SeedInfo

Un valor inicial de palabra clave y una URL específica a partir de la cual generar las 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: autos o "concesionario de autos cerca de mí"
urlSeed

string

Una URL específica a partir de la cual generar ideas, por ejemplo: www.example.com/automóviles