Method: customers.recommendations.generate

Generiert Empfehlungen auf Basis der angeforderten Empfehlungstypen.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden, der Empfehlungen generiert.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Felder
recommendationTypes[]

enum (RecommendationType)

Erforderlich. Liste der zu generierenden Empfehlungstypen, die generiert werden können. Wenn die hochgeladenen Kriterien nicht ausreichen, um eine Empfehlung zu geben, oder sich die Kampagne bereits im empfohlenen Status befindet, wird für diesen Typ keine Empfehlung zurückgegeben. Im Allgemeinen wird eine Empfehlung zurückgegeben, wenn alle erforderlichen Felder für diesen „RecommendationType“ hochgeladen wurden. In einigen Fällen reicht dies jedoch immer noch nicht aus.

Die folgenden Empfehlungstypen werden für die Generierung von Empfehlungen unterstützt: KEYWORD, MAXIMIZE_KLICKS_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)

Erforderlich. Werbekanaltyp der Kampagne. Die folgenden AdvertisingChannelTypes werden für die Empfehlungsgenerierung unterstützt: PERFORMANCE_MAX und SEARCH.
adGroupInfo[]

object (AdGroupInfo)

Optional. Aktuelle Informationen zur Anzeigengruppe Unterstützt Informationen aus einer einzelnen Anzeigengruppe. Dieses Feld ist für die folgenden Empfehlungstypen optional: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Optional. Aktueller Status des Conversion-Trackings. Dieses Feld ist für die folgenden Empfehlungstypen erforderlich: MAXIMIZE_KLICKS_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)

Optional. Aktuelle Gebotsinformationen der Kampagne. Dieses Feld ist für die folgenden Empfehlungstypen erforderlich: MAXIMIZE_KLICKS_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)

Optional. Quellinformationen für Keywords Dieses Feld ist für die folgenden Empfehlungstypen erforderlich: KEYWORD

Antworttext

Antwortnachricht für RecommendationService.GenerateRecommendations.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Felder
recommendations[]

object (Recommendation)

Liste der generierten Empfehlungen aus der Gruppe von angeforderten Empfehlungstypen, die übergeben wurden. Wenn nicht genügend Daten vorhanden sind, um eine Empfehlung für die angeforderten „RecommendationTypes“ zu generieren, enthält die Ergebnismenge keine Empfehlung für diesen Typ.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BiddingInfo

Aktuelle Gebotsinformationen der Kampagne. Bietet einen Wrapper für gebotsbezogene Signale, die als Grundlage für Empfehlungen dienen.

JSON-Darstellung 
{
  "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.
}
Felder
biddingStrategyType

enum (BiddingStrategyType)

Aktuelle Gebotsstrategie. Dieses Feld ist für die folgenden Empfehlungstypen erforderlich: MAXIMIZE_KLICKS_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
Union-Feld bidding_strategy_target_info. Optionale Details zu „Bidding_strategy_type“ Für bidding_strategy_target_info ist nur einer der folgenden Werte zulässig:
targetCpaMicros

string (int64 format)

Aktueller Ziel-CPA in Mikros. Dieser Wert kann für Kampagnen mit dem Gebotsstrategietyp TARGET_CPA oder MAXIMIZE_CONVERSIONS ausgefüllt werden.
targetRoas

number

Aktueller Ziel-ROAS. Dieser Wert kann für Kampagnen mit dem Gebotsstrategietyp TARGET_ROAS oder MAXIMIZE_CONVERSION_VALUE ausgefüllt werden.

AdGroupInfo

Aktuelle Anzeigengruppeninformationen zur Kampagne.

JSON-Darstellung 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Felder
keywords[]

object (KeywordInfo)

Optional. Aktuelle Keywords. Dieses Feld ist für die folgenden Empfehlungstypen optional, wenn adGroupInfo festgelegt ist: KEYWORD
adGroupType

enum (AdGroupType)

Optional. Anzeigengruppentyp der Anzeigengruppe. Dieses Feld ist für die folgenden Empfehlungstypen erforderlich, wenn adGroupInfo festgelegt ist: KEYWORD

SeedInfo

Ein Keyword-Startwert und eine bestimmte URL zum Generieren von Keywords.

JSON-Darstellung 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Felder
keywordSeeds[]

string

Optional. Keywords oder Wortgruppen, mit denen Ideen generiert werden sollen, etwa „autohaus in meiner nähe“ oder „autohaus in meiner nähe“.
urlSeed

string

Eine spezifische URL, unter der Ideen generiert werden sollen, zum Beispiel www.beispiel.de/autos.