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)

שיטת הצגת המודעות שקובעת את שיעור ניצול התקציב של הקמפיין.

ברירת המחדל היא 'רגיל' אם לא צוין בפעולת יצירה.
period

enum (BudgetPeriod)

לא משתנה. התקופה שבמהלכה ינוצל התקציב. אם לא מציינים שום אפשרות, ברירת המחדל היא DAILY.
type

enum (BudgetType)

לא משתנה. הסוג של תקציב הקמפיין.
alignedBiddingStrategyId

string (int64 format)

המזהה של שיטת הבידינג הכוללת שתקציב הקמפיין המשותף הזה תואם אליה. כששיטת הבידינג והתקציב של הקמפיין תואמים, הם מצורפים לאותה קבוצה של קמפיינים. אחרי ההתאמה של תקציב הקמפיין לשיטת הבידינג, קמפיינים שנוספים לתקציב של הקמפיין צריכים להשתמש גם בשיטת הבידינג המתואמת.
id

string (int64 format)

פלט בלבד. המזהה של תקציב הקמפיין.

תקציב קמפיין נוצר באמצעות פעולת היצירה של CampaignBudgetService, ומוקצה לו מזהה תקציב. ניתן לשתף את מזהה התקציב בין קמפיינים שונים. לאחר מכן, המערכת תקצה את תקציב הקמפיין בין קמפיינים שונים כדי להשיג תוצאות אופטימליות.
name

string

שם התקציב של הקמפיין.

כשיוצרים תקציב קמפיין באמצעות CampaignBudgetService, כל תקציב קמפיין שמשותף באופן מפורש צריך להכיל שם שאינו ריק (null). תקציבים של קמפיינים שלא משותפים באופן מפורש נגזרים מהשם של הקמפיין המצורף.

האורך של המחרוזת הזו חייב להיות בין 1 ל-255, כולל, בקידוד UTF-8 בייטים (חתוך).
amountMicros

string (int64 format)

סכום התקציב, במטבע המקומי של החשבון. הסכום מצוין ביחידות מיקרו, כאשר מיליון שווה ליחידת מטבע אחת. ההוצאה החודשית מוגבלת לפי 30.4 מהסכום הזה.
totalAmountMicros

string (int64 format)

סכום משך החיים של התקציב, במטבע המקומי של החשבון. הסכום מצוין ביחידות מיקרו, כאשר מיליון שווה ליחידת מטבע אחת.
explicitlyShared

boolean

מציינת אם התקציב משותף באופן מפורש. ברירת המחדל היא TRUE אם לא צוין אחרת בפעולת יצירה.

אם הוא נכון, התקציב נוצר במטרה לשתף את הנתונים בין קמפיין אחד או יותר.

אם הערך הוא False, התקציב נוצר מתוך כוונה להשתמש בו רק בקמפיין אחד. השם והסטטוס של התקציב יישארו מסונכרנים עם השם והסטטוס של הקמפיין. ניסיון לשתף את התקציב עם קמפיין נוסף יגרום לשגיאה.

תקציב לא משותף יכול להפוך למשותף באופן מפורש. אותה פעולה צריכה גם להקצות שם לתקציב.

תקציב קמפיין משותף לעולם לא יכול להיות לא משותף.
referenceCount

string (int64 format)

פלט בלבד. מספר הקמפיינים שמשתמשים בתקציב באופן פעיל.

השדה הזה הוא לקריאה בלבד.
recommendedBudgetAmountMicros

string (int64 format)

פלט בלבד. סכום התקציב המומלץ. אם אין המלצות זמינות, הערך הזה יוגדר לסכום התקציב. הסכום מצוין ביחידות מיקרו, כאשר מיליון שווה ליחידת מטבע אחת.

השדה הזה הוא לקריאה בלבד.
recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

פלט בלבד. השינוי המשוער במספר הקליקים השבועיים אם ייעשה שימוש בתקציב המומלץ.

השדה הזה הוא לקריאה בלבד.
recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

פלט בלבד. השינוי המשוער בעלות השבועית במיליוניות לאחר יישום התקציב המומלץ. מיליון שווה ערך ליחידת מטבע אחת.

השדה הזה הוא לקריאה בלבד.
recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

פלט בלבד. השינוי המשוער באינטראקציות השבועיות אם התקציב המומלץ מיושם.

השדה הזה הוא לקריאה בלבד.
recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

פלט בלבד. השינוי המשוער בצפיות השבועיות אם התקציב המומלץ הוחל.

השדה הזה הוא לקריאה בלבד.

BudgetStatus

סטטוסים אפשריים של תקציב.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED התקציב מופעל.
REMOVED התקציב הוסר.

BudgetDeliveryMethod

שיטות אפשריות להצגת תקציב

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
STANDARD שרת התקציב יווסת את הצגת המודעות באופן שווה לאורך כל תקופת הזמן.
ACCELERATED שרת התקציב לא יווסת את הצגת המודעות, והמודעות יוצגו במהירות האפשרית.

BudgetPeriod

התקופה האפשרית של התקציב.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DAILY תקציב יומי.
CUSTOM_PERIOD תקציב מותאם אישית, נוסף חזרה ב-V5. כדי לציין מגבלת תקציב לכל משך החיים, אפשר להשתמש בתקציב מותאם אישית יחד עם total_amount. מידע נוסף זמין בכתובת https://support.google.com/google-ads/answer/6385083.

BudgetType

סוגי תקציבים אפשריים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
STANDARD סוג התקציב לשימוש רגיל ב-Google Ads מכסת ההוצאה היומית גדולה פי שניים מסכום התקציב שצוין. פרטים מלאים: https://support.google.com/google-ads/answer/6385083
FIXED_CPA

סוג תקציב עם עלות קבועה להמרה (המרה). פרטים מלאים: https://support.google.com/google-ads/answer/7528254

סוג זה נתמך רק בקמפיינים עם AdvertisingChannelType.DISPLAY (לא כולל AdvertisingChannelSubType.DISPLAY_END), BiddingStrategyType.TARGET_CPA ו-PaymentMode.convert.
SMART_CAMPAIGN

סוג התקציב של קמפיין חכם. פרטים מלאים: https://support.google.com/google-ads/answer/7653509

הסוג הזה נתמך רק בקמפיינים עם AdvertisingChannelType.SMART ו-AdvertisingChannelSubType.SMART_CAMPAIGN.
LOCAL_SERVICES

סוג התקציב לקמפיין 'Google בעלי מקצוע'. לפרטים מלאים: https://support.google.com/localservices/answer/7434558

הסוג הזה נתמך רק בקמפיינים עם AdvertisingChannelType.LOCAL_SERVICES.