CampaignBudget

Anggaran kampanye.

Representasi JSON
{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource anggaran kampanye. Nama resource anggaran kampanye memiliki bentuk:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

status

enum (BudgetStatus)

Hanya output. Status anggaran kampanye ini. Kolom ini bersifat hanya baca.

deliveryMethod

enum (BudgetDeliveryMethod)

Metode penayangan yang menentukan tarif yang digunakan untuk membelanjakan anggaran kampanye.

Jika tidak ditentukan dalam operasi pembuatan, setelan defaultnya adalah STANDARD.

period

enum (BudgetPeriod)

Tidak dapat diubah. Periode waktu untuk membelanjakan anggaran. Jika tidak ditentukan, setelan defaultnya adalah DAILY.

type

enum (BudgetType)

Tidak dapat diubah. Jenis anggaran kampanye.

alignedBiddingStrategyId

string (int64 format)

ID strategi bidding portofolio yang selaras dengan anggaran kampanye bersama ini. Saat strategi bidding dan anggaran kampanye selaras, keduanya dikaitkan ke kumpulan kampanye yang sama. Setelah anggaran kampanye selaras dengan strategi bidding, kampanye yang ditambahkan ke anggaran kampanye juga harus menggunakan strategi bidding yang selaras.

id

string (int64 format)

Hanya output. ID anggaran kampanye.

Anggaran kampanye dibuat menggunakan operasi pembuatan CampaignBudgetService dan diberi ID anggaran. ID anggaran dapat dibagikan ke berbagai kampanye; lalu sistem akan mengalokasikan anggaran kampanye di antara kampanye yang berbeda untuk mendapatkan hasil yang optimal.

name

string

Nama anggaran kampanye.

Saat membuat anggaran kampanye melalui CampaignBudgetService, setiap anggaran kampanye yang dibagikan secara eksplisit harus memiliki nama yang bukan nol dan tidak kosong. Anggaran kampanye yang tidak dibagikan secara eksplisit mengambil namanya dari nama kampanye yang disertakan.

Panjang string ini harus antara 1 dan 255, inklusif, dalam UTF-8 byte, (dipangkas).

amountMicros

string (int64 format)

Jumlah anggaran, dalam mata uang lokal untuk akun. Jumlah ditentukan dalam mikro, dengan satu juta setara dengan satu unit mata uang. Pembelanjaan bulanan dibatasi sebesar 30,4 kali lipat jumlah ini.

totalAmountMicros

string (int64 format)

Jumlah anggaran sepanjang waktu, dalam mata uang lokal untuk akun. Jumlah ditentukan dalam mikro, dengan satu juta setara dengan satu unit mata uang.

explicitlyShared

boolean

Menentukan apakah anggaran dibagi secara eksplisit. Nilai defaultnya adalah benar (true) jika tidak ditentukan dalam operasi create.

Jika benar, anggaran dibuat dengan tujuan berbagi di satu atau beberapa kampanye.

Jika salah, anggaran dibuat dengan tujuan hanya digunakan dengan satu kampanye. Nama dan status anggaran akan tetap sinkron dengan nama dan status kampanye. Mencoba berbagi anggaran dengan kampanye kedua akan mengakibatkan error.

Anggaran yang tidak dibagikan dapat menjadi anggaran yang dibagikan secara eksplisit. Operasi yang sama juga harus menetapkan nama anggaran.

Anggaran kampanye bersama tidak boleh menjadi tidak bersama.

referenceCount

string (int64 format)

Hanya output. Jumlah kampanye yang secara aktif menggunakan anggaran.

Kolom ini bersifat hanya baca.

recommendedBudgetAmountMicros

string (int64 format)

Hanya output. Jumlah anggaran yang direkomendasikan. Jika tidak ada rekomendasi yang tersedia, nilai ini akan ditetapkan ke jumlah anggaran. Jumlah ditentukan dalam mikro, dengan satu juta setara dengan satu unit mata uang.

Kolom ini bersifat hanya baca.

recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

Hanya output. Estimasi perubahan pada klik mingguan jika anggaran yang direkomendasikan diterapkan.

Kolom ini bersifat hanya baca.

recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

Hanya output. Estimasi perubahan biaya mingguan dalam mikro jika anggaran yang direkomendasikan diterapkan. Satu juta setara dengan satu unit mata uang.

Kolom ini bersifat hanya baca.

recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

Hanya output. Estimasi perubahan pada interaksi mingguan jika anggaran yang direkomendasikan diterapkan.

Kolom ini bersifat hanya baca.

recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

Hanya output. Estimasi perubahan pada penayangan mingguan jika anggaran yang direkomendasikan diterapkan.

Kolom ini bersifat hanya baca.

BudgetStatus

Kemungkinan status Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Anggaran diaktifkan.
REMOVED Anggaran dihapus.

BudgetDeliveryMethod

Kemungkinan metode penayangan Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
STANDARD Server anggaran akan membatasi penayangan secara merata selama seluruh jangka waktu.
ACCELERATED Server anggaran tidak akan men-throttle penayangan, dan iklan akan ditayangkan secepat mungkin.

BudgetPeriod

Kemungkinan periode Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
DAILY Anggaran harian.
CUSTOM_PERIOD Anggaran kustom, ditambahkan kembali di V5. Anggaran kustom dapat digunakan dengan total_amount untuk menentukan batas anggaran sepanjang waktu. Lihat: https://support.google.com/google-ads/answer/6385083 untuk info selengkapnya.

BudgetType

Kemungkinan Jenis Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
STANDARD Jenis anggaran untuk penggunaan Google Ads standar. Membatasi pembelanjaan harian dua kali lipat jumlah anggaran yang ditentukan. Detail lengkap: https://support.google.com/google-ads/answer/6385083
FIXED_CPA

Jenis anggaran dengan biaya per akuisisi (konversi) tetap. Detail lengkap: https://support.google.com/google-ads/answer/7528254

Jenis ini hanya didukung oleh kampanye dengan AdvertisingChannelType.DISPLAY (tidak termasuk AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA, dan PaymentMode.CONVERSIONS.

SMART_CAMPAIGN

Jenis anggaran untuk Kampanye Pintar. Detail lengkap: https://support.google.com/google-ads/answer/7653509

Jenis ini hanya didukung oleh kampanye dengan AdvertisingChannelType.SMART dan AdvertisingChannelSubType.SMART_CAMPAIGN.

LOCAL_SERVICES

Jenis anggaran untuk Kampanye Jasa dan Servis. Detail lengkap: https://support.google.com/localservices/answer/7434558

Jenis ini hanya didukung oleh kampanye dengan AdvertisingChannelType.LOCAL_SERVICES.