Method: customers.recommendations.generate

İstenen öneri türlerine göre Öneriler oluşturur.

Verilen 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. Önerileri oluşturan müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 öneriType'ların listesi. Yüklenen ölçütler, öneride bulunmak için yeterli değilse veya kampanya zaten önerilen durumdaysa söz konusu tür için herhangi bir öneri döndürülmez. Genellikle, ilgili öneriType için tüm zorunlu alanlar yüklenirse bir öneri döndürülür ancak bunun hâlâ yeterli olmadığı durumlar da vardır.

Öneri oluşturma için şu öneri türleri 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ü. Öneri oluşturma için desteklenen advertisingChannelType'lar: PERFORMANCE_MAX ve SEARCH
adGroupInfo[]

object (AdGroupInfo)

İsteğe bağlı. Mevcut Reklam Grubu Bilgileri. Tek bir Reklam Grubundan gelen bilgileri destekler. Bu alan, şu öneri türleri için isteğe bağlıdır: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

İsteğe bağlı. Mevcut dönüşüm izleme durumu. Bu alan, şu ö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 verme bilgileri. Bu alan, şu ö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 temel bilgiler. Bu alan, şu öneri türleri için gereklidir: KEYWORD

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 öneri türünde iletilen önerilerden oluşturulan önerilerin listesi. İstenen öneri türünde öneri oluşturmak için yeterli veri yoksa sonuç grubunda bu tür için ö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ı makaleye bakın.

BiddingInfo

Kampanyanın mevcut teklif verme bilgileri. Önerileri bilgilendiren, teklifle ilgili sinyaller için 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 ö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
Birleştirme alanı bidding_strategy_target_info. Bidding_strategy_type ile ilgili isteğe bağlı ayrıntılar. bidding_strategy_target_info şunlardan yalnızca biri olabilir:
targetCpaMicros

string (int64 format)

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

number

Geçerli hedef ROAS. Bu alan, TARGET_ROAS veya MAXIMIZE_CONVERSION_VALUE teklif stratejisi türündeki 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, şurecommendType'lar için isteğe bağlıdır: KEYWORD
adGroupType

enum (AdGroupType)

İsteğe bağlı. Reklam Grubunun Reklam Grubu Türü. adGroupInfo ayarlandıysa bu alan, şurecommendType'lar için gereklidir: KEYWORD

SeedInfo

Bir anahtar kelime başlangıç noktası ve anahtar kelime oluşturulacak belirli bir URL.

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

string

İsteğe bağlı. Fikir üretebileceğiniz anahtar kelimeler veya kelime öbekleri. Örneğin: arabalar veya "yakınımdaki otomobil bayileri".
urlSeed

string

Fikir oluşturulacak belirli bir URL. Örneğin: www.example.com/arabalar.