ประเภทรายงาน: productGroup

เมตริกประสิทธิภาพและแอตทริบิวต์การกำหนดค่าสำหรับกลุ่มผลิตภัณฑ์ รายงานกลุ่มผลิตภัณฑ์แตกต่างจากรายงานคีย์เวิร์ดในหลายๆ ลักษณะ ดูข้อมูลเพิ่มเติม

รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())

ขอข้อความที่ตัดตอนมา

ส่ง Reports.request() เนื้อหาของคำขอ แต่ระบุ "reportType": "productGroup"

{
...
  "reportType": "productGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

สำหรับแต่ละคอลัมน์ที่คุณต้องการให้ส่งคืนหรือกรองในรายงาน ให้ระบุ columnName ที่แสดงในตารางด้านล่าง นอกจากนี้คุณยังสามารถเลือกระบุ headerText startDate, และ endDate โปรดทราบว่าบางคอลัมน์ไม่สามารถกรองได้ ดูที่ "กรองได้" ในตารางด้านล่าง

columnName	คำอธิบาย	ลักษณะการทำงาน	ประเภท	กรองได้
status	สถานะของกลุ่มผลิตภัณฑ์ และเป็น Active เสมอ	แอตทริบิวต์	Status	ใช่
engineStatus	สถานะเพิ่มเติมของกลุ่มผลิตภัณฑ์ในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทบัญชีภายนอก) ได้แก่ review campaign paused ฯลฯ	แอตทริบิวต์	String	ใช่
creationTimestamp	การประทับเวลาสร้างกลุ่มผลิตภัณฑ์ซึ่งอยู่ในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ใช่
lastModifiedTimestamp	การประทับเวลาการแก้ไขล่าสุดของกลุ่มผลิตภัณฑ์ ซึ่งอยู่ในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ใช่
agency	ชื่อเอเจนซี	แอตทริบิวต์	String	ใช่
agencyId	รหัสเอเจนซี DS	แอตทริบิวต์	ID	ใช่
advertiser	ชื่อผู้ลงโฆษณา	แอตทริบิวต์	String	ใช่
advertiserId	รหัสผู้ลงโฆษณา DS	แอตทริบิวต์	ID	ใช่
account	ชื่อบัญชีเครื่องมือค้นหา	แอตทริบิวต์	String	ใช่
accountId	รหัสบัญชีเครื่องมือค้นหา DS	แอตทริบิวต์	ID	ใช่
accountEngineId	รหัสบัญชีในบัญชีเครื่องมือค้นหาภายนอก	แอตทริบิวต์	String	ใช่
accountType	ประเภทบัญชีเครื่องมือค้นหา: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu หรือ Comparison Shopping	แอตทริบิวต์	Engine type	ใช่
campaign	ชื่อแคมเปญ	แอตทริบิวต์	String	ใช่
campaignId	รหัสแคมเปญ DS	แอตทริบิวต์	ID	ใช่
campaignStatus	สถานะของแคมเปญที่มีรายการนี้	แอตทริบิวต์	Status	ใช่
adGroup	ชื่อกลุ่มโฆษณา	แอตทริบิวต์	String	ใช่
adGroupId	รหัสกลุ่มโฆษณา DS	แอตทริบิวต์	ID	ใช่
adGroupStatus	สถานะของกลุ่มโฆษณาที่มีรายการนี้	แอตทริบิวต์	Status	ใช่
productGroupId	รหัสกลุ่มผลิตภัณฑ์ DS DS จะสร้างรหัสเหล่านี้ ซึ่งอาจมีการเปลี่ยนแปลงแม้ว่าโครงสร้างกลุ่มผลิตภัณฑ์ที่ได้จะไม่มีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติม	แอตทริบิวต์	ID	ใช่
productGroup	เกณฑ์ที่ใช้กำหนดกลุ่มผลิตภัณฑ์ เช่น AND(CATEGORY="Electronics",BRAND = "example")	แอตทริบิวต์	String	ไม่
productGroupPartitionType	ประเภทพาร์ติชันสำหรับกลุ่มผลิตภัณฑ์: Subdivided, Excluded หรือ Biddable	แอตทริบิวต์	Product group partition type	ใช่
productGroupLandingPage	หน้า Landing Page ของกลุ่มผลิตภัณฑ์ ดู URL ของหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก	แอตทริบิวต์	String	ใช่
productGroupClickserverUrl	URL ที่ DS ใช้เพื่อติดตามกิจกรรม ผู้ใช้ที่คลิกโฆษณาจะเข้าชม URL ของเซิร์ฟเวอร์คลิกก่อน จากนั้นจึงเปลี่ยนเส้นทางไปยังหน้า Landing Page สุดท้าย ดู URL ของหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก	แอตทริบิวต์	String	ใช่
productGroupMaxCpc	แสดง CPC สูงสุดที่กำหนดค่าไว้สำหรับกลุ่มผลิตภัณฑ์นี้ หากมี หากไม่มีการตั้งค่า CPC สูงสุดสำหรับกลุ่มผลิตภัณฑ์นี้ ฟิลด์นี้จะว่างเปล่าและกลุ่มผลิตภัณฑ์จะรับการตั้งค่า CPC สูงสุดจากกลุ่มโฆษณานั้น	แอตทริบิวต์	Money	ใช่
effectiveProductGroupMaxCpc	CPC สูงสุด (ต้นทุนต่อคลิกสูงสุด) ที่ใช้กับกลุ่มผลิตภัณฑ์นี้ ตัวแปรนี้จะเป็นค่าเดียวกับ CPC สูงสุดของกลุ่มโฆษณา หรือในกรณีที่เป้าหมายผลิตภัณฑ์ลบล้างการตั้งค่าของกลุ่มโฆษณา ค่า CPC สูงสุดของเป้าหมายผลิตภัณฑ์เอง	แอตทริบิวต์	Money	ใช่
productGroupMaxBid	หากกลุ่มผลิตภัณฑ์นี้ได้รับการจัดการโดยกลยุทธ์การเสนอราคา DS กลยุทธ์การเสนอราคาจะไม่เพิ่มราคาเสนอเกินขีดจำกัดนี้ ดูใช้กลยุทธ์การเสนอราคากับกลุ่มผลิตภัณฑ์	แอตทริบิวต์	Money	ใช่
productGroupMinBid	หากกลุ่มผลิตภัณฑ์นี้ได้รับการจัดการโดยกลยุทธ์การเสนอราคา DS กลยุทธ์การเสนอราคาจะไม่ลดราคาเสนอต่ำกว่าขีดจำกัดนี้ ดูใช้กลยุทธ์การเสนอราคากับกลุ่มผลิตภัณฑ์	แอตทริบิวต์	Money	ใช่
effectiveBidStrategyId	รหัส DS ของกลยุทธ์การเสนอราคาที่กำหนดให้กับเอนทิตีนี้ หรือได้รับมาจากเอนทิตีนี้	แอตทริบิวต์	ID	ใช่
effectiveBidStrategy	ชื่อของกลยุทธ์การเสนอราคาที่กำหนดให้กับเอนทิตีนี้ หรือที่สืบทอดมาโดยเอนทิตีนี้	แอตทริบิวต์	String	ใช่
bidStrategyInherited	ระบุว่ารับค่ากลยุทธ์การเสนอราคาของเอนทิตีนี้หรือไม่	แอตทริบิวต์	Boolean	ใช่
effectiveLabels	ชื่อของป้ายกำกับทั้งหมดที่รับช่วงมาหรือที่กำหนดให้กลุ่มผลิตภัณฑ์นี้โดยตรง	แอตทริบิวต์	String list	ใช่
dfaActions	จำนวนการดำเนินการทั้งหมดของ Campaign Manager	เมตริก	Integer	ใช่
dfaRevenue	รายได้รวมที่เกิดจากธุรกรรมของ Campaign Manager	เมตริก	Money	ใช่
dfaTransactions	จำนวนธุรกรรม Campaign Manager ทั้งหมด	เมตริก	Integer	ใช่
dfaWeightedActions	ผลรวมถ่วงน้ำหนักของการดำเนินการใน Campaign Manager	เมตริก	Number	ใช่
dfaActionsCrossEnv	จำนวนการกระทำทั้งหมดของ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ใช่
dfaRevenueCrossEnv	รายได้รวมที่เกิดจากธุรกรรม Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Money	ใช่
dfaTransactionsCrossEnv	จำนวนธุรกรรม Campaign Manager ข้ามสภาพแวดล้อมทั้งหมด	เมตริก	Number	ใช่
dfaWeightedActionsCrossEnv	ผลรวมถ่วงน้ำหนักของการดำเนินการ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ใช่
avgCpc	ต้นทุนต่อคลิกโดยเฉลี่ย	เมตริก	Money	ใช่
avgCpm	ต้นทุนต่อการแสดงผลพันครั้งโดยเฉลี่ย	เมตริก	Money	ใช่
avgPos	อันดับเฉลี่ย	เมตริก	Number	ใช่
clicks	จำนวนคลิกรวม	เมตริก	Integer	ใช่
cost	ค่าใช้จ่ายรวมที่ชำระให้กับบัญชีเครื่องมือค้นหา	เมตริก	Money	ใช่
ctr	อัตราการคลิกผ่านโดยเฉลี่ย	เมตริก	Number	ใช่
impr	จำนวนการแสดงผลทั้งหมด	เมตริก	Integer	ใช่
adWordsConversions	ข้อมูลที่ผู้ลงโฆษณาตั้งค่าให้รายงานในคอลัมน์ Conversion ของ Google Ads เมื่อมีการสร้างการกระทำที่ถือเป็น Conversion ของ Google Ads ผู้ลงโฆษณาจะเลือกว่าจะนับ Conversion เหล่านั้นในคอลัมน์การรายงาน Conversion หรือไม่	เมตริก	Number	ใช่
adWordsConversionValue	มูลค่ารวมของ Conversion ของ Google Ads	เมตริก	Number	ใช่
adWordsViewThroughConversions	จำนวน Conversion การดูผ่านของ Google Ads ทั้งหมด	เมตริก	Integer	ใช่
visits	จำนวนการเข้าชม DS ทั้งหมด	เมตริก	Integer	ใช่
date	แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละวัน คอลัมน์นี้แสดงวันที่ของแต่ละแถว	กลุ่ม	Date	ใช่
monthStart	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงผลวันแรกของเดือนของแต่ละแถว	กลุ่ม	Date	ใช่
monthEnd	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงวันสุดท้ายของเดือนของแต่ละแถว	กลุ่ม	Date	ใช่
quarterStart	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงผลวันแรกของไตรมาสของแต่ละแถว	กลุ่ม	Date	ใช่
quarterEnd	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงวันสุดท้ายของไตรมาสของแต่ละแถว	กลุ่ม	Date	ใช่
weekStart	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงผลวันแรก (วันอาทิตย์) ของแต่ละแถว	กลุ่ม	Date	ใช่
weekEnd	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงวันสุดท้าย (วันเสาร์) ของแต่ละแถว	กลุ่ม	Date	ใช่
yearStart	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันแรกของปีของแต่ละแถว	กลุ่ม	Date	ใช่
yearEnd	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันสุดท้ายของปีของแต่ละแถว	กลุ่ม	Date	ใช่
deviceSegment	จัดกลุ่มรายงานตามอุปกรณ์ แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยไม่เกิน 1 แถวสําหรับกลุ่มอุปกรณ์แต่ละกลุ่ม คอลัมน์นี้แสดงกลุ่มอุปกรณ์ของแต่ละแถว	กลุ่ม	Device segment	ใช่