Method: customers.recommendations.generate

Génère des recommandations en fonction des recommendationTypes demandés.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client générant des recommandations.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Champs
recommendationTypes[]

enum (RecommendationType)

Obligatoire. Liste des types de recommandations éligibles à générer. Si les critères importés ne suffisent pas à formuler une recommandation ou si la campagne est déjà dans l'état "Recommandée", aucune recommandation ne sera renvoyée pour ce type. En règle générale, une recommandation est renvoyée si tous les champs obligatoires pour ce type de recommandation sont importés, mais il arrive que cela ne suffise pas.

Les types de recommandations suivants sont compatibles avec la génération de recommandations: KEYWORD, MAXIMIZE_CLICKS_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)

Obligatoire. Type de canal publicitaire de la campagne. Les types advertisingChannelTypes suivants sont acceptés pour la génération de recommandations : PERFORMANCE_MAX et SEARCH
adGroupInfo[]

object (AdGroupInfo)

Facultatif. Informations actuelles sur le groupe d'annonces. Prend en charge les informations d'un seul groupe d'annonces. Ce champ est facultatif pour les types de recommandations suivants : MOT-CLÉ
conversionTrackingStatus

enum (ConversionTrackingStatus)

Facultatif. État actuel du suivi des conversions. Ce champ est obligatoire pour les types de recommandations suivants: 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)

Facultatif. Informations sur les enchères actuelles de la campagne. Ce champ est obligatoire pour les types de recommandations suivants : 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)

Facultatif. Informations de base pour les mots clés. Ce champ est obligatoire pour les types de recommandations suivants : MOT-CLÉ

Corps de la réponse

Message de réponse pour RecommendationService.GenerateRecommendations.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Champs
recommendations[]

object (Recommendation)

Liste des recommandations générées à partir de la transmission de l'ensemble des recommandationsTypes demandés. Si les données ne sont pas suffisantes pour générer une recommandation pour les recommandationsTypes demandés, aucune recommandation pour ce type ne s'affichera dans l'ensemble de résultats.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

BiddingInfo

Informations sur les enchères actuelles de la campagne. Fournit un wrapper pour les signaux liés aux enchères qui guident les recommandations.

Représentation 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.
}
Champs
biddingStrategyType

enum (BiddingStrategyType)

Stratégie d'enchères actuelle. Ce champ est obligatoire pour les types de recommandations suivants: 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
Champ d'union bidding_strategy_target_info. Informations facultatives concernant le type de stratégie d'enchères. bidding_strategy_target_info ne peut être qu'un des éléments suivants :
targetCpaMicros

string (int64 format)

CPA cible actuel en micros. Ce champ peut être renseigné pour les campagnes dont la stratégie d'enchères est de type TARGET_CPA ou MAXIMIZE_CONVERSIONS.
targetRoas

number

ROAS cible actuel. Ce champ peut être renseigné pour les campagnes dont la stratégie d'enchères est de type TARGET_ROAS ou MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Informations actuelles sur le groupe d'annonces de la campagne.

Représentation JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Champs
keywords[]

object (KeywordInfo)

Facultatif. Mots clés actuels. Ce champ est facultatif pour les recommandationsTypes suivants si adGroupInfo est défini: KEYWORD
adGroupType

enum (AdGroupType)

Facultatif. Type de groupe d'annonces. Ce champ est obligatoire pour les recommandationsType suivantes si adGroupInfo est défini: KEYWORD

SeedInfo

Source du mot clé et URL spécifique à partir de laquelle générer les mots clés.

Représentation JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Champs
keywordSeeds[]

string

Facultatif. Mots clés ou expressions à partir desquels générer des idées, par exemple : "voitures" ou "concession automobile à proximité".
urlSeed

string

Une URL spécifique à partir de laquelle générer des idées, par exemple: www.example.com/voitures