ประเภทรายงาน: โฆษณา

เมตริกประสิทธิภาพและแอตทริบิวต์การกำหนดค่าสำหรับโฆษณา

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

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

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

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

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

columnName	คำอธิบาย	ลักษณะการทำงาน	ประเภท	กรองได้
status	สถานะของโฆษณา: Active, Paused หรือ Removed โปรดทราบว่าแคมเปญ กลุ่มโฆษณา คีย์เวิร์ด และโฆษณาต่างก็มีสถานะของตนเอง ดูสถานะ	แอตทริบิวต์	Status	ใช่
engineStatus	สถานะเพิ่มเติมของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทบัญชีภายนอก) ได้แก่ active, eligible, creative deleted, creative approved family safe ฯลฯ	แอตทริบิวต์	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	ใช่
ad	ชื่อโฆษณา	แอตทริบิวต์	String	ใช่
adId	รหัสโฆษณา DS ค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา	แอตทริบิวต์	ID	ใช่
adEngineId	รหัสของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก	แอตทริบิวต์	ID	ใช่
isUnattributedAd	ระบุว่าเมตริกในแถวนี้ระบุแหล่งที่มาไปยังโฆษณารายการใดรายการหนึ่งได้หรือไม่ ตัวอย่างเช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ URL ของเซิร์ฟเวอร์คลิกที่ไม่ถูกต้องอาจป้องกันไม่ให้ DS ระบุแหล่งที่มาของเมตริกเป็นโฆษณาได้	แอตทริบิวต์	Boolean	ใช่
adHeadline	บรรทัดแรกของโฆษณา	แอตทริบิวต์	String	ใช่
adHeadline2	บรรทัดแรกของโฆษณา 2; ไม่สามารถใช้ได้กับเครื่องมือบางรายการ	แอตทริบิวต์	String	ใช่
adHeadline3	บรรทัดแรกของโฆษณา 3 ไม่สามารถใช้ได้กับเครื่องมือบางรายการ	แอตทริบิวต์	String	ใช่
adDescription1	บรรทัดรายละเอียดโฆษณา 1	แอตทริบิวต์	String	ใช่
adDescription2	บรรทัดรายละเอียดโฆษณา 2 ไม่สามารถใช้ได้กับเครื่องมือบางรายการ	แอตทริบิวต์	String	ใช่
adDisplayUrl	URL ที่แสดงของโฆษณา	แอตทริบิวต์	String	ใช่
adLandingPage	หน้า Landing Page ของโฆษณา ดู URL ของหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก	แอตทริบิวต์	String	ใช่
adType	ประเภทโฆษณา: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text หรือ Expanded dynamic search	แอตทริบิวต์	Ad type	ใช่
adPromotionLine	บรรทัดโปรโมตโฆษณา ข้อความโปรโมตสั้นๆ สำหรับโฆษณาผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
adLabels	ชื่อของป้ายกำกับที่กำหนดให้กับโฆษณานี้โดยตรง ไม่รวมป้ายกำกับที่รับช่วงมา	แอตทริบิวต์	String list	ใช่
adPathField1	ช่องเส้นทางโฆษณา 1 ช่องเส้นทาง 1 และ 2 จะรวมเข้ากับ adDisplayUrl เพื่อสร้าง URL ที่แสดงในโฆษณา	แอตทริบิวต์	String	ใช่
adPathField2	ช่องเส้นทางโฆษณา 2 ช่องเส้นทาง 1 และ 2 จะรวมเข้ากับ adDisplayUrl เพื่อสร้าง URL ที่แสดงในโฆษณา	แอตทริบิวต์	String	ใช่
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	ใช่
floodlightGroup	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงชื่อกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightGroupId	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงรหัสกลุ่ม DS Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ใช่
floodlightGroupTag	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้แสดงแท็กกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightActivity	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้แสดงชื่อกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightActivityId	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงรหัสกิจกรรม DS Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ใช่
floodlightActivityTag	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้แสดงแท็กกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่