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)

เปลี่ยนแปลงไม่ได้ ธีมคีย์เวิร์ดของ Smart Campaign

localServiceId

object (LocalServiceIdInfo)

เปลี่ยนแปลงไม่ได้ เกณฑ์แคมเปญบริการ GLS

brandList

object (BrandListInfo)

เปลี่ยนแปลงไม่ได้ เกณฑ์แคมเปญรายการแบรนด์

CampaignCriterionStatus

สถานะที่เป็นไปได้ของเกณฑ์แคมเปญ

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น

ENABLED เปิดใช้เกณฑ์ของแคมเปญแล้ว
PAUSED เกณฑ์ของแคมเปญหยุดชั่วคราว
REMOVED เกณฑ์ของแคมเปญถูกนำออก

ListingScopeInfo

เกณฑ์ขอบเขตของรายการ

การแสดง JSON
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
ช่อง
dimensions[]

object (ListingDimensionInfo)

ขอบเขตของเกณฑ์ของแคมเปญ

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

เป้าหมายทางภูมิศาสตร์คงที่ที่จำกัดขอบเขตของพื้นที่ทางภูมิศาสตร์ภายในฟีด ปัจจุบันอนุญาตให้มีค่าคงที่เป้าหมายทางภูมิศาสตร์ได้ 1 รายการเท่านั้น ตั้งค่าด้วยช่อง AssetSet ไม่ได้

radiusUnits

enum (LocationGroupRadiusUnits)

หน่วยของรัศมี ระบบรองรับไมล์และเมตรสำหรับค่าคงที่เป้าหมายทางภูมิศาสตร์ ชุดรายการฟีดและชุดชิ้นงานรองรับไมล์และเมตร ซึ่งจำเป็นและต้องตั้งค่าในการดำเนินงาน CREATE

feedItemSets[]

string

FeedItemSets ที่มีการกำหนดเป้าหมาย FeedItems หากระบุหลายรหัส ระบบจะกำหนดเป้าหมายรายการทั้งหมดที่แสดงในชุดอย่างน้อย 1 ชุด ช่องนี้ใช้ไม่ได้กับ geoTargetConstants ซึ่งไม่บังคับและตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น ตั้งค่าด้วยช่อง AssetSet ไม่ได้

locationGroupAssetSets[]

string

AssetSet ที่มีการกำหนดเป้าหมายเนื้อหา หากระบุหลายรหัส ระบบจะกำหนดเป้าหมายรายการทั้งหมดที่แสดงในชุดอย่างน้อย 1 ชุด ช่องนี้ใช้ไม่ได้กับฟีด ค่าคงที่เป้าหมายทางภูมิศาสตร์ หรือชุดรายการฟีด เมื่อใช้ชุดชิ้นงาน ควรระบุช่องนี้หรือ enabledCustomerLevelLocationAssetSet ไม่สามารถใช้ทั้ง 2 อย่างพร้อมกันได้ การตั้งค่านี้ตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น

feed

string

ฟีดระบุสถานที่สำหรับการกำหนดเป้าหมาย ตั้งค่าด้วยช่อง AssetSet ไม่ได้ ซึ่งจำเป็นและต้องตั้งค่าในการดำเนินงาน CREATE

radius

string (int64 format)

ระยะทางในหน่วยที่ระบุรัศมีรอบสถานที่เป้าหมาย ซึ่งจำเป็นและต้องตั้งค่าในการดำเนินงาน CREATE

enableCustomerLevelLocationAssetSet

boolean

บ่งบอกว่าชุดชิ้นงานระดับลูกค้าล่าสุดมีไว้เพื่อกำหนดเป้าหมาย ใช้กับ Radius และ RadiUnits ไม่สามารถใช้กับฟีด ค่าคงที่เป้าหมายทางภูมิศาสตร์ หรือชุดรายการฟีด เมื่อใช้ชุดชิ้นงาน คุณควรระบุช่องนี้หรือ locationGroupAssetSets ไม่สามารถใช้ทั้ง 2 อย่างพร้อมกันได้ การตั้งค่านี้ตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น

LocationGroupRadiusUnits

หน่วยของระยะรัศมีในกลุ่มสถานที่ตั้ง (เช่น MILES)

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
METERS เมตร
MILES ไมล์
MILLI_MILES มิลลิไมล์

LocalServiceIdInfo

รหัสบริการโฆษณาบริการในพื้นที่ แสดงประเภทบริการ (เช่น install_facet) ที่แคมเปญบริการในพื้นที่กำหนดเป้าหมายได้

การแสดง JSON
{
  "serviceId": string
}
ช่อง
serviceId

string

ชื่อทรัพยากรของเกณฑ์

BrandListInfo

เกณฑ์รายการแบรนด์ใช้เพื่อระบุรายการแบรนด์ รายการนี้จะแสดงเป็นประเภทรหัสชุดที่ใช้ร่วมกัน BRAND_HINT เกณฑ์ของประเภทนี้สามารถกำหนดเป้าหมายหรือยกเว้นได้

การแสดง JSON
{
  "sharedSet": string
}
ช่อง
sharedSet

string

ชื่อทรัพยากรของชุดที่ใช้ร่วมกันของรายการแบรนด์