AdGroupCriterion

เกณฑ์ของกลุ่มโฆษณา รายงาน adGroupCriterion จะแสดงเกณฑ์ที่เพิ่มลงในกลุ่มโฆษณาอย่างชัดเจนเท่านั้น

การแสดง JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของเกณฑ์ของกลุ่มโฆษณา ชื่อทรัพยากรเกณฑ์ของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของเกณฑ์

ระบบจะไม่สนใจช่องนี้สำหรับการเปลี่ยนแปลง
status

enum (AdGroupCriterionStatus)

สถานะของเกณฑ์

นี่คือสถานะของเอนทิตีเกณฑ์ของกลุ่มโฆษณาที่กำหนดโดยลูกค้า หมายเหตุ: รายงาน UI อาจรวมข้อมูลเพิ่มเติมที่กำหนดว่าเกณฑ์จะมีสิทธิ์ทำงานหรือไม่ ในบางกรณี เกณฑ์ที่ถูกนำออกใน API อาจยังคงแสดงเป็น "เปิดใช้" ใน UI ตัวอย่างเช่น โดยค่าเริ่มต้น แคมเปญจะแสดงต่อผู้ใช้ทุกช่วงอายุ เว้นแต่จะมีการยกเว้น UI จะแสดงช่วงอายุแต่ละช่วงเป็น "เปิดใช้" เนื่องจากมีสิทธิ์ดูโฆษณา แต่ adCriterion.status จะแสดงเป็น "นำออกแล้ว" เนื่องจากไม่มีการเพิ่มเกณฑ์เชิงบวก
qualityInfo

object (QualityInfo)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับคุณภาพของเกณฑ์
type

enum (CriterionType)

เอาต์พุตเท่านั้น ประเภทของเกณฑ์
systemServingStatus

enum (CriterionSystemServingStatus)

เอาต์พุตเท่านั้น สถานะการแสดงผลของเกณฑ์
approvalStatus

enum (AdGroupCriterionApprovalStatus)

เอาต์พุตเท่านั้น สถานะการอนุมัติของเกณฑ์
disapprovalReasons[]

string

เอาต์พุตเท่านั้น รายการเหตุผลที่ไม่อนุมัติของเกณฑ์

ดูเหตุผลต่างๆ ในการไม่อนุมัติเกณฑ์ได้ที่ https://support.google.com/adspolicy/answer/6008942

ช่องนี้เป็นแบบอ่านอย่างเดียว
labels[]

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของป้ายกำกับที่แนบมากับเกณฑ์ของกลุ่มโฆษณานี้
effectiveCpcBidSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของการเสนอราคา CPC ที่แท้จริง
effectiveCpmBidSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของการเสนอราคา CPM ที่แท้จริง
effectiveCpvBidSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของราคาเสนอ CPV ที่มีประสิทธิภาพ
effectivePercentCpcBidSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของราคาเสนอเปอร์เซ็นต์ CPC ที่มีประสิทธิภาพ
positionEstimates

object (PositionEstimates)

เอาต์พุตเท่านั้น ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในอันดับต่างๆ
finalUrls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสำหรับโฆษณา
finalMobileUrls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
urlCustomParameters[]

object (CustomParameter)

รายการการแมปที่ใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองใน trackingUrlTemplate, finalUrls หรือ mobile_final_urls
criterionId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของเกณฑ์

ระบบจะไม่สนใจช่องนี้สำหรับการเปลี่ยนแปลง
adGroup

string

เปลี่ยนแปลงไม่ได้ กลุ่มโฆษณาที่มีเกณฑ์อยู่
negative

boolean

เปลี่ยนแปลงไม่ได้ จะกำหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์

ฟิลด์นี้จะเปลี่ยนแปลงไม่ได้ หากต้องการเปลี่ยนเกณฑ์จากเชิงบวกเป็นเชิงลบ ให้นำเกณฑ์ออกแล้วเพิ่มกลับเข้าไปใหม่
bidModifier

number

ตัวแก้ไขสำหรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง: 0.1 - 10.0 ประเภทเกณฑ์ที่กำหนดเป้าหมายได้ส่วนใหญ่รองรับตัวปรับแต่ง
cpcBidMicros

string (int64 format)

CPC (ต้นทุนต่อคลิก) ที่เสนอ
cpmBidMicros

string (int64 format)

CPM (ต้นทุนต่อการแสดงผลพันครั้งที่มองเห็นได้)
cpvBidMicros

string (int64 format)

ราคาเสนอ CPV (ต้นทุนต่อการดู)
percentCpcBidMicros

string (int64 format)

ราคาเสนอ CPC ซึ่งแสดงเป็นเศษส่วนของราคาที่โฆษณาสำหรับสินค้าหรือบริการบางอย่าง ช่วงที่ถูกต้องสำหรับเศษส่วนคือ [0,1) และค่าที่เก็บไว้ที่นี่คือ 1,000,000 * [fraction]
effectiveCpcBidMicros

string (int64 format)

เอาต์พุตเท่านั้น การเสนอราคา CPC (ต้นทุนต่อคลิก) ที่มีประสิทธิภาพ
effectiveCpmBidMicros

string (int64 format)

เอาต์พุตเท่านั้น CPM (ต้นทุนต่อการแสดงผลที่ได้แสดง 1,000 ครั้ง) ที่แท้จริง
effectiveCpvBidMicros

string (int64 format)

เอาต์พุตเท่านั้น ราคาเสนอ CPV (ต้นทุนต่อการดู) ที่มีประสิทธิภาพ
effectivePercentCpcBidMicros

string (int64 format)

เอาต์พุตเท่านั้น จำนวนเงินราคาเสนอเปอร์เซ็นต์ CPC ที่มีผล
finalUrlSuffix

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ต่อท้าย URL สุดท้าย
trackingUrlTemplate

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม

ฟิลด์สหภาพ criterion เกณฑ์ของกลุ่มโฆษณา

ต้องตั้งค่าหนึ่งรายการเท่านั้น criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

object (KeywordInfo)

เปลี่ยนแปลงไม่ได้ คีย์เวิร์ด
placement

object (PlacementInfo)

เปลี่ยนแปลงไม่ได้ ตำแหน่ง
mobileAppCategory

object (MobileAppCategoryInfo)

เปลี่ยนแปลงไม่ได้ หมวดหมู่แอปบนอุปกรณ์เคลื่อนที่
mobileApplication

object (MobileApplicationInfo)

เปลี่ยนแปลงไม่ได้ แอปพลิเคชันบนอุปกรณ์เคลื่อนที่
listingGroup

object (ListingGroupInfo)

เปลี่ยนแปลงไม่ได้ กลุ่มรายชื่อ
ageRange

object (AgeRangeInfo)

เปลี่ยนแปลงไม่ได้ ช่วงอายุ
gender

object (GenderInfo)

เปลี่ยนแปลงไม่ได้ เพศ
incomeRange

object (IncomeRangeInfo)

เปลี่ยนแปลงไม่ได้ ช่วงรายได้
parentalStatus

object (ParentalStatusInfo)

เปลี่ยนแปลงไม่ได้ สถานะความเป็นบิดามารดา
userList

object (UserListInfo)

เปลี่ยนแปลงไม่ได้ รายการผู้ใช้
youtubeVideo

object (YouTubeVideoInfo)

เปลี่ยนแปลงไม่ได้ วิดีโอ YouTube
youtubeChannel

object (YouTubeChannelInfo)

เปลี่ยนแปลงไม่ได้ ช่อง YouTube
topic

object (TopicInfo)

เปลี่ยนแปลงไม่ได้ หัวข้อ
userInterest

object (UserInterestInfo)

เปลี่ยนแปลงไม่ได้ ความสนใจของผู้ใช้
webpage

object (WebpageInfo)

เปลี่ยนแปลงไม่ได้ หน้าเว็บ
appPaymentModel

object (AppPaymentModelInfo)

เปลี่ยนแปลงไม่ได้ รูปแบบการชำระเงินสำหรับแอป
customAffinity

object (CustomAffinityInfo)

เปลี่ยนแปลงไม่ได้ กลุ่มความสนใจที่กำหนดเอง
customIntent

object (CustomIntentInfo)

เปลี่ยนแปลงไม่ได้ ความตั้งใจที่กำหนดเอง
customAudience

object (CustomAudienceInfo)

เปลี่ยนแปลงไม่ได้ กลุ่มเป้าหมายที่กำหนดเอง
combinedAudience

object (CombinedAudienceInfo)

เปลี่ยนแปลงไม่ได้ กลุ่มเป้าหมายรวม
audience

object (AudienceInfo)

เปลี่ยนแปลงไม่ได้ ผู้ชม
location

object (LocationInfo)

เปลี่ยนแปลงไม่ได้ ตำแหน่ง
language

object (LanguageInfo)

เปลี่ยนแปลงไม่ได้ ภาษา

AdGroupCriterionStatus

สถานะที่เป็นไปได้ของเกณฑ์กลุ่มโฆษณา

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

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

นี่เป็นค่าการตอบกลับเท่านั้น
ENABLED เกณฑ์ของกลุ่มโฆษณา เปิดใช้อยู่
PAUSED เกณฑ์ของกลุ่มโฆษณาหยุดชั่วคราว
REMOVED เกณฑ์ของกลุ่มโฆษณาจะถูกนำออก

QualityInfo

คอนเทนเนอร์สำหรับข้อมูลคุณภาพเกณฑ์ของกลุ่มโฆษณา

การแสดง JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
ช่อง
creativeQualityScore

enum (QualityScoreBucket)

เอาต์พุตเท่านั้น ประสิทธิภาพของโฆษณาเมื่อเทียบกับผู้ลงโฆษณารายอื่นๆ
postClickQualityScore

enum (QualityScoreBucket)

เอาต์พุตเท่านั้น คะแนนคุณภาพของหน้า Landing Page
searchPredictedCtr

enum (QualityScoreBucket)

เอาต์พุตเท่านั้น อัตราการคลิกผ่านเมื่อเทียบกับของผู้ลงโฆษณารายอื่น
qualityScore

integer

เอาต์พุตเท่านั้น คะแนนคุณภาพ

ระบบอาจไม่ป้อนข้อมูลในช่องนี้หาก Google มีข้อมูลไม่เพียงพอที่จะกำหนดค่า

CriterionSystemServingStatus

แจกแจงสถานะการแสดงผลของเกณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
ELIGIBLE มีสิทธิ์
RARELY_SERVED มีปริมาณการค้นหาต่ำ

AdGroupCriterionApprovalStatus

แจกแจงสถานะการอนุมัติของเกณฑ์กลุ่มโฆษณา

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
APPROVED อนุมัติ
DISAPPROVED ไม่อนุมัติ
PENDING_REVIEW รอการตรวจสอบ
UNDER_REVIEW อยู่ระหว่างตรวจสอบ

PositionEstimates

ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในอันดับต่างๆ

การแสดง JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
ช่อง
firstPageCpcMicros

string (int64 format)

เอาต์พุตเท่านั้น ค่าประมาณการเสนอราคา CPC ที่จำเป็นสำหรับการแสดงโฆษณาในหน้าแรกของผลการค้นหา
firstPositionCpcMicros

string (int64 format)

เอาต์พุตเท่านั้น ค่าประมาณของการเสนอราคา CPC ที่จำเป็นสำหรับการแสดงโฆษณาในตำแหน่งแรกที่ด้านบนของผลการค้นหาหน้าแรก
topOfPageCpcMicros

string (int64 format)

เอาต์พุตเท่านั้น ค่าประมาณการเสนอราคา CPC ที่จำเป็นสำหรับการแสดงโฆษณาที่ด้านบนของผลการค้นหาหน้าแรก
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

เอาต์พุตเท่านั้น จำนวนคลิกโดยประมาณต่อสัปดาห์ที่คุณอาจได้รับเมื่อเปลี่ยนการเสนอราคาระดับคีย์เวิร์ดเป็นค่าใน firstPositionCpcMicros
estimatedAddCostAtFirstPositionCpc

string (int64 format)

เอาต์พุตเท่านั้น ค่าประมาณของค่าใช้จ่ายต่อสัปดาห์ที่อาจเปลี่ยนแปลงไปเมื่อเปลี่ยนการเสนอราคาระดับคีย์เวิร์ดเป็นค่าใน firstPositionCpcMicros

ListingGroupInfo

เกณฑ์ของกลุ่มรายชื่อ

การแสดง JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
ช่อง
type

enum (ListingGroupType)

ประเภทกลุ่มรายชื่อ
caseValue

object (ListingDimensionInfo)

ค่ามิติข้อมูลที่กลุ่มรายชื่อนี้ปรับแต่งรายการระดับบนสุด ไม่ได้กำหนดสำหรับกลุ่มรูท
parentAdGroupCriterion

string

ชื่อทรัพยากรของเกณฑ์ของกลุ่มโฆษณา ซึ่งเป็นตัวเลือกแยกย่อยกลุ่มรายชื่อหลัก ค่า Null สำหรับกลุ่มรูท
path

object (ListingDimensionPath)

เส้นทางของมิติข้อมูลที่กำหนดกลุ่มรายชื่อนี้

ListingGroupType

ประเภทของกลุ่มรายชื่อ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SUBDIVISION แยกย่อยผลิตภัณฑ์ตามมิติข้อมูลบางรายการ โหนดเหล่านี้ไม่ได้ใช้โดยการแสดงผลเพื่อกำหนดเป้าหมายรายการข้อมูล แต่ใช้เพื่อกำหนดโครงสร้างของโครงสร้างเพียงอย่างเดียว
UNIT หน่วยกลุ่มรายชื่อที่กำหนดราคาเสนอ

ListingDimensionPath

เส้นทางของมิติข้อมูลที่กำหนดกลุ่มรายชื่อ

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

object (ListingDimensionInfo)

เส้นทางที่สมบูรณ์ของมิติข้อมูลผ่านลําดับชั้นของกลุ่มรายชื่อ ตั้งแต่รูท (ไม่รวมรูท) ไปจนถึงกลุ่มรายชื่อนี้

AppPaymentModelInfo

เกณฑ์รูปแบบการชำระเงินสำหรับแอป

การแสดง JSON 
{
  "type": enum (AppPaymentModelType)
}
ช่อง
type

enum (AppPaymentModelType)

ประเภทรูปแบบการชำระเงินสำหรับแอป

AppPaymentModelType

Enum ที่อธิบายรูปแบบการชำระเงินสำหรับแอปที่เป็นไปได้

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

CustomIntentInfo

เกณฑ์ความตั้งใจที่กำหนดเอง เกณฑ์ประเภทนี้กำหนดเป้าหมายได้เท่านั้น

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

string

ชื่อทรัพยากรความสนใจที่กำหนดเอง