Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
ส่งความคิดเห็น
เกณฑ์ของกลุ่มโฆษณา
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เกณฑ์ของกลุ่มโฆษณา รายงาน ad_group_criterion จะแสดงเฉพาะเกณฑ์ที่เพิ่มลงในกลุ่มโฆษณาอย่างชัดเจน
คุณอาจเลือกช่องจากแหล่งข้อมูลข้างต้นพร้อมกับแหล่งข้อมูลนี้ในคำสั่ง SELECT และ WHERE ช่องเหล่านี้จะไม่แบ่งกลุ่ม เมตริกในประโยค SELECT
ad_group_criterion.ad_group
คำอธิบายช่อง กลุ่มโฆษณาที่เกณฑ์อยู่ หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ เท็จ
ad_group_criterion.age_range.type
คำอธิบายช่อง ประเภทของช่วงอายุ หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
AGE_RANGE_18_24
AGE_RANGE_25_34
AGE_RANGE_35_44
AGE_RANGE_45_54
AGE_RANGE_55_64
AGE_RANGE_65_UP
AGE_RANGE_UNDETERMINED
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeTypeกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.bid_modifier
คำอธิบายช่อง ตัวปรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง 0.1 - 10.0 เกณฑ์ประเภทต่างๆ ที่กําหนดเป้าหมายได้ส่วนใหญ่รองรับตัวแก้ไข หมวดหมู่ ATTRIBUTEประเภทข้อมูล DOUBLEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.cpc_bid_micros
คำอธิบายช่อง ราคาเสนอ CPC (ต้นทุนต่อคลิก) หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT64พิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.creation_time
คำอธิบายช่อง การประทับเวลาเมื่อสร้างเกณฑ์กลุ่มโฆษณานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss" หมวดหมู่ ATTRIBUTEประเภทข้อมูล DATEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.criterion_id
คำอธิบายช่อง รหัสของเกณฑ์ หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT64พิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.effective_cpc_bid_micros
คำอธิบายช่อง การเสนอราคา CPC (ต้นทุนต่อคลิก) ที่มีผล หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT64พิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.effective_labels
คำอธิบายช่อง ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพซึ่งแนบอยู่กับเกณฑ์กลุ่มโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับเกณฑ์กลุ่มโฆษณานี้โดยตรง หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ จริง
ad_group_criterion.engine_id
คำอธิบายช่อง รหัสของเกณฑ์กลุ่มโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สําหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu ฯลฯ สําหรับเอนทิตี Google Ads ให้ใช้ "ad_group_criterion.criterion_id" แทน หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.engine_status
คำอธิบายช่อง สถานะเครื่องมือค้นหาสําหรับเกณฑ์ของกลุ่มโฆษณา หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
AD_GROUP_CRITERION_ACCOUNT_PAUSED
AD_GROUP_CRITERION_APPROVED
AD_GROUP_CRITERION_DISAPPROVED
AD_GROUP_CRITERION_ELIGIBLE
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH
AD_GROUP_CRITERION_INVALID_PC_SEARCH
AD_GROUP_CRITERION_INVALID_SEARCH
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW
AD_GROUP_CRITERION_NOT_REVIEWED
AD_GROUP_CRITERION_ON_HOLD
AD_GROUP_CRITERION_PARTIALLY_INVALID
AD_GROUP_CRITERION_PAUSED
AD_GROUP_CRITERION_PENDING_REVIEW
AD_GROUP_CRITERION_REMOVED
AD_GROUP_CRITERION_SERVING
AD_GROUP_CRITERION_TO_BE_ACTIVATED
AD_GROUP_CRITERION_UNDER_REVIEW
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatusกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.final_url_suffix
คำอธิบายช่อง เทมเพลต URL สําหรับต่อท้ายพารามิเตอร์ไปยัง URL สุดท้าย หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.final_urls
คำอธิบายช่อง รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสําหรับโฆษณา หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ จริง
ad_group_criterion.gender.type
คำอธิบายช่อง ประเภทของเพศ หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
FEMALE
MALE
UNDETERMINED
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.GenderTypeEnum.GenderTypeกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.keyword.match_type
คำอธิบายช่อง ประเภทการทำงานของคีย์เวิร์ด หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchTypeกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.keyword.text
คำอธิบายช่อง ข้อความของคีย์เวิร์ด (ไม่เกิน 80 อักขระและ 10 คำ) หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.labels
คำอธิบายช่อง ชื่อทรัพยากรของป้ายกำกับที่แนบกับเกณฑ์ของกลุ่มโฆษณานี้ หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ จริง
ad_group_criterion.last_modified_time
คำอธิบายช่อง วันที่และเวลาที่แก้ไขเกณฑ์กลุ่มโฆษณานี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" หมวดหมู่ ATTRIBUTEประเภทข้อมูล DATEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.listing_group.type
คำอธิบายช่อง ประเภทของกลุ่มรายชื่อ หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
SUBDIVISION
UNIT
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupTypeกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.location.geo_target_constant
คำอธิบายช่อง ชื่อทรัพยากรคงที่ของเป้าหมายตามภูมิศาสตร์ หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ เท็จ
ad_group_criterion.negative
คำอธิบายช่อง กำหนดว่าจะกําหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์ ช่องนี้แก้ไขไม่ได้ หากต้องการเปลี่ยนเกณฑ์จากเชิงบวกเป็นเชิงลบ ให้นำเกณฑ์นั้นออกแล้วเพิ่มอีกครั้ง หมวดหมู่ ATTRIBUTEประเภทข้อมูล BOOLEANพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.position_estimates.top_of_page_cpc_micros
คำอธิบายช่อง ค่าประมาณราคาเสนอ CPC ที่จําเป็นสําหรับการแสดงโฆษณาที่ด้านบนของหน้าแรกของผลการค้นหา หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT64พิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.quality_info.quality_score
คำอธิบายช่อง คะแนนคุณภาพ ระบบอาจไม่ป้อนข้อมูลในช่องนี้หาก Google มีข้อมูลไม่เพียงพอที่จะระบุค่า หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT32พิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.resource_name
คำอธิบายช่อง ชื่อทรัพยากรของเกณฑ์กลุ่มโฆษณา ชื่อแหล่งข้อมูลของเกณฑ์กลุ่มโฆษณาอยู่ในรูปแบบ customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id} หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ เท็จ
ad_group_criterion.status
คำอธิบายช่อง สถานะของเกณฑ์ สถานะของเอนทิตีเกณฑ์ของกลุ่มโฆษณาซึ่งลูกค้าเป็นผู้ตั้งค่า หมายเหตุ: รายงาน UI อาจรวมข้อมูลเพิ่มเติมที่ส่งผลต่อการมีสิทธิ์เรียกใช้ของเกณฑ์ ในบางกรณี เกณฑ์ที่นําออกแล้วใน API อาจยังแสดงเป็น "เปิดใช้" ใน UI เช่น แคมเปญจะแสดงต่อผู้ใช้ทุกช่วงอายุโดยค่าเริ่มต้น เว้นแต่จะยกเว้น UI จะแสดงกลุ่มอายุแต่ละช่วงเป็น "เปิดใช้" เนื่องจากมีสิทธิ์ดูโฆษณา แต่ "เงื่อนไขที่ว่าระบุไว้" จะแสดงเป็น "นำออกแล้ว" เนื่องจากไม่ได้เพิ่มเกณฑ์เชิงบวกไว้ หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
ENABLED
PAUSED
REMOVED
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatusกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.tracking_url_template
คำอธิบายช่อง เทมเพลต URL สำหรับสร้าง URL ติดตาม หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.type
คำอธิบายช่อง ประเภทของเกณฑ์ หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
AD_SCHEDULE
AGE_RANGE
APP_PAYMENT_MODEL
AUDIENCE
BRAND
BRAND_LIST
CARRIER
COMBINED_AUDIENCE
CONTENT_LABEL
CUSTOM_AFFINITY
CUSTOM_AUDIENCE
CUSTOM_INTENT
DEVICE
GENDER
INCOME_RANGE
IP_BLOCK
KEYWORD
KEYWORD_THEME
LANGUAGE
LIFE_EVENT
LISTING_GROUP
LISTING_SCOPE
LOCAL_SERVICE_ID
LOCATION
LOCATION_GROUP
MOBILE_APPLICATION
MOBILE_APP_CATEGORY
MOBILE_DEVICE
OPERATING_SYSTEM_VERSION
PARENTAL_STATUS
PLACEMENT
PROXIMITY
TOPIC
UNKNOWN
UNSPECIFIED
USER_INTEREST
USER_LIST
WEBPAGE
YOUTUBE_CHANNEL
YOUTUBE_VIDEO
พิมพ์ URL google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionTypeกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.user_list.user_list
คำอธิบายช่อง ชื่อทรัพยากรรายชื่อผู้ใช้ หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ เท็จ
ad_group_criterion.webpage.conditions
คำอธิบายช่อง เงื่อนไขหรือนิพจน์เชิงตรรกะสําหรับการกําหนดเป้าหมายหน้าเว็บ ระบบจะรวมรายการเงื่อนไขการกำหนดเป้าหมายหน้าเว็บเข้าด้วยกันเมื่อประเมินเพื่อกำหนดเป้าหมาย รายการเงื่อนไขที่ว่างเปล่าบ่งบอกว่ามีการกําหนดเป้าหมายทุกหน้าของเว็บไซต์ของแคมเปญ ต้องระบุช่องนี้สำหรับการดำเนินการ CREATE และห้ามมิให้ดำเนินการอัปเดต หมวดหมู่ ATTRIBUTEประเภทข้อมูล MESSAGEพิมพ์ URL google.ads.searchads360.v0.common.WebpageConditionInfoกรองได้ เท็จ เลือกได้ จริง เรียงลำดับได้ เท็จ ซ้ำ จริง
ad_group_criterion.webpage.coverage_percentage
คำอธิบายช่อง เปอร์เซ็นต์ความครอบคลุมของเกณฑ์เว็บไซต์ เปอร์เซ็นต์นี้คํานวณจากความครอบคลุมเว็บไซต์ตามเป้าหมายเว็บไซต์ เป้าหมายเว็บไซต์เชิงลบ และคีย์เวิร์ดเชิงลบในกลุ่มโฆษณาและแคมเปญ เช่น เมื่อผลลัพธ์ของการครอบคลุมคือ 1 แสดงว่ามีการครอบคลุม 100% ช่องนี้เป็นแบบอ่านอย่างเดียว หมวดหมู่ ATTRIBUTEประเภทข้อมูล DOUBLEพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ad_group_criterion.webpage.criterion_name
คำอธิบายช่อง ชื่อของเกณฑ์ที่กําหนดโดยพารามิเตอร์นี้ ระบบจะใช้ค่าชื่อเพื่อระบุ จัดเรียง และเกณฑ์การกรองด้วยพารามิเตอร์ประเภทนี้ ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGพิมพ์ URL N/Aกรองได้ จริง เลือกได้ จริง เรียงลำดับได้ จริง ซ้ำ เท็จ
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
หากต้องการบอกให้เราทราบเพิ่มเติม
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-08-29 UTC"],[],["Ad group criteria are targeting methods added to ad groups, with attributes like `ad_group`, `campaign`, and `customer`. Key actions include defining conditions, setting `bid_modifier` and `cpc_bid_micros`, and specifying criteria types like `AGE_RANGE` or `KEYWORD`. Attributes define criterion details, like match types, text, status, and URLs. The data allows for filtering, selecting, and sorting across various fields and can specify if criteria target or exclude. Additional elements include the `user_list` and webpage targeting information.\n"]]
