Campaign

קמפיין.

ייצוג JSON 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
שדות
resourceName

string

בלתי משתנה. שם המשאב של הקמפיין. השמות של משאבי הקמפיין הם בפורמט הבא:

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

פלט בלבד. הסטטוס הראשי של הקמפיין.

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

enum (CampaignPrimaryStatusReason)

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

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

enum (CampaignStatus)

הסטטוס של הקמפיין.

כשמוסיפים קמפיין חדש, כברירת מחדל הסטטוס הוא 'מופעל'.
servingStatus

enum (CampaignServingStatus)

פלט בלבד. סטטוס הצגת המודעות של הקמפיין.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

פלט בלבד. סטטוס המערכת של שיטת הבידינג בקמפיין.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

סטטוס האופטימיזציה של הצגת המודעות בקמפיין.
advertisingChannelType

enum (AdvertisingChannelType)

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

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

אפשר להגדיר אותן רק כשיוצרים קמפיינים. אי אפשר לשנות את השדה אחרי שהקמפיין נוצר.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

בלתי משתנה. מיקוד אופציונלי ל-advertisingChannelType. חייב להיות סוג משנה חוקי של סוג ערוץ ההורה.

אפשר להגדיר אותן רק כשיוצרים קמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין.
urlCustomParameters[]

object (CustomParameter)

רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

הגדרות שקשורות לקמפיין ב-'Google בעלי מקצוע'.
travelCampaignSettings

object (TravelCampaignSettings)

הגדרות לקמפיין ל-Google נסיעות.
discoveryCampaignSettings

object (DiscoveryCampaignSettings)

ההגדרות לקמפיין Discovery.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

הגדרות של 'בידינג בזמן אמת', תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange.
networkSettings

object (NetworkSettings)

הגדרות הרשת של הקמפיין.
hotelSetting

object (HotelSettingInfo)

בלתי משתנה. הגדרת המלון בקמפיין.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).
shoppingSetting

object (ShoppingSetting)

ההגדרה לשליטה בקמפיינים של שופינג.
targetingSetting

object (TargetingSetting)

הגדרה לטירגוט לתכונות קשורות.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

ההגדרה לטירגוט גיאוגרפי של מודעות.
localCampaignSetting

object (LocalCampaignSetting)

ההגדרה לקמפיין מקומי.
appCampaignSetting

object (AppCampaignSetting)

ההגדרה שקשורה לקמפיין לקידום אפליקציה.
labels[]

string

פלט בלבד. שמות המשאבים של התוויות שמצורפות לקמפיין הזה.
experimentType

enum (CampaignExperimentType)

פלט בלבד. סוג הקמפיין: רגיל, טיוטה או ניסוי.
biddingStrategyType

enum (BiddingStrategyType)

פלט בלבד. הסוג של שיטת הבידינג.

כדי ליצור שיטת בידינג אפשר להגדיר את סכמת הבידינג ליצירה של שיטת בידינג רגילה, או את השדה biddingStrategy ליצירה של שיטת בידינג כוללת.

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

string

פלט בלבד. שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים הלא מוגבלים של שיטת הבידינג הכוללת המצורפת, שזוהו על ידי 'biddingStrategy'. ריק, אם לא הוגדרה שיטה כוללת לקמפיין. מאפייני שיטה ללא הגבלה זמינים לכל הלקוחות שאיתם השיטה משותפת, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח שמוגדר כבעלים של האסטרטגיה ולמנהלים שלו. ניתן לקרוא מאפיינים מוגבלים רק מהמשאב Biddingאסטרטגיה.
frequencyCaps[]

object (FrequencyCapEntry)

רשימה שמגבילה את התדירות שבה כל משתמש יראה את המודעות של הקמפיין.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

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

object (VanityPharma)

מתאר כיצד יוצגו מודעות בנושא תרופות שאינן ממותגות.
selectiveOptimization

object (SelectiveOptimization)

הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

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

object (TrackingSetting)

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

enum (PaymentMode)

אמצעי התשלום בקמפיין.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

enum (AssetSetType)

הסוגים של קבוצות הנכסים שצריך להחריג מהקמפיין הזה. קישורים לקבוצות נכסים מהסוגים האלה לא יעברו בירושה לקמפיין הזה מהרמה העליונה. סוגי קבוצות לפי מיקום (GMB_DYNAMIC_LOCATION_GROUP , CHAIN_DYNAMIC_LOCATION_GROUP ו-ENDIC_LOCATION_GROUP) הם סוגים צאצאים של LOCATION_SYNC. לכן, אם הוגדר LOCATION_SYNC בשדה הזה, לא ניתן לקשר את כל קבוצות הנכסים של קבוצות לפי מיקום לקמפיין הזה, וכל תוספי המיקום (LE) ותוספי המיקום של השותפים העצמאיים (ALE) לא יוצגו בקמפיין הזה. כרגע יש תמיכה רק ב-LOCATION_SYNC.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

פלט בלבד. מידע על הקמפיינים שעוברים שדרוג לקמפיינים למיקסום הביצועים.
assetAutomationSettings[]

object (AssetAutomationSetting)

מכיל את סטטוס ההסכמה או ביטול ההסכמה של כל AssetAutomationType. עיין בתיעוד של כל סוג אוטומציה של נכס לגבי התנהגות ברירת המחדל של הבעת הסכמה/ביטול הסכמה.
id

string (int64 format)

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

string

השם של מסע הפרסום.

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

היא לא יכולה להכיל תווים מסוג null (נקודת קוד 0x0), פיד שורה של NL (נקודת קוד 0xA) או תווים של חזרה לתחילת השורה (נקודת קוד 0xD).
trackingUrlTemplate

string

התבנית של כתובת ה-URL ליצירת כתובת URL למעקב.
audienceSetting

object (AudienceSetting)

בלתי משתנה. הגדרה לתכונות שקשורות לקהל.
baseCampaign

string

פלט בלבד. שם המשאב של קמפיין הבסיס של טיוטה או קמפיין ניסוי. בקמפיינים בסיסיים, הערך שווה ל-resourceName.

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

string

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

string

התאריך שבו הקמפיין התחיל להציג מודעות באזור הזמן של הלקוח בפורמט YYYY-MM-DD.
campaignGroup

string

קבוצת הקמפיינים שאליה שייך הקמפיין הזה.
endDate

string

היום האחרון של הקמפיין להצגת אזור הזמן של הלקוח בפורמט YYYY-MM-DD. במועד היצירה, ברירת המחדל היא 2037-12-30, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים כך שיפעל ללא הגבלת זמן, צריך להגדיר את השדה הזה כ-30.12.2037.
finalUrlSuffix

string

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

number

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

ציון האופטימיזציה הוא אומדן שמעריך את יעילות ההגדרות של הקמפיין ואת ההשפעה שלהן על פוטנציאל הביצועים. הערך נע בין 0% (0.0) ל-100% (1.0), כשהערך של 100% מציין שהביצועים של הקמפיין מממשים את מלוא הפוטנציאל. השדה הזה הוא null בקמפיינים ללא דירוג.

מידע נוסף זמין במאמר "מידע על ציון האופטימיזציה" בכתובת https://support.google.com/google-ads/answer/9061546.

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

boolean

מייצג את ביטול ההסכמה להתאמת כתובות URL לכתובות URL מטורגטות יותר. אם המדיניות לא מוגדרת (true), מטורגטים רק כתובות ה-URL הסופיות בקבוצת הנכסים, או כתובות ה-URL שצוינו בפיד Google Merchant Center או בפידים של פרטי העסק של המפרסם. אם תביעו הסכמה (False), כל הדומיין יטורגט. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים, שבהם ערך ברירת המחדל הוא False.
hotelPropertyAssetSet

string

בלתי משתנה. קבוצת המלונות בקמפיינים למיקסום הביצועים לענף התיירות והאירוח.
listingType

enum (ListingType)

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

שדה איחוד campaign_bidding_strategy. שיטת הבידינג בקמפיין.

שיטת הבידינג הכוללת צריכה להיות שיטת בידינג כוללת (נוצרה באמצעות שירות Biddingאסטרטגיה) או רגילה, שמוטמעת בקמפיין. campaign_bidding_strategy יכול להיות רק אחד מהבאים:
biddingStrategy

string

שיטת הבידינג הכוללת שמוגדרת בקמפיין.
commission

object (Commission)

'עמלות' היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה.
manualCpa

object (ManualCpa)

שיטה רגילה של בידינג ידני לפי עלות להמרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לפי פעולה שהמפרסם הגדיר. הפרמטר הזה נתמך רק בקמפיינים של 'Google בעלי מקצוע'.
manualCpc

object (ManualCpc)

השיטה הרגילה של בידינג ידני לפי עלות לקליק. בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק.
manualCpm

object (ManualCpm)

שיטת בידינג רגילה של עלות ידנית לאלף חשיפות. בידינג ידני המבוסס על חשיפות, שבו המשתמש משלם על אלף חשיפות.
manualCpv

object (ManualCpv)

שיטת בידינג שמשלמת סכום שניתן להגדרה לכל צפייה בסרטון.
maximizeConversions

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

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

object (TargetImpressionShare)

שיטת הבידינג 'יעד נתח חשיפות'. שיטת בידינג אוטומטית שמגדירה הצעות מחיר במטרה להשיג את האחוז הנבחר של חשיפות.
targetRoas

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות.

CampaignPrimaryStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ELIGIBLE הקמפיין כשיר להצגת מודעות.
PAUSED סטטוס הקמפיין שצוין על ידי המשתמש מושהה.
REMOVED סטטוס הקמפיין שצוין על ידי המשתמש הוסר.
ENDED הזמן שצוין על ידי המשתמש לסיום הקמפיין הזה חלף.
PENDING יכול להיות שהמודעות בקמפיין יוצגו בעתיד.
MISCONFIGURED הקמפיין או הישויות שמשויכות אליו מכילים הגדרות שגויות שצוינו על ידי המשתמשים.
LIMITED הקמפיין או הישויות שמשויכות אליו מוגבלים על ידי הגדרות שהמשתמשים הגדירו.
LEARNING מערכת הבידינג האוטומטי מבצעת התאמות לשינויים שצוינו על ידי המשתמשים בקמפיין או בישויות המשויכות לה.
NOT_ELIGIBLE הקמפיין לא כשיר להצגת מודעות.

CampaignPrimaryStatusReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CAMPAIGN_REMOVED סטטוס הקמפיין שצוין על ידי המשתמש הוסר.
CAMPAIGN_PAUSED סטטוס הקמפיין שצוין על ידי המשתמש מושהה.
CAMPAIGN_PENDING הזמן שצוין על ידי המשתמש להתחלה של הקמפיין חל בעתיד.
CAMPAIGN_ENDED הזמן שצוין על ידי המשתמש לסיום הקמפיין הזה חלף.
CAMPAIGN_DRAFT הקמפיין הוא טיוטה.
BIDDING_STRATEGY_MISCONFIGURED לשיטת הבידינג יש הגדרות שגויות שצוינו על ידי המשתמש.
BIDDING_STRATEGY_LIMITED שיטת הבידינג מוגבלת בגלל הגדרות שהמשתמש ציין, כמו מחסור בנתונים או הגדרות דומות.
BIDDING_STRATEGY_LEARNING מערכת הבידינג האוטומטי מבצעת התאמות בשיטת הבידינג בהתאם לשינויים שהמשתמש מגדיר.
BIDDING_STRATEGY_CONSTRAINED התאמת יעדי העלות להמרה או יעדי ההחזר על הוצאות הפרסום יכולה להגדיל את ערך ההמרות בקמפיין.
BUDGET_CONSTRAINED התקציב מגביל את היכולת של הקמפיין להציג מודעות.
BUDGET_MISCONFIGURED לתקציב יש הגדרות שגויות שצוינו על ידי המשתמש.
SEARCH_VOLUME_LIMITED הקמפיין לא מטרגט את כל השאילתות הרלוונטיות.
AD_GROUPS_PAUSED כל הסטטוסים של קבוצות המודעות שצוינו על ידי המשתמשים מושהים.
NO_AD_GROUPS אין קבוצות מודעות כשירות בקמפיין הזה.
KEYWORDS_PAUSED כל הסטטוסים של מילות המפתח שצוינו על ידי המשתמשים מושהים.
NO_KEYWORDS אין מילות מפתח כשירות בקמפיין הזה.
AD_GROUP_ADS_PAUSED כל הסטטוסים של המודעות בקבוצת המודעות שציין המשתמש מושהים.
NO_AD_GROUP_ADS אין מודעות כשירות ברמת קבוצת המודעות בקמפיין זה.
HAS_ADS_LIMITED_BY_POLICY לפחות מודעה אחת בקמפיין הזה מוגבלת בהתאם למדיניות.
HAS_ADS_DISAPPROVED לפחות מודעה אחת בקמפיין הזה לא אושרה.
MOST_ADS_UNDER_REVIEW רוב המודעות בקמפיין הזה ממתינות לבדיקה.
MISSING_LEAD_FORM_EXTENSION לקמפיין הוגדר היעד 'השארת פרטים', ותוסף השארת הפרטים חסר.
MISSING_CALL_EXTENSION לקמפיין הוגדר יעד שיחות, ותוסף השיחה חסר.
LEAD_FORM_EXTENSION_UNDER_REVIEW תוסף השארת הפרטים נמצא בבדיקה.
LEAD_FORM_EXTENSION_DISAPPROVED תוסף השארת הפרטים נדחה.
CALL_EXTENSION_UNDER_REVIEW תוסף השיחה נמצא בבדיקה.
CALL_EXTENSION_DISAPPROVED תוסף השיחה נדחה.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA אין בקמפיין הזה קריטריונים כשירים של קבוצות מודעות לאפליקציות לנייד.
CAMPAIGN_GROUP_PAUSED הסטטוס של קבוצת הקמפיינים שציין המשתמש מושהה.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED המועדים שצוינו על ידי המשתמש בכל התקציבים של הקבוצות המשויכים לקבוצת הקמפיינים ברמת ההורה חלפו.
APP_NOT_RELEASED האפליקציה שמשויכת לקמפיין להתקנת אפליקציה לא מופצת במדינות היעד של הקמפיין.
APP_PARTIALLY_RELEASED האפליקציה שמשויכת לקמפיין הזה להתקנת אפליקציה מופצת באופן חלקי במדינות היעד של הקמפיין.
HAS_ASSET_GROUPS_DISAPPROVED לפחות קבוצת נכסים אחת בקמפיין הזה נדחתה.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY לפחות קבוצת נכסים אחת בקמפיין הזה מוגבלת בהתאם למדיניות.
MOST_ASSET_GROUPS_UNDER_REVIEW רוב קבוצות הנכסים בקמפיין הזה ממתינות לבדיקה.
NO_ASSET_GROUPS אין בקמפיין הזה קבוצות נכסים שעומדות בדרישות.
ASSET_GROUPS_PAUSED כל קבוצות הנכסים בקמפיין הזה מושהות.

CampaignStatus

סטטוסים אפשריים של קמפיין.

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

CampaignServingStatus

סטטוסים אפשריים של הצגה של קמפיין.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
SERVING מוצג.
NONE ללא.
ENDED הסתיים.
PENDING בהמתנה.
SUSPENDED מושעה.

BiddingStrategySystemStatus

הסטטוסים האפשריים של המערכת של שיטת בידינג.

טיפוסים בני מנייה (enums)
UNSPECIFIED סימנים לכך שאירעה שגיאה בלתי צפויה, למשל, לא נמצא סוג של שיטת בידינג או שלא נמצאו פרטי סטטוס.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ENABLED אסטרטגיית הצעת המחיר פעילה, ו-AdWords אינו מוצא בעיות ספציפיות באסטרטגיה.
LEARNING_NEW שיטת הבידינג במצב למידה כי היא נוצרה לאחרונה או הופעלה מחדש לאחרונה.
LEARNING_SETTING_CHANGE שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה.
LEARNING_BUDGET_CHANGE שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה בתקציב.
LEARNING_COMPOSITION_CHANGE שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה במספר הקמפיינים, קבוצות המודעות או מילות המפתח שמצורפים אליה.
LEARNING_CONVERSION_TYPE_CHANGE שיטת הבידינג תלויה בדיווח על ההמרות, והלקוח שינה לאחרונה סוגי המרות שהיו רלוונטיים לשיטת הבידינג.
LEARNING_CONVERSION_SETTING_CHANGE שיטת הבידינג תלויה בדיווח על ההמרות, והלקוח שינה לאחרונה את הגדרות ההמרות שלו.
LIMITED_BY_CPC_BID_CEILING שיטת הבידינג מוגבלת על ידי תקרת הצעת המחיר שלה.
LIMITED_BY_CPC_BID_FLOOR הסף המינימלי להצעות המחיר מגביל את שיטת הבידינג.
LIMITED_BY_DATA שיטת הבידינג מוגבלת מפני שלא הייתה מספיק תנועת המרות במהלך השבועות האחרונים.
LIMITED_BY_BUDGET חלק משמעותי ממילות המפתח בשיטת הבידינג הזו מוגבל על-ידי התקציב.
LIMITED_BY_LOW_PRIORITY_SPEND שיטת הבידינג לא יכולה להגיע ליעד ההוצאות שלה מפני שהעדיפות של ההוצאה שלה בוטלה.
LIMITED_BY_LOW_QUALITY לחלק משמעותי ממילות המפתח בשיטת הבידינג הזו יש ציון איכות נמוך.
LIMITED_BY_INVENTORY בגלל טירגוט מצומצם, שיטת הבידינג לא יכולה למצות את התקציב במלואו.
MISCONFIGURED_ZERO_ELIGIBILITY חסרים מעקב המרות (לא קיימים פינגים) ו/או רשימות רימרקטינג לקמפיין שופינג חכם (SSC).
MISCONFIGURED_CONVERSION_TYPES שיטת הבידינג תלויה בדיווח על המרות, וללקוח חסרים סוגי המרות שייתכן שידווחו בהשוואה לשיטה הזו.
MISCONFIGURED_CONVERSION_SETTINGS שיטת הבידינג תלויה בדיווח על ההמרות, והגדרות ההמרות של הלקוח נקבעות באופן שגוי.
MISCONFIGURED_SHARED_BUDGET יש קמפיינים מחוץ לשיטת הבידינג שחולקים תקציבים עם קמפיינים שנכללים בשיטה.
MISCONFIGURED_STRATEGY_TYPE סוג השיטה של הקמפיין לא חוקי ולכן הוא לא מציג מודעות.
PAUSED שיטת הבידינג אינה פעילה. לא מצורפים לשיטת הבידינג מילות מפתח, קבוצות מודעות או קמפיינים פעילים. לחלופין, אין תקציבים פעילים שמקושרים לשיטת הבידינג.
UNAVAILABLE שיטת הבידינג הזו לא תומכת כרגע בדיווח על סטטוס.
MULTIPLE_LEARNING במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת LEARNING_* עבור שיטת הבידינג הזו.
MULTIPLE_LIMITED במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת LIMITED_* לשיטת בידינג זו.
MULTIPLE_MISCONFIGURED במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת MISCONFIGURED_* עבור שיטת הבידינג הזו.
MULTIPLE במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת לשיטת הבידינג הזו.

AdServingOptimizationStatus

טיפוסים בני מנייה (enum) שמתאר סטטוסים אפשריים של הצגת מודעות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
OPTIMIZE הצגת המודעות עוברת אופטימיזציה על סמך שיעור הקליקים של הקמפיין.
CONVERSION_OPTIMIZE אופטימיזציה של הצגת המודעות מבוססת על שיעור הקליקים * ההמרה של הקמפיין. אם הקמפיין לא נכלל בשיטת הבידינג של כלי אופטימיזציית ההמרות, ברירת המחדל תהיה 'אופטימיזציה'.
ROTATE המודעות מוצגות בסבב באופן שווה במשך 90 יום, ולאחר מכן מתבצעת אופטימיזציה לקבלת יותר קליקים.
ROTATE_INDEFINITELY הצגת מודעות שרמת הביצועים שלהן נמוכה יותר באופן שווה יותר למודעות שרמת הביצועים שלהן גבוהה יותר, בלי לבצע אופטימיזציה.
UNAVAILABLE סטטוס האופטימיזציה של הצגת המודעות לא זמין.

LocalServicesCampaignSettings

הגדרות למשאב המשנה של קמפיין ב-LocalServices.

ייצוג JSON 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
שדות
categoryBids[]

object (CategoryBid)

הצעות מחיר ברמה ברמת הקטגוריה המשויכות לשיטת הבידינג MANUAL_CPA.

CategoryBid

הצעות מחיר לקטגוריות ב-LocalServicesReportingCampaignSettings.

ייצוג JSON 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
שדות
categoryId

string

הקטגוריה שאליה תשויך הצעת המחיר. לדוגמה, xcat:service_area_business_שרברב.
manualCpaBidMicros

string (int64 format)

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

TravelCampaignSettings

הגדרות לקמפיין ל-Google נסיעות.

ייצוג JSON 
{
  "travelAccountId": string
}
שדות
travelAccountId

string (int64 format)

בלתי משתנה. מספר חשבון הנסיעות שמשויך לקמפיין ל-Google נסיעות.

DiscoveryCampaignSettings

ההגדרות לקמפיין Discovery.

ייצוג JSON 
{
  "upgradedTargeting": boolean
}
שדות
upgradedTargeting

boolean

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

RealTimeBiddingSetting

הגדרות של 'בידינג בזמן אמת', תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange.

ייצוג JSON 
{
  "optIn": boolean
}
שדות
optIn

boolean

האם הקמפיין מצורף לבידינג בזמן אמת.

NetworkSettings

הגדרות הרשת של הקמפיין.

ייצוג JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
שדות
targetSearchNetwork

boolean

אם המודעות יוצגו באתרי שותפים ברשת החיפוש של Google (לשם כך צריך להיות targetGoogleSearch גם true).
targetContentNetwork

boolean

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

boolean

האם המודעות יוצגו ברשת השותפים של Google. האפשרות הזו זמינה רק בחלק מחשבונות השותפים של Google.
targetYoutube

boolean

האם המודעות יוצגו ב-YouTube.
targetGoogleTvNetwork

boolean

האם המודעות יוצגו ברשת Google TV.

HotelSettingInfo

הגדרות של מודעות להזמנת חדרים ברמת הקמפיין.

ייצוג JSON 
{
  "hotelCenterId": string
}
שדות
hotelCenterId

string (int64 format)

בלתי משתנה. חשבון Hotel Center המקושר.

DynamicSearchAdsSetting

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).

ייצוג JSON 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
שדות
domainName

string

חובה. שם הדומיין באינטרנט שההגדרה הזו מייצגת, לדוגמה, google.com או www.google.com.
languageCode

string

חובה. קוד השפה שמציין את שפת הדומיין, לדוגמה 'en'.
feeds[]

string

רשימת הפידים של דפי הנחיתה שמשויכים לקמפיין.
useSuppliedUrlsOnly

boolean

האם הקמפיין משתמש אך ורק בכתובות URL שסופקו על ידי המפרסם.

ShoppingSetting

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

ייצוג JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
שדות
feedLabel

string

תווית פיד של מוצרים שייכללו בקמפיין. ניתן להגדיר רק ערך אחד של feedLabel או salesCountry. אם משתמשים במקום ב-salesCountry, בשדה feedLabel מקבלים קודי מדינות באותו פורמט, לדוגמה: 'XX'. אחרת, אפשר להשתמש בכל מחרוזת שמשמשת כתווית פיד ב-Google Merchant Center.
useVehicleInventory

boolean

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

string (int64 format)

בלתי משתנה. מזהי חשבונות Google Ads של שותפי הפרסום שמשתפים פעולה בקמפיין.
merchantId

string (int64 format)

מספר החשבון ב-Merchant Center. השדה הזה נדרש כדי ליצור פעולות. אי אפשר לשנות את השדה הזה בקמפיינים של שופינג.
campaignPriority

integer

עדיפות הקמפיין. קמפיינים עם עדיפות מספרית גבוהה יותר מקבלים קדימות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש לקמפיינים של שופינג, עם ערכים בין 0 ל-2, כולל. השדה הזה אופציונלי בקמפיינים חכמים לשופינג, אבל אם מגדירים אותו, השדה הזה חייב להיות שווה ל-3.
enableLocal

boolean

האם לכלול מוצרים בחנויות מקומיות.
disableProductFeed

boolean

משביתים את פיד המוצרים האופציונלי. השדה הזה נתמך כרגע רק בקמפיינים ליצירת ביקוש. מידע נוסף על התכונה הזו זמין בכתובת https://support.google.com/google-ads/answer/13721750.

AudienceSetting

הגדרות לטירגוט לפי קהל.

ייצוג JSON 
{
  "useAudienceGrouped": boolean
}
שדות
useAudienceGrouped

boolean

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

GeoTargetTypeSetting

מייצג אוסף של הגדרות שקשורות לטירגוט הגיאוגרפי של המודעות.

ייצוג JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
שדות
positiveGeoTargetType

enum (PositiveGeoTargetType)

ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה.
negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

הסוגים האפשריים של טירגוט גיאוגרפי חיובי.

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

NegativeGeoTargetType

הסוגים האפשריים של טירגוט גיאוגרפי שלילי.

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

LocalCampaignSetting

הגדרת קמפיין לקמפיינים מקומיים.

ייצוג JSON 
{
  "locationSourceType": enum (LocationSourceType)
}
שדות
locationSourceType

enum (LocationSourceType)

סוג המקור של המיקום בקמפיין המקומי הזה.

LocationSourceType

הסוגים האפשריים של מקור מיקום.

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

AppCampaignSetting

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

ייצוג JSON 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
שדות
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

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

enum (AppCampaignAppStore)

בלתי משתנה. חנות האפליקציות שמפיצה את האפליקציה הספציפית הזו.
appId

string

בלתי משתנה. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד.

AppCampaignBiddingStrategyGoalType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST התמקדות בהגדלת מספר ההתקנות של האפליקציה. הצעת מחיר להמרה היא יעד עלות להתקנה.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST המטרה היא למקסם את המספר הארוך של ההמרות שנבחרו בתוך האפליקציה שנובעות מהתקנות האפליקציה. הצעת מחיר להמרה היא יעד עלות להתקנה.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST המטרה היא למקסם את המספר הארוך של ההמרות שנבחרו בתוך האפליקציה שנובעות מהתקנות האפליקציה. הצעת מחיר להמרה היא יעד עלות להמרה בתוך האפליקציה. לתשומת ליבך, המחיר בפועל להמרה עשוי להיראות גבוה יותר ממחיר היעד להמרה בהתחלה, מכיוון שהמרות לטווח ארוך עדיין לא התרחשו.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND השאיפה היא למקסם את הערך של כל ההמרות. לדוגמה, התקנה + המרות נבחרות מתוך האפליקציה תוך השגת יעד ההחזר על הוצאות הפרסום או חריגה ממנו.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME השאיפה היא למקסם את הרישום מראש לאפליקציה.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST השאיפה היא למקסם את התקנת האפליקציה ללא יעד עלות להתקנה.

AppCampaignAppStore

Enum לתיאור חנות אפליקציות של קמפיין לקידום אפליקציה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
APPLE_APP_STORE Apple App Store.
GOOGLE_APP_STORE ב-Google Play.

CampaignExperimentType

מציין אם הקמפיין הוא קמפיין רגיל, טיוטה של קמפיין או קמפיין ניסיוני.

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

FrequencyCapEntry

כלל שמציין את המספר המקסימלי של פעמים שבהן מודעה (או קבוצה כלשהי של מודעות) יכולה להופיע בפני משתמש במהלך תקופת זמן מסוימת.

ייצוג JSON 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
שדות
key

object (FrequencyCapKey)

המפתח של מכסת תדירות מסוימת. לא יכולה להיות יותר ממכסת תדירות אחת עם אותו מפתח.
cap

integer

המספר המקסימלי של אירועים שמותר בטווח הזמן הזה.

FrequencyCapKey

קבוצת שדות שמשמשים כמפתחות למכסת תדירות. לא יכולה להיות יותר ממכסת תדירות אחת עם אותו מפתח.

ייצוג JSON 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
שדות
level

enum (FrequencyCapLevel)

הרמה שבה יש להחיל את המכסה (לדוגמה, מודעה ברמת קבוצת המודעות או קבוצת המודעות). המכסה חלה על כל הישויות של הרמה הזו.
eventType

enum (FrequencyCapEventType)

סוג האירוע שעליו חלה המכסה (לדוגמה, חשיפה).
timeUnit

enum (FrequencyCapTimeUnit)

יחידת הזמן שמוגדרת במכסה (לדוגמה, יום, שבוע).
timeLength

integer

מספר יחידות הזמן עד שהמכסה תימשך.

FrequencyCapLevel

הרמה שבה יש להחיל את המכסה (למשל, רמת המודעה של קבוצת המודעות או קבוצת המודעות). המכסה חלה על כל המשאבים של הרמה הזו.

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

FrequencyCapEventType

סוג האירוע שעליו חלה המכסה (לדוגמה, חשיפה).

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

VanityPharma

מתאר כיצד יוצגו מודעות בנושא תרופות שאינן ממותגות.

ייצוג JSON 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
שדות
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

מצב התצוגה של כתובות URL של תרופות עם שם (vanity URL).
vanityPharmaText

enum (VanityPharmaText)

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

VanityPharmaDisplayUrlMode

טיפוסים בני מנייה (enum) שמתארים מצבי תצוגה אפשריים עבור כתובות URL של תרופות עם שם (vanity URL).

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
MANUFACTURER_WEBSITE_URL החלף כתובת אתר של תרופות מרשם בכתובת האתר של היצרן.
WEBSITE_DESCRIPTION החלף כתובת URL של תרופות מרשם בתיאור של האתר.

VanityPharmaText

טיפוסים בני מנייה (enum) שמתארים טקסט אפשרי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
PRESCRIPTION_TREATMENT_WEBSITE_EN אתר שעוסק בטיפול שניתן במרשם, עם תוכן האתר באנגלית.
PRESCRIPTION_TREATMENT_WEBSITE_ES אתר שעוסק בטיפול שניתן במרשם, עם תוכן אתר בספרדית (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN אתר שעוסק במכשיר שמצריך מרשם, עם תוכן האתר באנגלית.
PRESCRIPTION_DEVICE_WEBSITE_ES אתר שעוסק במכשיר שמצריך מרשם, עם תוכן אתר בספרדית (Sitio dedispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN אתר שעוסק במכשיר רפואי ושתוכן האתר שלו כתוב באנגלית.
MEDICAL_DEVICE_WEBSITE_ES אתר שעוסק במכשירים רפואיים עם תוכן אתר בספרדית (Sitio de Dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN אתר למכירת טיפולים מונעים ותוכן של האתר באנגלית.
PREVENTATIVE_TREATMENT_WEBSITE_ES אתר למכירת טיפולים מונעים עם תוכן של אתר בספרדית (Sitio de tratamientos Preventionivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN אתר שעוסק באמצעי מניעה שניתנים במרשם, עם תוכן האתר באנגלית.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES אתר שעוסק באמצעי מניעה שניתנים במרשם, עם תוכן אתר בספרדית (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN אתר שעוסק בחיסון שניתן במרשם, עם תוכן של אתר באנגלית.
PRESCRIPTION_VACCINE_WEBSITE_ES אתר שעוסק בחיסון שניתן במרשם, עם תוכן של אתר בספרדית (Sitio de vacunas con receta).

SelectiveOptimization

הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType.

ייצוג JSON 
{
  "conversionActions": [
    string
  ]
}
שדות
conversionActions[]

string

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

OptimizationGoalSetting

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

ייצוג JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
שדות
optimizationGoalTypes[]

enum (OptimizationGoalType)

רשימת הסוגים של יעדי האופטימיזציה.

OptimizationGoalType

הסוג של יעד האופטימיזציה

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש כערך מוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CALL_CLICKS אופטימיזציה לקבלת יותר קליקים לשיחה. המרות מסוג קליקים לשיחה הן הפעמים שבהן אנשים בחרו באפשרות 'התקשרות' כדי ליצור קשר עם חנות לאחר צפייה במודעה.
DRIVING_DIRECTIONS בצע אופטימיזציה למסלולי נסיעה. המרות מסוג 'מסלול נסיעה' הן הפעמים שבהן אנשים בחרו באפשרות 'קבלת מסלול' כדי לנווט לחנות לאחר צפייה במודעה.
APP_PRE_REGISTRATION אופטימיזציה לרישום מראש. המרות מסוג 'אפליקציה – רישום מראש' הן מספר ההרשמות מראש שקיבלו הודעה כשהאפליקציה תושק.

TrackingSetting

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

ייצוג JSON 
{
  "trackingUrl": string
}
שדות
trackingUrl

string

פלט בלבד. כתובת ה-URL שמשמשת למעקב דינמי.

PaymentMode

מספרים לציון אמצעי תשלום אפשריים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CLICKS תשלום לפי אינטראקציה.
CONVERSION_VALUE תשלום לפי ערך המרה. המצב הזה נתמך רק בקמפיינים עם AdvertisingChannelType.hotel , BiddingStrategyType.COMMISSION ו-BudgetType.STANDARD.
CONVERSIONS תשלום להמרה. המצב הזה נתמך רק בקמפיינים עם AdvertisingChannelType.DISPLAY (לא כולל AdvertisingChannelSubType.DISPLAY_Gmail), BiddingStrategyType.TARGET_CPA ו-BudgetType.FIXED_CPA. בנוסף, הלקוח צריך להיות כשיר למצב הזה. לפרטים נוספים, אפשר לעיין בקטע Customer.eligibility_failure_reasons.
GUEST_STAY משלמים לפי ערך שהייה של אורח. המצב הזה נתמך רק בקמפיינים עם AdvertisingChannelType.hotel , BiddingStrategyType.COMMISSION ו-BudgetType.STANDARD.

PerformanceMaxUpgrade

מידע על קמפיין שעובר שדרוג לקמפיין למיקסום ביצועים.

ייצוג JSON 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
שדות
performanceMaxCampaign

string

פלט בלבד. מציין לאיזה קמפיין למיקסום הביצועים הקמפיין משודרג.
preUpgradeCampaign

string

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

enum (PerformanceMaxUpgradeStatus)

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

PerformanceMaxUpgradeStatus

סטטוס השדרוג למיקסום הביצועים הוא 'טיפוסים בני מנייה (enum)' לקמפיין.

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

ListingType

סוגים אפשריים של כרטיסי מוצר.

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

AssetAutomationSetting

ההגדרה של אוטומציה של נכסים כוללת צמד של AssetAutomationType וסטטוס הסכמה/ביטול הסכמה לאוטומציה של נכסים

ייצוג JSON 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
שדות
assetAutomationType

enum (AssetAutomationType)

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

enum (AssetAutomationStatus)

סטטוס ההסכמה או ביטול ההסכמה בסוג האוטומציה של נכסים.

AssetAutomationType

סוג האוטומציה של נכסים.

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

AssetAutomationStatus

הסטטוס של האוטומציה של הנכסים.

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

עמלה

'עמלות' היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה.

ייצוג JSON 
{
  "commissionRateMicros": string
}
שדות
commissionRateMicros

string (int64 format)

שיעור העמלה מגדיר את החלק מערך ההמרה שבו המפרסם יחויב. בשדה הזה יש להעביר את שיעור העמלה בסך x כך: ( x * 1,000,000). לדוגמה, 106,000 מייצג שיעור עמלה של 0.106 (10.6%).

ManualCpa

אין שדות בסוג הזה.

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

ManualCpc

בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק.

ייצוג JSON 
{
  "enhancedCpcEnabled": boolean
}
שדות
enhancedCpcEnabled

boolean

האם יש לשפר את הצעות המחיר על סמך נתונים של כלי אופטימיזציית ההמרות.

ManualCpm

אין שדות בסוג הזה.

בידינג ידני המבוסס על חשיפות, שבו המשתמש משלם על אלף חשיפות.

ManualCpv

אין שדות בסוג הזה.

בידינג מבוסס-צפייה שבו המשתמש משלם לכל צפייה בסרטון.

PercentCpc

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

ייצוג JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
שדות
cpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. זהו שדה אופציונלי שהמפרסם מזין ומצוין ב-micros מקומיים. הערה: המערכת מפרשת את ערך האפס באותו אופן כמו שערך הצעת מחיר מסוג bid_תקרות לא מוגדר.
enhancedCpcEnabled

boolean

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

TargetCpm

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

ייצוג JSON 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
שדות
שדה איחוד goal. מידע נוסף שקשור ליעד הבידינג. goal יכול להיות רק אחד מהבאים:
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

פרטים על יעדי בידינג לתדירות טירגוט.

TargetCpmTargetFrequencyGoal

פרטים על יעדי בידינג לתדירות טירגוט.

ייצוג JSON 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
שדות
targetCount

string (int64 format)

המדד 'תדירות טירגוט' מייצג את מספר הפעמים שאתם רוצים להגיע למשתמש יחיד.
timeUnit

enum (TargetFrequencyTimeUnit)

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