Method: customers.recommendations.generate

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

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

Requête HTTP

POST https://googleads.googleapis.com/v17/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 qui génère 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 à fournir une recommandation ou si la campagne est déjà à l'état recommandé, aucune recommandation n'est renvoyée pour ce type. En règle générale, une recommandation s'affiche si tous les champs obligatoires pour ce type de recommandation sont importés, mais dans certains cas, cela n'est toujours pas suffisant.

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 AdvertisingChannelTypes suivants sont compatibles avec 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 recommandationsTypes suivants: KEYWORD
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 actuelles sur les enchères 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 sources pour les mots clés. Ce champ est obligatoire pour les types de recommandations suivants: KEYWORD

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 l'ensemble transmis dans l'ensemble des RecommendationsTypes demandés. Si les données sont insuffisantes pour générer une recommandation pour les recommandationsTypes demandés, l'ensemble de résultats ne contiendra aucune recommandation pour ce type.

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 actuelles sur les enchères 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. Détails facultatifs concernant le type de stratégie d'enchères bidding_strategy_type. 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 vous souhaitez générer des idées, par exemple "voitures" ou "concessionnaire automobile à proximité".
urlSeed

string

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