AdGroup

กลุ่มโฆษณา

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
ช่อง
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

สถานะของกลุ่มโฆษณา
type

enum (AdGroupType)

เปลี่ยนแปลงไม่ได้ ประเภทของกลุ่มโฆษณา
adRotationMode

enum (AdGroupAdRotationMode)

โหมดการหมุนเวียนโฆษณาของกลุ่มโฆษณา
urlCustomParameters[]

object (CustomParameter)

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

boolean

เป็นจริงหากเปิดใช้การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพเข้ามาแทนที่การขยายกลุ่มเป้าหมาย
displayCustomBidDimension

enum (TargetingDimension)

ช่วยให้ผู้ลงโฆษณาระบุมิติข้อมูลการกำหนดเป้าหมายที่จะใช้ราคาเสนอสัมบูรณ์ได้ วิธีนี้ใช้ได้กับแคมเปญที่กำหนดเป้าหมายไปยังเครือข่ายดิสเพลย์อย่างเดียวเท่านั้น ไม่ใช่เครือข่ายการค้นหา
targetingSetting

object (TargetingSetting)

การตั้งค่าสำหรับฟีเจอร์ที่เกี่ยวข้องกับการกำหนดเป้าหมาย
audienceSetting

object (AudienceSetting)

เปลี่ยนแปลงไม่ได้ การตั้งค่าฟีเจอร์ที่เกี่ยวข้องกับกลุ่มเป้าหมาย
effectiveTargetCpaSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของ CPA เป้าหมายที่ใช้งานได้ ช่องนี้เป็นแบบอ่านอย่างเดียว
effectiveTargetRoasSource

enum (BiddingSource)

เอาต์พุตเท่านั้น แหล่งที่มาของ ROAS เป้าหมายที่ใช้งานได้ ช่องนี้เป็นแบบอ่านอย่างเดียว
labels[]

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของป้ายกำกับที่แนบมากับกลุ่มโฆษณานี้
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
primaryStatus

enum (AdGroupPrimaryStatus)

เอาต์พุตเท่านั้น แสดงมุมมองแบบรวมเกี่ยวกับสาเหตุที่กลุ่มโฆษณาไม่แสดงหรือไม่แสดงอย่างเหมาะสม
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

เอาต์พุตเท่านั้น ระบุสาเหตุที่กลุ่มโฆษณาไม่แสดงหรือไม่แสดงอย่างเหมาะสม
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของกลุ่มโฆษณา
name

string

ชื่อของกลุ่มโฆษณา

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างกลุ่มโฆษณาใหม่

ต้องมีอักขระความกว้างเต็ม UTF-8 น้อยกว่า 255 ตัว

ซึ่งต้องไม่มีอักขระ Null (Code Point 0x0), ฟีดบรรทัด NL (code Point 0xA) หรืออักขระขึ้นบรรทัดใหม่ (Code Point 0xD)
baseAdGroup

string

เอาต์พุตเท่านั้น สำหรับกลุ่มโฆษณาฉบับร่างหรือกลุ่มโฆษณาทดสอบ ช่องนี้คือชื่อทรัพยากรของกลุ่มโฆษณาพื้นฐานที่ใช้สร้างกลุ่มโฆษณา หากกลุ่มโฆษณาฉบับร่างหรือกลุ่มโฆษณาทดสอบไม่มีกลุ่มโฆษณาฐาน ช่องนี้จะเป็นค่าว่าง

สําหรับกลุ่มโฆษณาพื้นฐาน ช่องนี้จะเท่ากับชื่อทรัพยากรกลุ่มโฆษณา

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

string

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

string

เปลี่ยนแปลงไม่ได้ แคมเปญที่มีกลุ่มโฆษณานั้นอยู่
cpcBidMicros

string (int64 format)

ราคาเสนอ CPC (ต้นทุนต่อคลิก) สูงสุด
effectiveCpcBidMicros

string (int64 format)

เอาต์พุตเท่านั้น ค่าจะเหมือนกับค่าของราคาเสนอ CPC (ต้นทุนต่อคลิก) เมื่อกลยุทธ์การเสนอราคาเป็นหนึ่งในค่า CPC ด้วยตนเอง, CPC ที่ปรับปรุงแล้ว, หน้าหนึ่งที่โปรโมต หรือส่วนแบ่งที่ชนะเป้าหมาย ไม่เช่นนั้นค่าจะเป็น Null
cpmBidMicros

string (int64 format)

CPM (ต้นทุนต่อการแสดงผลที่ได้แสดง 1,000 ครั้ง) สูงสุด
targetCpaMicros

string (int64 format)

CPA (ต้นทุนต่อการกระทำหนึ่งครั้ง) เป้าหมาย หากกลยุทธ์การเสนอราคาระดับแคมเปญของกลุ่มโฆษณาคือ TargetCpa หรือเพิ่มจำนวน Conversion สูงสุด (โดยตั้งค่าช่อง CPA เป้าหมาย) ช่องนี้จะลบล้าง CPA เป้าหมายที่ระบุไว้ในกลยุทธ์การเสนอราคาของแคมเปญ มิฉะนั้น ระบบจะไม่สนใจค่านี้
cpvBidMicros

string (int64 format)

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

string (int64 format)

จำนวนเงินเฉลี่ยในระดับไมโครที่ผู้ลงโฆษณายินดีจ่ายสำหรับการแสดงโฆษณาทุก 1,000 ครั้ง
targetRoas

number

การลบล้าง ROAS (ผลตอบแทนจากค่าโฆษณา) เป้าหมาย หากกลยุทธ์การเสนอราคาระดับแคมเปญของกลุ่มโฆษณาคือ TargetRoas หรือ เพิ่มมูลค่า Conversion สูงสุด (โดยตั้งค่าช่อง targetRoas) ช่องนี้จะลบล้าง ROAS เป้าหมายที่ระบุไว้ในกลยุทธ์การเสนอราคาของแคมเปญ มิฉะนั้น ระบบจะไม่สนใจค่านี้
percentCpcBidMicros

string (int64 format)

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

string

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

string (int64 format)

เอาต์พุตเท่านั้น CPA (ต้นทุนต่อการกระทำหนึ่งครั้ง) เป้าหมายที่ใช้งานได้ ช่องนี้เป็นแบบอ่านอย่างเดียว
effectiveTargetRoas

number

เอาต์พุตเท่านั้น ROAS (ผลตอบแทนจากค่าโฆษณา) เป้าหมายที่ใช้งานได้ ช่องนี้เป็นแบบอ่านอย่างเดียว

AdGroupStatus

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

Enum
UNSPECIFIED ยังไม่ได้ระบุสถานะ
UNKNOWN

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

นี่เป็นค่าการตอบกลับเท่านั้น
ENABLED เปิดใช้กลุ่มโฆษณาแล้ว
PAUSED กลุ่มโฆษณานี้หยุดชั่วคราวแล้ว
REMOVED นำกลุ่มโฆษณาออกแล้ว

AdGroupAdRotationMode

โหมดการหมุนเวียนโฆษณาที่เป็นไปได้ของกลุ่มโฆษณา

Enum
UNSPECIFIED ไม่ได้ระบุโหมดการหมุนเวียนโฆษณา
UNKNOWN

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

นี่เป็นค่าการตอบกลับเท่านั้น
OPTIMIZE เพิ่มประสิทธิภาพโฆษณาของกลุ่มโฆษณาตามการคลิกหรือ Conversion
ROTATE_FOREVER หมุนเวียนสม่ำเสมอตลอดไป

AudienceSetting

การตั้งค่าสำหรับการกำหนดกลุ่มเป้าหมาย

การแสดง JSON 
{
  "useAudienceGrouped": boolean
}
ช่อง
useAudienceGrouped

boolean

เปลี่ยนแปลงไม่ได้ หากเป็นจริง กลุ่มโฆษณานี้ใช้ทรัพยากรกลุ่มเป้าหมายสําหรับการกําหนดกลุ่มเป้าหมาย หากเป็นเท็จ กลุ่มโฆษณานี้อาจใช้เกณฑ์กลุ่มเป้าหมายแทน

AdGroupPrimaryStatus

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ELIGIBLE กลุ่มโฆษณานี้มีสิทธิ์แสดง
PAUSED กลุ่มโฆษณานี้หยุดชั่วคราวแล้ว
REMOVED นำกลุ่มโฆษณาออกแล้ว
PENDING กลุ่มโฆษณานี้อาจแสดงผลในอนาคต
NOT_ELIGIBLE กลุ่มโฆษณาไม่มีสิทธิ์แสดง
LIMITED กลุ่มโฆษณามีการแสดงผลที่จำกัด

AdGroupPrimaryStatusReason

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CAMPAIGN_REMOVED ระบบจะนำสถานะแคมเปญที่ผู้ใช้ระบุออก มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
CAMPAIGN_PAUSED สถานะแคมเปญที่ผู้ใช้ระบุหยุดชั่วคราว มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
CAMPAIGN_PENDING เวลาที่ผู้ใช้ระบุเพื่อให้แคมเปญนี้เริ่มทำงานในอนาคต มีส่วนช่วยในสถานะกลุ่มโฆษณาหลักNOT_ELIGIBLE
CAMPAIGN_ENDED เวลาที่ผู้ใช้ระบุสำหรับแคมเปญนี้ได้ผ่านไปแล้ว มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
AD_GROUP_PAUSED สถานะกลุ่มโฆษณาที่ผู้ใช้ระบุหยุดชั่วคราว มีส่วนร่วมในระดับกลุ่มโฆษณาหลัก PAUSED
AD_GROUP_REMOVED ระบบจะนำสถานะกลุ่มโฆษณาที่ผู้ใช้ระบุออก มีส่วนร่วมในระดับกลุ่มโฆษณาหลัก.REMOVED
AD_GROUP_INCOMPLETE การสร้างกลุ่มโฆษณานี้ยังไม่เสร็จสมบูรณ์ มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
KEYWORDS_PAUSED สถานะคีย์เวิร์ดที่ผู้ใช้ระบุในกลุ่มโฆษณานี้หยุดชั่วคราวทั้งหมด มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
NO_KEYWORDS ไม่มีคีย์เวิร์ดที่มีสิทธิ์ในกลุ่มโฆษณานี้ มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
AD_GROUP_ADS_PAUSED สถานะโฆษณาในกลุ่มโฆษณาที่ผู้ใช้ระบุในกลุ่มโฆษณานี้หยุดชั่วคราวทั้งหมด มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
NO_AD_GROUP_ADS ไม่มีโฆษณาในกลุ่มโฆษณาที่มีสิทธิ์ในกลุ่มโฆษณานี้ มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
HAS_ADS_DISAPPROVED เหตุผลของสถานะนโยบายเมื่อโฆษณาอย่างน้อย 1 รายการไม่ได้รับอนุมัติ มีส่วนทำให้เกิดกลุ่มโฆษณาหลักหลายรายการ
HAS_ADS_LIMITED_BY_POLICY เหตุผลของสถานะนโยบายเมื่อโฆษณาอย่างน้อย 1 รายการถูกจำกัดด้วยนโยบาย มีส่วนทำให้เกิดกลุ่มโฆษณาหลักหลายรายการ
MOST_ADS_UNDER_REVIEW เหตุผลของสถานะนโยบายเมื่อโฆษณาส่วนใหญ่อยู่ระหว่างรอการตรวจสอบ มีส่วนใน AdGroupPrimaryStatus.PENDING
CAMPAIGN_DRAFT กลุ่มโฆษณาเป็นของแคมเปญร่าง มีส่วนร่วมในกลุ่มโฆษณาหลักNOT_ELIGIBLE
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY กลุ่มโฆษณาหยุดชั่วคราวเนื่องจากมีกิจกรรมการแสดงผลต่ำเป็นเวลานาน มีส่วนร่วมในระดับกลุ่มโฆษณาหลัก PAUSED