Method: customers.generateKeywordForecastMetrics

Menampilkan metrik (seperti tayangan, klik, total biaya) dari perkiraan kata kunci untuk kampanye tertentu.

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

Permintaan HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Kolom
forecastPeriod

object (DateRange)

Rentang tanggal untuk perkiraan. Tanggal mulai harus berada di masa mendatang dan tanggal akhir harus berada dalam rentang 1 tahun sejak hari ini. Zona waktu referensi yang digunakan adalah salah satu akun Google Ads milik pelanggan. Jika tidak ditetapkan, rentang tanggal default dari hari Minggu depan hingga Sabtu berikutnya akan digunakan.
campaign

object (CampaignToForecast)

Wajib. Kampanye yang digunakan dalam perkiraan.
currencyCode

string

Mata uang yang digunakan untuk konversi nilai tukar. Secara default, mata uang akun pelanggan digunakan. Tetapkan kolom ini hanya jika mata uang berbeda dengan mata uang akun. Daftar kode mata uang yang valid dapat ditemukan di https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

Isi respons

Pesan respons untuk [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Kolom
campaignForecastMetrics

object (KeywordForecastMetrics)

Hasil perkiraan kampanye.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CampaignToForecast

Kampanye untuk melakukan perkiraan kampanye kata kunci.

Representasi JSON 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
Kolom
languageConstants[]

string

Daftar nama resource bahasa yang akan ditarget. Nama resource menggunakan format "languageConstants/{criterionId}". Lihat https://developers.google.com/google-ads/api/data/codes-formats#languages untuk mengetahui daftar kode kriteria bahasa.
geoModifiers[]

object (CriterionBidModifier)

Lokasi yang akan ditargetkan. Lokasi harus unik.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Wajib. Jaringan yang digunakan untuk penargetan.
negativeKeywords[]

object (KeywordInfo)

Daftar kata kunci negatif yang akan digunakan dalam kampanye saat melakukan perkiraan.
biddingStrategy

object (CampaignBiddingStrategy)

Wajib. Strategi bidding untuk kampanye.
adGroups[]

object (ForecastAdGroup)

Grup iklan di kampanye baru yang akan diperkirakan.
conversionRate

number

Rasio konversi yang diharapkan (jumlah konversi dibagi dengan jumlah total klik) seperti yang ditentukan oleh pengguna. Nilai ini dinyatakan sebagai nilai desimal, sehingga rasio konversi yang diharapkan sebesar 2% harus dimasukkan sebagai 0,02. Jika dibiarkan kosong, perkiraan rasio konversi akan digunakan.

CriterionBidModifier

Pengubah bid Kriteria Lokasi.

Representasi JSON 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
Kolom
geoTargetConstant

string

Nama resource lokasi geografis yang akan ditargetkan. Nama resource menggunakan format "geoTargetConstants/{criterionId}".
bidModifier

number

Pengganda terkait untuk criterionId. Jika ditetapkan, nilai ini tidak boleh 0.

CampaignBiddingStrategy

Strategi bidding yang didukung untuk perkiraan kampanye baru.

Representasi JSON 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
Kolom
Kolom union bidding_strategy. Strategi bidding. bidding_strategy hanya ada berupa salah satu diantara berikut:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Gunakan strategi bidding CPC manual untuk perkiraan.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Gunakan strategi bidding maksimalkan klik untuk perkiraan.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Gunakan strategi bidding Maksimalkan konversi untuk perkiraan.

ManualCpcBiddingStrategy

Strategi Bidding CPC Manual.

Representasi JSON 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
Kolom
maxCpcBidMicros

string (int64 format)

Wajib. Bid dalam mikro yang akan diterapkan pada grup iklan dalam kampanye untuk strategi bidding CPC manual.
dailyBudgetMicros

string (int64 format)

Anggaran tingkat kampanye dalam mikro. Jika ditetapkan, nilai minimum akan diterapkan untuk mata uang lokal yang digunakan di kampanye. Error akan terjadi saat menampilkan nilai minimum jika kolom ini ditetapkan terlalu rendah.

MaximizeClicksBiddingStrategy

Strategi Bidding Maksimalkan Klik.

Representasi JSON 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
Kolom
dailyTargetSpendMicros

string (int64 format)

Wajib. Target pembelanjaan harian dalam mikro yang akan digunakan untuk estimasi. Nilai minimum diterapkan untuk mata uang lokal yang digunakan dalam kampanye. Error akan terjadi saat menampilkan nilai minimum jika kolom ini ditetapkan terlalu rendah.
maxCpcBidCeilingMicros

string (int64 format)

Batas bid CPC maks dalam mikro.

MaximizeConversionsBiddingStrategy

Strategi Bidding Maksimalkan Konversi.

Representasi JSON 
{
  "dailyTargetSpendMicros": string
}
Kolom
dailyTargetSpendMicros

string (int64 format)

Wajib. Target pembelanjaan harian dalam mikro yang akan digunakan untuk estimasi. Nilai ini harus lebih besar dari nol.

ForecastAdGroup

Grup iklan yang merupakan bagian dari kampanye yang akan diperkirakan.

Representasi JSON 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Kolom
biddableKeywords[]

object (BiddableKeyword)

Wajib. Daftar kata kunci yang dapat di-bid yang akan digunakan di grup iklan saat melakukan perkiraan. Membutuhkan setidaknya satu kata kunci.
negativeKeywords[]

object (KeywordInfo)

Detail kata kunci. Anda harus menentukan teks kata kunci dan jenis pencocokan.
maxCpcBidMicros

string (int64 format)

CPC maks yang akan digunakan untuk grup iklan saat menghasilkan perkiraan traffic. Nilai ini akan mengganti nilai cpc maks yang ditetapkan dalam strategi bidding. Hanya tentukan kolom ini untuk strategi bidding yang nilai CPC maks.

BiddableKeyword

Bagian kata kunci yang dapat di-bid dari grup iklan.

Representasi JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Kolom
keyword

object (KeywordInfo)

Wajib. Kata kunci. Harus memiliki teks dan jenis pencocokan.
maxCpcBidMicros

string (int64 format)

Bid CPC maks di mikro yang menggantikan bid CPC maks tingkat grup iklan dalam simulasi perkiraan. Nilai ini akan menggantikan nilai cpc maks yang ditetapkan dalam strategi bidding dan grup iklan. Hanya tentukan kolom ini untuk strategi bidding yang mendukung nilai cpc maks.

KeywordForecastMetrics

Metrik perkiraan untuk kampanye kata kunci tanpa rencana.

Representasi JSON 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Kolom
impressions

number

Jumlah total tayangan.
clickThroughRate

number

Rasio klik-tayang rata-rata. Hanya tersedia jika tayangan > 0.
averageCpcMicros

string (int64 format)

CPC rata-rata Hanya tersedia jika klik > 0.
clicks

number

Total jumlah klik.
costMicros

string (int64 format)

Biaya total.
conversions

number

Perkiraan jumlah konversi: klik * conversionRate.
conversionRate

number

Perkiraan rasio konversi.
averageCpaMicros

string (int64 format)

Rata-rata biaya per akuisisi dihitung sebagai costMicros / konversi.