Method: customers.recommendations.generate

Generiert Empfehlungen basierend auf den angeforderten Empfehlungstypen.

Liste der geworfenen 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

Parameter
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 zulässigen Empfehlungstypen, die generiert werden sollen. Wenn die hochgeladenen Kriterien nicht ausreichen, um eine Empfehlung abzugeben, oder die Kampagne bereits den Status „Empfohlen“ hat, wird für diesen Typ keine Empfehlung zurückgegeben. Im Allgemeinen wird eine Empfehlung zurückgegeben, wenn alle erforderlichen Felder für diesen Empfehlungstyp hochgeladen wurden. Es gibt jedoch Fälle, in denen dies nicht ausreicht.

Die folgenden Empfehlungstypen werden für das Generieren von Empfehlungen unterstützt: 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)

Erforderlich. Der Werbekanaltyp der Kampagne. Die folgenden AdvertisingChannelTypes werden für das Generieren von Empfehlungen 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 Conversion-Tracking-Status. Dieses Feld ist für die folgenden Empfehlungstypen erforderlich: 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)

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

Optional. Informationen zu Ausgangs-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 den übergebenen angeforderten Empfehlungstypen. Wenn nicht genügend Daten vorhanden sind, um eine Empfehlung für die angeforderten Empfehlungstypen 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. Stellt einen Wrapper für gebotsbezogene Signale bereit, 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_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
Union-Feld bidding_strategy_target_info. Optionale Details zum 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 Mikroeinheiten. Dieser Wert kann für Kampagnen mit der Gebotsstrategie „Ziel-CPA“ oder „Conversions maximieren“ angegeben werden.
targetRoas

number

Aktueller Ziel-ROAS. Dieser Wert kann für Kampagnen mit der Gebotsstrategie „TARGET_ROAS“ oder „MAXIMIZE_CONVERSION_VALUE“ angegeben werden.

AdGroupInfo

Aktuelle Anzeigengruppeninformationen der 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-Seed und eine spezifische URL, aus der Keywords generiert werden sollen.

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

string

Optional. Keywords oder Wortgruppen, anhand derer Ideen generiert werden sollen, z. B. „Autos“ oder „Autohändler in meiner Nähe“.
urlSeed

string

Eine bestimmte URL, aus der Ideen generiert werden sollen, z. B. www.beispiel.de/autos.