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/v17/customers/{customerId}/recommendations:generate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang menghasilkan 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 RecommendationsType 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. Biasanya, rekomendasi ditampilkan jika semua kolom wajib diisi untuk recommendationType tersebut diupload, tetapi ada kasus di mana hal ini masih belum mencukupi.

RecommendationsType 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 iklan 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 rekomendasiType berikut: KATA KUNCI
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 rekomendasiType berikut: KATA KUNCI

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 dibuat 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 ini:

  • 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 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
Kolom union bidding_strategy_target_info. Detail opsional terkait bidding_strategy_type. bidding_strategy_target_info hanya ada berupa salah satu diantara 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 disetel: KEYWORD
adGroupType

enum (AdGroupType)

Opsional. Jenis Grup Iklan dari Grup Iklan. Kolom ini diperlukan untuk recommendationTypes berikut jika adGroupInfo disetel: 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 yang digunakan untuk membuat ide, misalnya: www.example.com/mobil.