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

Wymagane. Identyfikator klienta generujący 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)

Wymagane. Lista dostępnych typów rekomendacji do wygenerowania. Jeśli przesłane kryteria nie wystarczą do utworzenia rekomendacji lub kampania ma już zalecany stan, w przypadku tego typu rekomendacji nie zostaną zwrócone żadne rekomendacje. Zasadniczo rekomendacja jest zwracana, jeśli przesłano wszystkie wymagane pola dla danego typu rekomendacji, ale są przypadki, w których to nie wystarcza.

Przy generowaniu rekomendacji obsługiwane są te 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)

Wymagane. Typ kanału reklamowego kampanii. Do generowania rekomendacji obsługiwane są te typy kanałów reklamowych: PERFORMANCE_MAX i SEARCH.
adGroupInfo[]

object (AdGroupInfo)

Opcjonalnie: Aktualne informacje o grupie reklam. Obsługuje informacje z jednej grupy reklam. To pole jest opcjonalne w przypadku tych typów rekomendacji: KEYWORD (słowo kluczowe).
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opcjonalnie: bieżący stan śledzenia konwersji; To pole jest wymagane w przypadku tych wartości recommendationTypes: 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 niezbędne 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: Podstawowe informacje o słowach kluczowych. To pole jest wymagane w przypadku tych typów rekomendacji: KEYWORD

Treść odpowiedzi

Wiadomość z odpowiedzią 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 przekazanego zbioru typów rekomendacji. Jeśli nie ma wystarczających danych, aby wygenerować rekomendację dla żądanych typów rekomendacji, zestaw wyników nie będzie zawierać rekomendacji tego typu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.

BiddingInfo

Aktualne informacje o ustalaniu stawek w kampanii. Zawiera otoczkę dla sygnałów związanych z licytowaniem, 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 wartości recommendationTypes: 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 unii bidding_strategy_target_info. Opcjonalne szczegóły związane z typem strategii ustalania stawek. bidding_strategy_target_info może być tylko jednym z tych elementów:
targetCpaMicros

string (int64 format)

Bieżący docelowy CPA w mikro. Tę wartość można wypełniać w kampaniach ze strategią ustalania stawek TARGET_CPA lub MAXIMIZE_CONVERSIONS.
targetRoas

number

Bieżący docelowy ROAS. Wartość ta może być wypełniona w przypadku kampanii, w których typ strategii ustalania stawek to 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 tych typów rekomendacji, jeśli ustawione jest pole adGroupInfo: KEYWORD
adGroupType

enum (AdGroupType)

Opcjonalnie: Typ grupy reklam. To pole jest wymagane w przypadku tych typów rekomendacji, jeśli ustawione jest pole adGroupInfo: KEYWORD

SeedInfo

Zasiane słowo kluczowe i konkretny adres URL, na podstawie którego mają być generowane słowa kluczowe.

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

string

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

string

Konkretny URL do wygenerowania propozycji, np. www.example.com/samochody.