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

enum (CampaignKeywordMatchType)

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

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

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

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

object (FixedCpm)

שיטת בידינג ידנית עם עלות קבועה לאלף חשיפות (CPM).
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_שרברב
manualCpaBidMicros

string (int64 format)

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

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

קובעים אם אפשר להשתמש במודעות וידאו רספונסיביות למודעות וידאו In-stream.
allowInFeed

boolean

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

boolean

קובעים אם אפשר להשתמש ב-Video responsiveAds בתור פורמט של סרטוני 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. אם משתמשים בו במקום sales_country, השדהfeedLabel מקבל קודי מדינות באותו פורמט. לדוגמה: '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 App Store.
GOOGLE_APP_STORE Google Play.

CampaignExperimentType

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

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

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

טיפוסים בני מנייה (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 עם שם (vanity URL) של תרופות.
vanityPharmaText

enum (VanityPharmaText)

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

VanityPharmaDisplayUrlMode

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MANUFACTURER_WEBSITE_URL מחליפים את כתובת ה-URL של תרופות עם שם (vanity URL) בכתובת האתר של היצרן.
WEBSITE_DESCRIPTION יש להחליף כתובת URL עם שם (vanity 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 anti מוצגותivos 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

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

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

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

boolean

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

TargetCpm

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

ייצוג 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)'. שיטת בידינג ידנית עם עלות קבועה לאלף חשיפות (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 מתאר את היעד של שיטת הבידינג לפי עלות קבועה לאלף חשיפות (CPM).

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

FixedCpmTargetFrequencyGoalInfo

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

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

string (int64 format)

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

enum (FixedCpmTargetFrequencyTimeUnit)

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

FixedCpmTargetFrequencyTimeUnit

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

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

TargetCpv

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

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