Method: customers.recommendations.generate

İstenen recommendationTypes'a göre öneriler oluşturur.

Atılan hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Öneri oluşturan müşterinin kimliği.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

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

enum (RecommendationType)

Zorunlu. Oluşturulacak uygun recommendationTypes listesi. Yüklenen ölçütler öneride bulunmak için yeterli değilse veya kampanya zaten önerilen durumdaysa bu tür için herhangi bir öneri döndürülmez. Genellikle, ilgili recommendationType için gerekli tüm alanlar yüklenirse bir öneri döndürülür ancak bunun yeterli olmadığı durumlar da vardır.

Öneri oluşturma için aşağıdaki recommendationTypes desteklenir: 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)

Zorunlu. Kampanyanın reklam kanalı türü. Şu AdvertisingChannelType'lar, öneri oluşturma için desteklenir: PERFORMANCE_MAX ve SEARCH
adGroupInfo[]

object (AdGroupInfo)

İsteğe bağlı. Mevcut Reklam Grubu Bilgileri. Tek bir reklam grubundan gelen bilgileri destekler. Bu alan, aşağıdaki öneri türleri için isteğe bağlıdır: KELİME KALIBİ
conversionTrackingStatus

enum (ConversionTrackingStatus)

İsteğe bağlı. Mevcut dönüşüm izleme durumu. Bu alan aşağıdaki öneri türleri için gereklidir: 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)

İsteğe bağlı. Kampanyanın mevcut teklif bilgileri. Bu alan aşağıdaki öneri türleri için gereklidir: 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)

İsteğe bağlı. Anahtar kelimeler için kaynak bilgileri. Bu alan aşağıdaki öneri türleri için gereklidir: ANAHTAR KELİME

Yanıt gövdesi

RecommendationService.GenerateRecommendations için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Alanlar
recommendations[]

object (Recommendation)

İstenen öneriType'lar kümesinden geçirilen önerilerin listesi. İstenen SuggestionType'lar için öneri oluşturmaya yetecek kadar veri yoksa sonuç kümesinde bu tür için bir öneri bulunmaz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

BiddingInfo

Kampanyanın mevcut teklif verme bilgileri. Tekliflerle ilgili sinyaller için önerilere bilgi sağlayan bir sarmalayıcı sağlar.

JSON gösterimi 
{
  "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.
}
Alanlar
biddingStrategyType

enum (BiddingStrategyType)

Mevcut teklif stratejisi. Bu alan, şu öneriType'lar için gereklidir: 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
Birleştirme alanı bidding_strategy_target_info. bidding_strategy_type ile ilgili isteğe bağlı ayrıntılar. bidding_strategy_target_info yalnızca aşağıdakilerden biri olabilir:
targetCpaMicros

string (int64 format)

Mikro cinsinden geçerli hedef EBM. Bu, teklif stratejisi türü TARGET_CPA veya MAXIMIZE_CONVERSIONS olan kampanyalar için doldurulabilir.
targetRoas

number

Mevcut hedef ROAS. Bu özellik, teklif stratejisi türü TARGET_ROAS veya MAXIMIZE_CONVERSION_VALUE olan kampanyalar için doldurulabilir.

AdGroupInfo

Kampanyanın mevcut Reklam Grubu Bilgileri.

JSON gösterimi 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Alanlar
keywords[]

object (KeywordInfo)

İsteğe bağlı. Mevcut anahtar kelimeler. adGroupInfo ayarlanmışsa bu alan aşağıdaki recommendationTypes için isteğe bağlıdır: KEYWORD
adGroupType

enum (AdGroupType)

İsteğe bağlı. Reklam grubunun AdGroup Type (Reklam Grubu Türü) özelliği. adGroupInfo ayarlanmışsa bu alan aşağıdaki recommendationTypes için gereklidir: KEYWORD

SeedInfo

Anahtar kelime tohumu ve anahtar kelime oluşturmak için kullanılacak belirli bir URL.

JSON gösterimi 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Alanlar
keywordSeeds[]

string

İsteğe bağlı. Fikir oluşturmak için kullanılacak anahtar kelimeler veya kelime öbekleri (ör. arabalar veya "yakınımdaki araba galerisi").
urlSeed

string

Fikir üretilecek belirli bir URL, örneğin: www.example.com/arabalar.