CampaignBudget

งบประมาณแคมเปญ

การแสดง 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
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของงบประมาณแคมเปญ ชื่อทรัพยากรงบประมาณของแคมเปญมีรูปแบบดังนี้

customers/{customerId}/campaignBudgets/{campaign_budget_id}

status

enum (BudgetStatus)

เอาต์พุตเท่านั้น สถานะของงบประมาณแคมเปญนี้ ช่องนี้เป็นแบบอ่านอย่างเดียว

deliveryMethod

enum (BudgetDeliveryMethod)

วิธีการแสดงโฆษณาซึ่งกำหนดอัตราการใช้งบประมาณแคมเปญ

ค่าเริ่มต้นคือ STANDARD หากไม่ได้ระบุในการดำเนินการสร้าง

period

enum (BudgetPeriod)

เปลี่ยนแปลงไม่ได้ ระยะเวลาที่จะใช้จ่ายงบประมาณ ค่าเริ่มต้นจะเป็น DAILY หากไม่ได้ระบุไว้

type

enum (BudgetType)

เปลี่ยนแปลงไม่ได้ ประเภทของงบประมาณแคมเปญ

alignedBiddingStrategyId

string (int64 format)

รหัสของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่สอดคล้องกับงบประมาณแคมเปญที่ใช้ร่วมกันนี้ เมื่อกลยุทธ์การเสนอราคาและงบประมาณของแคมเปญสอดคล้องกัน กลยุทธ์ดังกล่าวจะแนบไปกับแคมเปญชุดเดียวกัน หลังจากที่งบประมาณแคมเปญสอดคล้องกับกลยุทธ์การเสนอราคาแล้ว แคมเปญที่เพิ่มไปยังงบประมาณแคมเปญจะต้องใช้กลยุทธ์การเสนอราคาที่สอดคล้องกันด้วย

id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของงบประมาณแคมเปญ

ระบบจะสร้างงบประมาณแคมเปญโดยใช้การดำเนินการสร้าง CampaignBudgetService และได้รับการกำหนดรหัสงบประมาณ รหัสงบประมาณสามารถใช้ร่วมกันระหว่างแคมเปญต่างๆ ระบบจะจัดสรรงบประมาณให้กับแคมเปญต่างๆ เพื่อให้ได้ผลลัพธ์ที่ดีที่สุด

name

string

ชื่อของงบประมาณแคมเปญ

เมื่อสร้างงบประมาณแคมเปญผ่าน CampaignBudgetService ทุกงบประมาณแคมเปญที่ใช้ร่วมกันอย่างชัดแจ้งต้องมีชื่อที่ไม่เป็นค่าว่างและต้องไม่ว่างเปล่า งบประมาณแคมเปญที่ไม่ได้แชร์กันอย่างชัดแจ้งดึงชื่อมาจากชื่อแคมเปญที่แนบมา

สตริงนี้ต้องมีความยาวระหว่าง 1 ถึง 255 เป็น UTF-8 ไบต์ (ตัดออก)

amountMicros

string (int64 format)

จำนวนเงินงบประมาณในสกุลเงินท้องถิ่นของบัญชี จำนวนเงินจะระบุเป็นไมโคร โดยที่ 1 ล้านมีค่าเท่ากับ 1 หน่วยสกุลเงิน ค่าใช้จ่ายรายเดือนจะจำกัดอยู่ที่ 30.4 เท่าของจำนวนเงินนี้

totalAmountMicros

string (int64 format)

จำนวนเงินงบประมาณตลอดอายุการใช้งานในสกุลเงินท้องถิ่นสำหรับบัญชี จำนวนเงินจะระบุเป็นไมโคร โดยที่ 1 ล้านมีค่าเท่ากับ 1 หน่วยสกุลเงิน

explicitlyShared

boolean

ระบุว่ามีการแชร์งบประมาณอย่างชัดแจ้งหรือไม่ ค่าเริ่มต้นจะเป็น "จริง" หากไม่ระบุในการดำเนินการสร้าง

หากจริง หมายความว่าระบบสร้างงบประมาณโดยมีจุดประสงค์เพื่อแชร์แคมเปญอย่างน้อย 1 แคมเปญ

หากเป็นเท็จ แสดงว่าระบบสร้างงบประมาณโดยมีจุดประสงค์เพื่อใช้กับแคมเปญเดียวเท่านั้น ชื่อและสถานะของงบประมาณจะยังคงซิงค์กับชื่อและสถานะของแคมเปญ การพยายามแชร์งบประมาณกับแคมเปญที่ 2 จะทำให้เกิดข้อผิดพลาด

งบประมาณที่ไม่ได้ใช้ร่วมกันอาจกลายเป็นงบประมาณที่ใช้ร่วมกันอย่างชัดแจ้ง การดำเนินการเดียวกันนี้ต้องตั้งชื่องบประมาณด้วย

งบประมาณของแคมเปญที่ใช้ร่วมกันไม่สามารถกลายเป็นที่ใช้ร่วมกันไม่ได้

referenceCount

string (int64 format)

เอาต์พุตเท่านั้น จํานวนแคมเปญที่ใช้งบประมาณอยู่

ช่องนี้เป็นแบบอ่านอย่างเดียว

recommendedBudgetAmountMicros

string (int64 format)

เอาต์พุตเท่านั้น จำนวนงบประมาณที่แนะนำ หากไม่มีคําแนะนํา ระบบจะกําหนดจํานวนงบประมาณ จำนวนเงินจะระบุเป็นไมโคร โดยที่ 1 ล้านมีค่าเท่ากับ 1 หน่วยสกุลเงิน

ช่องนี้เป็นแบบอ่านอย่างเดียว

recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

เอาต์พุตเท่านั้น การเปลี่ยนแปลงโดยประมาณของจำนวนคลิกรายสัปดาห์หากใช้งบประมาณที่แนะนำ

ช่องนี้เป็นแบบอ่านอย่างเดียว

recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

เอาต์พุตเท่านั้น การเปลี่ยนแปลงโดยประมาณของต้นทุนรายสัปดาห์ในระดับไมโครหากใช้งบประมาณที่แนะนำ 1 ล้านมีค่าเท่ากับ 1 หน่วยสกุลเงิน

ช่องนี้เป็นแบบอ่านอย่างเดียว

recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

เอาต์พุตเท่านั้น การเปลี่ยนแปลงโดยประมาณของการโต้ตอบรายสัปดาห์หากใช้งบประมาณที่แนะนำ

ช่องนี้เป็นแบบอ่านอย่างเดียว

recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

เอาต์พุตเท่านั้น การเปลี่ยนแปลงของการแสดงผลรายสัปดาห์โดยประมาณหากใช้งบประมาณที่แนะนำ

ช่องนี้เป็นแบบอ่านอย่างเดียว

BudgetStatus

สถานะที่เป็นไปได้ของงบประมาณ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED เปิดใช้งานงบประมาณแล้ว
REMOVED นำงบประมาณออกแล้ว

BudgetDeliveryMethod

วิธีการแสดงโฆษณาที่เป็นไปได้ของงบประมาณ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD เซิร์ฟเวอร์งบประมาณจะจํากัดการแสดงโฆษณาอย่างเท่าเทียมกันตลอดระยะเวลา
ACCELERATED เซิร์ฟเวอร์งบประมาณจะไม่ควบคุมการแสดงโฆษณา และโฆษณาจะแสดงโดยเร็วที่สุด

BudgetPeriod

ระยะเวลาของงบประมาณที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DAILY งบประมาณรายวัน
CUSTOM_PERIOD งบประมาณที่กำหนดเอง เพิ่มเข้ามาในเวอร์ชัน 5 งบประมาณที่กำหนดเองใช้ได้กับ total_amount เพื่อระบุขีดจำกัดงบประมาณตลอดอายุ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/google-ads/answer/6385083

BudgetType

ประเภทงบประมาณที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD ประเภทงบประมาณสำหรับการใช้ Google Ads มาตรฐาน จำกัดค่าใช้จ่ายรายวันเท่ากับ 2 เท่าของจำนวนงบประมาณที่ระบุ ดูรายละเอียดทั้งหมดได้ที่ https://support.google.com/google-ads/answer/6385083
FIXED_CPA

ประเภทงบประมาณที่มีต้นทุนต่อการกระทำหนึ่งครั้ง (Conversion) คงที่ ดูรายละเอียดทั้งหมดที่ https://support.google.com/google-ads/answer/7528254

แคมเปญประเภทนี้รองรับโดยแคมเปญที่มี AdvertisingChannelType.DISPLAY (ยกเว้น AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA และ PaymentMode.CONVERSIONS

SMART_CAMPAIGN

ประเภทงบประมาณของ Smart Campaign ดูรายละเอียดทั้งหมดที่ https://support.google.com/google-ads/answer/7653509

แคมเปญประเภทนี้รองรับโดยแคมเปญที่มี AdvertisingChannelType.SMART และ AdvertisingChannelSubType.SMART_CAMPAIGN

LOCAL_SERVICES

ประเภทงบประมาณสําหรับแคมเปญบริการในพื้นที่ ดูรายละเอียดทั้งหมดได้ที่ https://support.google.com/localservices/answer/7434558

แคมเปญที่ใช้ AdvertisingChannelType.LOCAL_SERVICES รองรับประเภทนี้เท่านั้น