Method: customers.recommendations.generate

Menghasilkan Rekomendasi berdasarkan RecommendationsType yang diminta.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang membuat rekomendasi.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

enum (RecommendationType)

Wajib. Daftar recommendationTypes yang memenuhi syarat untuk dibuat. Jika kriteria yang diupload tidak cukup untuk membuat rekomendasi, atau kampanye sudah dalam status direkomendasikan, tidak ada rekomendasi yang akan ditampilkan untuk jenis tersebut. Umumnya, rekomendasi ditampilkan jika semua kolom yang diperlukan untuk recommendationType tersebut diupload, tetapi ada kasus saat hal ini masih belum memadai.

RekomendasiType berikut didukung untuk pembuatan rekomendasi: 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)

Wajib. Jenis saluran periklanan kampanye. AdvertisingChannelTypes berikut didukung untuk pembuatan rekomendasi: PERFORMANCE_MAX dan SEARCH
adGroupInfo[]

object (AdGroupInfo)

Opsional. Informasi Grup Iklan Saat Ini. Mendukung informasi dari satu Grup Iklan. Kolom ini bersifat opsional untuk recommendationTypes berikut: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opsional. Status tracking konversi saat ini. Kolom ini diperlukan untuk rekomendasiJenis berikut: 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)

Opsional. Informasi bidding kampanye saat ini. Kolom ini diperlukan untuk rekomendasiJenis berikut: 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)

Opsional. Informasi inti untuk Kata Kunci. Kolom ini diperlukan untuk recommendationTypes berikut: KEYWORD

Isi respons

Pesan respons untuk RecommendationService.GenerateRecommendations.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Kolom
recommendations[]

object (Recommendation)

Daftar rekomendasi yang dihasilkan dari kumpulan rekomendasiType yang diminta yang diteruskan. Jika tidak ada cukup data untuk membuat rekomendasi untuk recommendationTypes yang diminta, kumpulan hasil tidak akan berisi rekomendasi untuk jenis tersebut.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BiddingInfo

Informasi bidding kampanye saat ini. Menyediakan wrapper untuk sinyal terkait bidding yang mendasari rekomendasi.

Representasi 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.
}
Kolom
biddingStrategyType

enum (BiddingStrategyType)

Strategi bidding saat ini. Kolom ini diperlukan untuk recommendationTypes berikut: 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
Kolom union bidding_strategy_target_info. Detail opsional yang terkait dengan bidding_strategy_type. bidding_strategy_target_info hanya dapat berupa salah satu dari berikut:
targetCpaMicros

string (int64 format)

TargetCpa saat ini dalam mikro. Kolom ini dapat diisi untuk kampanye dengan jenis strategi bidding TARGET_CPA atau MAXIMIZE_CONVERSIONS.
targetRoas

number

TargetRoa saat ini. Kolom ini dapat diisi untuk kampanye dengan jenis strategi bidding TARGET_ROAS atau MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Informasi GrupIklan saat ini untuk kampanye.

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

object (KeywordInfo)

Opsional. Kata kunci saat ini. Kolom ini bersifat opsional untuk recommendationTypes berikut jika adGroupInfo ditetapkan: KEYWORD
adGroupType

enum (AdGroupType)

Opsional. Jenis AdGroup dari AdGroup. Kolom ini diperlukan untuk recommendationTypes berikut jika adGroupInfo ditetapkan: KEYWORD

SeedInfo

Sumber kata kunci dan URL spesifik yang digunakan untuk membuat kata kunci.

Representasi JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Kolom
keywordSeeds[]

string

Opsional. Kata kunci atau frasa yang digunakan untuk menghasilkan ide, misalnya: mobil atau "dealer mobil di dekat saya".
urlSeed

string

URL spesifik untuk menghasilkan ide, misalnya: www.example.com/cars.