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 sumber daya 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 sesuai dengan anggaran kampanye bersama ini. Ketika strategi bidding dan anggaran kampanye disesuaikan, keduanya akan disertakan ke kumpulan kampanye yang sama. Setelah anggaran kampanye disesuaikan 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; sistem kemudian akan mengalokasikan anggaran kampanye ke beberapa 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 tidak kosong dan tidak kosong. Anggaran kampanye yang tidak dibagi secara eksplisit mendapatkan 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 masa aktif anggaran, 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 true (benar) jika tidak ditentukan dalam operasi create.

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

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

Anggaran non-bersama dapat menjadi anggaran bersama secara eksplisit. Operasi yang sama juga harus memberi nama anggaran.

Anggaran kampanye bersama tidak dapat menjadi non-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, rekomendasi 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 pada 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 tampilan mingguan jika anggaran yang direkomendasikan diterapkan.

Kolom ini bersifat hanya baca.

BudgetStatus

Kemungkinan status Anggaran.

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

BudgetDeliveryMethod

Kemungkinan metode penayangan suatu Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
STANDARD Server anggaran akan membatasi penayangan secara merata di seluruh jangka waktu.
ACCELERATED Server anggaran tidak akan membatasi penayangan, dan iklan akan ditayangkan secepat mungkin.

BudgetPeriod

Kemungkinan periode Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
DAILY Anggaran harian.
CUSTOM_PERIOD Anggaran khusus, 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

Jenis Anggaran yang mungkin.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
STANDARD Jenis anggaran untuk penggunaan Google Ads standar. Membatasi pembelanjaan harian sebanyak 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 (kecuali 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 selengkapnya: https://support.google.com/localservices/answer/7434558

Jenis ini hanya didukung oleh kampanye dengan AdvertisingChannelType.LOCAL_SERVICES.