Method: customers.recommendations.generate

Génère des recommandations en fonction des types de recommandations 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 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 pour émettre une recommandation, ou si la campagne est déjà à l'état recommandé, aucune recommandation ne s'affichera 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 dans certains cas, ce n'est pas suffisant.

Les types de recommandations suivants sont acceptés pour la génération de recommandations: 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)

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 relatives aux groupes d'annonces actuels. Accepte les informations provenant d'un seul groupe d'annonces. Ce champ est facultatif pour les types de recommandations suivants: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Facultatif. État actuel du suivi des conversions. Ce champ est nécessaire pour les types de recommandations suivants: MAXIMIZE_ maintenant_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN et TARGET_ROAS_OPT_IN.
biddingInfo

object (BiddingInfo)

Facultatif. Informations actuelles sur les enchères de la campagne. Ce champ est nécessaire pour les types de recommandations suivants: MAXIMIZE_ maintenant_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN et TARGET_ROAS_OPT_IN.
seedInfo

object (SeedInfo)

Facultatif. Informations sources pour les mots clés. Ce champ est nécessaire 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 de recommandations de types demandés transmis. Si la quantité de données est insuffisante pour générer une recommandation pour les types de recommandation 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 servent de base aux 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 nécessaire pour les types de recommandations suivants: MAXIMIZE_ maintenant_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN et TARGET_ROAS_OPT_IN.
Champ d'union bidding_strategy_target_info. Détails facultatifs concernant le paramètre "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. Vous pouvez renseigner ce champ pour les campagnes dont le type de stratégie d'enchères est "TARGET_CPA" ou "MAXIMIZE_CONVERSIONS".
targetRoas

number

Valeur targetRoas actuelle. Vous pouvez renseigner ce champ pour les campagnes dont le type de stratégie d'enchères est "TARGET_ROAS" ou "MAXIMIZE_CONVERSION_VALUE".

AdGroupInfo

Informations sur le groupe d'annonces actuel 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 suivantes si adGroupInfo est défini: KEYWORD
adGroupType

enum (AdGroupType)

Facultatif. Type de groupe d'annonces. Ce champ est nécessaire pour les types de recommandations suivants si adGroupInfo est défini: KEYWORD.

SeedInfo

Un mot clé source et une 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 permettant de générer des idées (par exemple, "voitures" ou "concessionnaire automobile à proximité").
urlSeed

string

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