CampaignCriterion

קריטריון של קמפיין.

ייצוג JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "campaign": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "adSchedule": {
    object (AdScheduleInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "proximity": {
    object (ProximityInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "listingScope": {
    object (ListingScopeInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "ipBlock": {
    object (IpBlockInfo)
  },
  "contentLabel": {
    object (ContentLabelInfo)
  },
  "carrier": {
    object (CarrierInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "operatingSystemVersion": {
    object (OperatingSystemVersionInfo)
  },
  "mobileDevice": {
    object (MobileDeviceInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "keywordTheme": {
    object (KeywordThemeInfo)
  },
  "localServiceId": {
    object (LocalServiceIdInfo)
  },
  "brandList": {
    object (BrandListInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

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

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}
displayName

string

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

השינויים בשדה הזה לא נלקחים בחשבון.
type

enum (CriterionType)

פלט בלבד. סוג הקריטריון.
status

enum (CampaignCriterionStatus)

הסטטוס של הקריטריון.
campaign

string

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

string (int64 format)

פלט בלבד. מזהה הקריטריון.

המערכת מתעלמת משדה זה במהלך שינוי.
bidModifier

number

ערך ההתאמה של הצעות המחיר כאשר הקריטריון תואם. ערך ההתאמה חייב להיות בטווח: 0.1 - 10.0. רוב סוגי הקריטריונים שניתן לטרגט תומכים במגבילי התאמה. כדי לבטל את ההסכמה לסוג מכשיר מסוים, צריך להקיש על 0.
negative

boolean

בלתי משתנה. האם לטרגט (false) או להחריג (true) את הקריטריון.

שדה איחוד criterion. קריטריון של קמפיין.

יש להגדיר בדיוק ערך אחד. criterion יכול להיות רק אחד מהבאים:
keyword

object (KeywordInfo)

בלתי משתנה. מילת מפתח.
placement

object (PlacementInfo)

בלתי משתנה. מיקום.
mobileAppCategory

object (MobileAppCategoryInfo)

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

object (MobileApplicationInfo)

בלתי משתנה. אפליקציה לנייד.
location

object (LocationInfo)

בלתי משתנה. מיקום.
device

object (DeviceInfo)

בלתי משתנה. מכשיר.
adSchedule

object (AdScheduleInfo)

בלתי משתנה. תזמון הצגת מודעות.
ageRange

object (AgeRangeInfo)

בלתי משתנה. טווח גילאים.
gender

object (GenderInfo)

בלתי משתנה. מגדר.
incomeRange

object (IncomeRangeInfo)

בלתי משתנה. טווח הכנסה.
parentalStatus

object (ParentalStatusInfo)

בלתי משתנה. סטטוס הורה.
userList

object (UserListInfo)

בלתי משתנה. רשימת משתמשים.
youtubeVideo

object (YouTubeVideoInfo)

בלתי משתנה. סרטון ב-YouTube.
youtubeChannel

object (YouTubeChannelInfo)

בלתי משתנה. ערוץ YouTube.
proximity

object (ProximityInfo)

בלתי משתנה. קירבה.
topic

object (TopicInfo)

בלתי משתנה. נושא.
listingScope

object (ListingScopeInfo)

בלתי משתנה. היקף הרישום.
language

object (LanguageInfo)

בלתי משתנה. שפה.
ipBlock

object (IpBlockInfo)

בלתי משתנה. IpBlock.
contentLabel

object (ContentLabelInfo)

בלתי משתנה. ContentLabel.
carrier

object (CarrierInfo)

בלתי משתנה. ספק.
userInterest

object (UserInterestInfo)

בלתי משתנה. תחום עניין של משתמש.
webpage

object (WebpageInfo)

בלתי משתנה. דף אינטרנט.
operatingSystemVersion

object (OperatingSystemVersionInfo)

בלתי משתנה. גרסת מערכת הפעלה.
mobileDevice

object (MobileDeviceInfo)

בלתי משתנה. נייד.
locationGroup

object (LocationGroupInfo)

בלתי משתנה. קבוצה לפי מיקום
customAffinity

object (CustomAffinityInfo)

בלתי משתנה. תחום עניין משותף שהוגדר
customAudience

object (CustomAudienceInfo)

בלתי משתנה. קהל בהתאמה אישית
combinedAudience

object (CombinedAudienceInfo)

בלתי משתנה. קהל משולב.
keywordTheme

object (KeywordThemeInfo)

בלתי משתנה. נושא מילות מפתח בקמפיינים חכמים.
localServiceId

object (LocalServiceIdInfo)

בלתי משתנה. קריטריון לקמפיין של שירות GLS.
brandList

object (BrandListInfo)

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

CampaignCriterionStatus

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

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

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

זהו ערך לתגובה בלבד.
ENABLED קריטריון של קמפיין מופעל.
PAUSED קריטריון הקמפיין מושהה.
REMOVED קריטריון הקמפיין הוסר.

ListingScopeInfo

קריטריון להיקף של דף אפליקציה.

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

object (ListingDimensionInfo)

היקף הקריטריון של הקמפיין.

IpBlockInfo

קריטריון של IpBlock המשמש להחרגת כתובות IP. אנחנו מתירים: - כתובות IPv4 ו-IPv6 - כתובות בודדות (192.168.0.1) - מסכות לכתובות בודדות (192.168.0.1/32) - מסיכות לרשתות מסוג Class C (192.168.0.1/24)

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

string

כתובת ה-IP של בלוק ה-IP הזה.

CarrierInfo

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

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

string

שם המשאב הקבוע של הספק.

OperatingSystemVersionInfo

מייצג את גרסת מערכת ההפעלה לטירגוט.

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

string

שם המשאב הקבוע של גרסת מערכת ההפעלה.

MobileDeviceInfo

קריטריון של מכשיר נייד.

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

string

שם המשאב הקבוע של המכשיר הנייד.

LocationGroupInfo

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

ייצוג JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
שדות
geoTargetConstants[]

string

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

enum (LocationGroupRadiusUnits)

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

string

FeedItemSets שה-FeedItems שלו מטורגטים. אם מציינים כמה מזהים, המערכת מטורגטת לכל הפריטים שמופיעים בקבוצה אחת לפחות. לא ניתן להשתמש בשדה הזה עם geoTargetConstants. הפעולה הזו היא אופציונלית ואפשר להגדיר אותה רק בפעולות CREATE. לא ניתן להגדיר אותו בשדות AssetSet.
locationGroupAssetSets[]

string

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

string

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

string (int64 format)

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

boolean

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

LocationGroupRadiusUnits

יחידת המרחק ברדיוס בקבוצת המיקומים (לדוגמה, MILES)

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

LocalServiceIdInfo

מזהה שירות של מודעות 'Google בעלי מקצוע'. מייצג סוג שירות (למשל, install_faquet) שהקמפיין ב-'Google בעלי מקצוע' יכול לטרגט.

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

string

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

BrandListInfo

קריטריון של רשימת מותגים משמש לציון רשימת מותגים. הרשימה מיוצגת כסוג מזהה של SharedSet BRAND_HINT. אפשר לטרגט או להחריג קריטריון מהסוג הזה.

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

string

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