Method: customers.recommendations.generate

Menghasilkan Rekomendasi berdasarkan RecommendationsTypes 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 diisi. Daftar RecommendationsTypes yang memenuhi syarat untuk dibuat. Jika kriteria yang diupload tidak memadai untuk membuat rekomendasi, atau kampanye sudah dalam status direkomendasikan, tidak ada rekomendasi yang akan ditampilkan untuk jenis tersebut. Umumnya, rekomendasi ditampilkan jika semua kolom wajib untuk recommendationsType tersebut diupload, tetapi ada kasus di mana hal ini masih belum memadai.

RecommendationsTypes berikut didukung untuk pembuatan rekomendasi: KATA KUNCI, MAXIMIZE_RESULTS_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 diisi. Jenis saluran iklan kampanye. AdvertisingChannelTypes berikut didukung untuk pembuatan rekomendasi: PERFORMANCE_MAX dan SEARCH
adGroupInfo[]

object (AdGroupInfo)

Opsional. Informasi GrupIklan Saat Ini. Mendukung informasi dari satu Grup Iklan. Kolom ini opsional untuk rekomendasiTypes berikut: KATA KUNCI
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opsional. Status tracking konversi saat ini. Kolom ini diperlukan untuk rekomendasiTypes berikut: MAXIMIZE_K_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 rekomendasiTypes berikut: MAXIMIZE_K_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 rekomendasiTypes 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 dihasilkan dari kumpulan rekomendasiTypes yang diminta yang diteruskan. Jika tidak ada data yang memadai untuk membuat rekomendasi untuk recommendationsTypes 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. Memberikan wrapper untuk sinyal terkait bidding yang menginformasikan 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 rekomendasiTypes berikut: MAXIMIZE_K_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 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

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

AdGroupInfo

Informasi GrupIklan terkini kampanye.

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

object (KeywordInfo)

Opsional. Kata kunci saat ini. Kolom ini bersifat opsional untuk recommendationsTypes berikut jika adGroupInfo ditetapkan: KATA KUNCI
adGroupType

enum (AdGroupType)

Opsional. Jenis GrupIklan dari GrupIklan. Kolom ini diperlukan untuk rekomendasiTypes berikut jika adGroupInfo ditetapkan: KATA KUNCI

SeedInfo

Sumber kata kunci dan URL spesifik untuk membuat kata kunci.

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

string

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

string

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