Method: customers.recommendations.generate

Generuje rekomendacje na podstawie żądanych typów rekomendacji.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta generującego rekomendacje.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

enum (RecommendationType)

To pole jest wymagane. Lista odpowiednich typów rekomendacji do wygenerowania. Jeśli przesłane kryteria nie są wystarczające do utworzenia rekomendacji lub kampania jest już w stanie zalecanym, żadna rekomendacja dla tego typu nie zostanie zwrócona. Ogólnie rzecz biorąc, rekomendacja jest zwracana, jeśli wszystkie wymagane pola dla tego typu rekomendacji zostały przesłane. Jednak w niektórych przypadkach to nadal nie jest wystarczające.

Generujące rekomendacje są obsługiwane następujące typy rekomendacji: 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)

To pole jest wymagane. Typ kanału reklamowego kampanii. Podczas generowania rekomendacji obsługiwane są następujące typy kanałów reklamowych: PERFORMANCE_MAX i SEARCH
adGroupInfo[]

object (AdGroupInfo)

Opcjonalnie. Informacje o bieżącej grupie reklam. Obsługuje informacje z jednej grupy reklam. To pole jest opcjonalne w przypadku następujących typów rekomendacji: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opcjonalnie. Bieżący stan śledzenia konwersji. To pole jest wymagane w przypadku tych typów rekomendacji: 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)

Opcjonalnie. Aktualne informacje o stawkach w kampanii. To pole jest wymagane w przypadku tych typów rekomendacji: 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)

Opcjonalnie. Informacje wyjściowe dla słów kluczowych. To pole jest niezbędne w przypadku tych typów rekomendacji: KEYWORD

Treść odpowiedzi

Odpowiedź na pytanie: RecommendationService.GenerateRecommendations.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Pola
recommendations[]

object (Recommendation)

Lista wygenerowanych rekomendacji na podstawie przekazanych w zestawie żądanych obiektów rekomendacji. Jeśli nie ma wystarczającej ilości danych, aby można było wygenerować rekomendację dla żądanych typów rekomendacji, zestaw wyników nie będzie zawierał rekomendacji dla tego typu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

BiddingInfo

Aktualne informacje o stawkach w kampanii. Zapewnia kod sygnałów związanych z ustalaniem stawek, które wpływają na rekomendacje.

Zapis 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.
}
Pola
biddingStrategyType

enum (BiddingStrategyType)

Obecna strategia ustalania stawek. To pole jest wymagane w przypadku tych typów rekomendacji: 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
Pole sumy bidding_strategy_target_info. Opcjonalne informacje związane z parametrem bid_strategy_type. bidding_strategy_target_info może być tylko jedną z tych wartości:
targetCpaMicros

string (int64 format)

Bieżący docelowy CPA w milionowych częściach jednostki. To pole może być wypełniane w przypadku kampanii z typem strategii ustalania stawek TARGET_CPA lub MAXIMIZE_conversions.
targetRoas

number

Bieżący docelowy ROAS. To pole może być wypełniane w przypadku kampanii o typie strategii ustalania stawek TARGET_ROAS lub MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Aktualne informacje o grupie reklam w kampanii.

Zapis JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Pola
keywords[]

object (KeywordInfo)

Opcjonalnie. Bieżące słowa kluczowe. To pole jest opcjonalne w przypadku następujących obiektów rekomendacjiType, jeśli ustawiona jest wartość adGroupInfo: KEYWORD: KEYWORD
adGroupType

enum (AdGroupType)

Opcjonalnie. Typ grupy reklam. To pole jest wymagane w przypadku następujących obiektów rekomendacjiType, jeśli ustawiona jest wartość adGroupInfo: KEYWORD

SeedInfo

Źródło słowa kluczowego i określony adres URL, na podstawie którego mają zostać wygenerowane słowa kluczowe.

Zapis JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Pola
keywordSeeds[]

string

Opcjonalnie. Słowa kluczowe lub wyrażenia, na których podstawie można wygenerować propozycje, na przykład: samochody lub „salon samochodowy w pobliżu”.
urlSeed

string

Konkretny adres URL, na podstawie którego będą generowane propozycje, np. www.example.com/samochody.