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)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "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)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "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)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // 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 נסיעות.
demandGenCampaignSettings

object (DemandGenCampaignSettings)

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

object (VideoCampaignSettings)

ההגדרות של קמפיין הווידאו.
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. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח הבעלים של האסטרטגיה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב BiddingStrategy.
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 ו-STATIC_LOCATION_GROUP) הם סוגי צאצאים של LOCATION_SYNC. לכן, אם הערך LOCATION_SYNC מוגדר בשדה הזה, לא ניתן לקשר את כל קבוצות הנכסים של קבוצות המיקומים לקמפיין הזה, וכל תוספי המיקום (LE) ותוספי המיקום לחיפוש מפיצים (ALE) לא יוצגו בקמפיין הזה. בשלב הזה יש תמיכה רק ב-LOCATION_SYNC.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

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

object (AssetAutomationSetting)

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

enum (CampaignKeywordMatchType)

סוג ההתאמה למילות מפתח בקמפיין. מגדירים את ההתאמה ל'רחבה' כדי להגדיר התאמה רחבה לכל מילות המפתח בקמפיין.
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. במהלך היצירה, ברירת המחדל היא 30 בדצמבר 2037, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעול ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-30 בדצמבר 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. שיטת הבידינג של הקמפיין.

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

string

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

object (Commission)

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

object (ManualCpa)

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

object (ManualCpc)

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

object (ManualCpm)

שיטת בידינג רגילה לפי עלות לאלף חשיפות (CPM) בשיטה ידנית. בידינג ידני מבוסס-חשיפות שבו המשתמש משלם על כל אלף חשיפות.
manualCpv

object (ManualCpv)

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

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

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

object (FixedCpm)

שיטת בידינג ידנית עם עלות קבועה לאלף חשיפות.
targetCpv

object (TargetCpv)

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

CampaignPrimaryStatus

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

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

CampaignPrimaryStatusReason

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

טיפוסים בני מנייה (enum)
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 האפליקציה שמשויכת לקמפיין ה-ACi הזה לא פורסמה במדינות היעד של הקמפיין.
APP_PARTIALLY_RELEASED האפליקציה שמשויכת לקמפיין ה-ACi הזה זמינה באופן חלקי במדינות היעד של הקמפיין.
HAS_ASSET_GROUPS_DISAPPROVED קבוצת נכסים אחת לפחות בקמפיין הזה נדחתה.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY קבוצת נכסים אחת לפחות בקמפיין הזה מוגבלת על ידי המדיניות.
MOST_ASSET_GROUPS_UNDER_REVIEW רוב קבוצות הנכסים בקמפיין הזה נמצאות בהמתנה לבדיקה.
NO_ASSET_GROUPS אין בקמפיין הזה קבוצות נכסים שעומדות בדרישות.
ASSET_GROUPS_PAUSED כל קבוצות הנכסים בקמפיין מושהות.

CampaignStatus

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

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

CampaignServingStatus

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

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

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

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

BiddingStrategySystemStatus

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

טיפוסים בני מנייה (enum)
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 אין מעקב המרות (אין פינגים) ו/או רשימות רימרקטינג בקמפיינים חכמים של שופינג.
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 שמתאר את סטטוסי ההצגה האפשריים.

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

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

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

LocalServicesCampaignSettings

הגדרות של משאב המשנה LocalServicesCampaign.

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

object (CategoryBid)

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

CategoryBid

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

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

string

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

string (int64 format)

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

TravelCampaignSettings

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

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

string (int64 format)

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

DemandGenCampaignSettings

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

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

boolean

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

VideoCampaignSettings

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

ייצוג ב-JSON 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
שדות
videoAdInventoryControl

object (VideoAdInventoryControl)

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

VideoAdInventoryControl

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

ייצוג ב-JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
שדות
allowInStream

boolean

איך בודקים אם אפשר להשתמש ב-VideoResponsiveAds למודעות וידאו In-stream
allowInFeed

boolean

בדיקה אם אפשר להשתמש ב-VideoResponsiveAds במודעות וידאו בגוף הפיד.
allowShorts

boolean

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

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 או sales_country. אם משתמשים בשדה feedLabel במקום בשדה sales_country, אפשר להזין בו קודי מדינות באותו פורמט. לדוגמה: 'XX'. אחרת, יכולה להיות כל מחרוזת שמשמש לתווית פיד ב-Google Merchant Center.
useVehicleInventory

boolean

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

string (int64 format)

לא ניתן לשינוי. מספרי החשבונות של שותפי הפרסום שמשתתפים בקמפיין.
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

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

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

NegativeGeoTargetType

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

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

LocalCampaignSetting

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

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

enum (LocationSourceType)

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

LocationSourceType

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

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

AppCampaignSetting

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

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

enum (AppCampaignBiddingStrategyGoalType)

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

enum (AppCampaignAppStore)

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

string

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

AppCampaignBiddingStrategyGoalType

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

טיפוסים בני מנייה (enum)
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 שמתאר את חנות האפליקציות של קמפיין לקידום אפליקציה.

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

CampaignExperimentType

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

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

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

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

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

FrequencyCapEventType

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

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

VanityPharma

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

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

enum (VanityPharmaDisplayUrlMode)

מצב התצוגה של כתובות URL של תרופות למטרות שיווקיות.
vanityPharmaText

enum (VanityPharmaText)

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

VanityPharmaDisplayUrlMode

Enum שמתאר את מצבי התצוגה האפשריים של כתובות URL של תרופות מותג.

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

VanityPharmaText

Enum שמתאר טקסט אפשרי.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
PRESCRIPTION_TREATMENT_WEBSITE_EN אתר שעוסק בטיפול שניתן במרשם, עם תוכן באתר באנגלית.
PRESCRIPTION_TREATMENT_WEBSITE_ES אתר שעוסק בטיפול שניתן במרשם, עם תוכן בספרדית (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN אתר שעוסק במכשיר שמצריך מרשם, עם תוכן האתר באנגלית.
PRESCRIPTION_DEVICE_WEBSITE_ES אתר שעוסק במכשיר שמצריך מרשם עם תוכן בספרדית (Sitio de dispositivos 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 preventivos).
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

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

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

TrackingSetting

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

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

string

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

PaymentMode

Enum שמתאר את שיטות התשלום האפשריות.

טיפוסים בני מנייה (enum)
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

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

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

ListingType

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

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

AssetAutomationSetting

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

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

enum (AssetAutomationType)

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

enum (AssetAutomationStatus)

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

AssetAutomationType

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

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

AssetAutomationStatus

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

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

CampaignKeywordMatchType

Enum שמתאר את סוג ההתאמה למילות מפתח בקמפיין.

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

עמלה

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

ייצוג ב-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)

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

boolean

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

TargetCpm

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

ייצוג ב-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)

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

מחיר קבוע לאלף חשיפות

שיטת בידינג עם עלות קבועה לאלף חשיפות (CPM). שיטת בידינג ידנית עם עלות קבועה לאלף חשיפות.

ייצוג ב-JSON 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
שדות
goal

enum (FixedCpmGoal)

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

object (FixedCpmTargetFrequencyGoalInfo)

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

FixedCpmGoal

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

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

FixedCpmTargetFrequencyGoalInfo

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

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

string (int64 format)

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

enum (FixedCpmTargetFrequencyTimeUnit)

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

FixedCpmTargetFrequencyTimeUnit

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

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

TargetCpv

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

שיטת בידינג לפי יעד עלות לצפייה (CPV). זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לבצע אופטימיזציה של הביצועים בהתאם ליעד העלות להמרה שהגדרתם.