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 אם לא צוין בפעולת יצירה.

אם הערך הוא 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 תקציב מותאם אישית, נוסף חזרה לגרסה 5. ניתן להשתמש בתקציב מותאם אישית עם 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_Gmail ), BiddingStrategyType.TARGET_CPA ו-PaymentMode.{9}.
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.