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

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

รายงานนี้จะแสดงผลได้ผ่านคําขอแบบไม่สอดคล้องกันเท่านั้น (นั่นคือผ่านเมธอด 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	ระบุว่าเมตริกในแถวนี้ไม่สามารถระบุแหล่งที่มาเป็นโฆษณาที่เฉพาะเจาะจงได้หรือไม่ เช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ Clickserver URL ที่ไม่ถูกต้องอาจทําให้ DS ระบุแหล่งที่มาของเมตริกกับโฆษณาไม่ได้	แอตทริบิวต์	Boolean	ใช่
adHeadline	บรรทัดแรกของโฆษณา	แอตทริบิวต์	String	ใช่
adHeadline2	บรรทัดแรก 2 ของโฆษณา ไม่พร้อมใช้งานในบางเครื่องมือค้นหา	แอตทริบิวต์	String	ใช่
adHeadline3	บรรทัดแรก 3 ของโฆษณา ไม่พร้อมใช้งานในเครื่องมือค้นหาบางรายการ	แอตทริบิวต์	String	ใช่
adDescription1	บรรทัดรายละเอียดโฆษณา 1	แอตทริบิวต์	String	ใช่
adDescription2	บรรทัดรายละเอียด 2 ของโฆษณา ไม่พร้อมใช้งานสำหรับเครื่องมือค้นหาบางรายการ	แอตทริบิวต์	String	ใช่
adDisplayUrl	URL ที่แสดงของโฆษณา	แอตทริบิวต์	String	ใช่
adLandingPage	หน้า Landing Page ของโฆษณา ดูหน้า Landing Page และ Clickserver 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	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) โดยแต่ละแถวและเมตริกรวมจะแยกออกเป็นหลายแถว 1 แถวต่อสัปดาห์ คอลัมน์นี้จะแสดงวันแรก (วันอาทิตย์) ของแต่ละแถว	กลุ่ม	Date	ใช่
weekEnd	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) โดยแต่ละแถวและเมตริกรวมจะแยกออกเป็นหลายแถว 1 แถวต่อสัปดาห์ คอลัมน์นี้จะแสดงวันสุดท้าย (วันเสาร์) ของแต่ละแถว	กลุ่ม	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 แต่ละรายการ คอลัมน์นี้จะแสดงรหัสกิจกรรม Floodlight ของ DS ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่ม Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ใช่
floodlightActivityTag	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแยกออกเป็นหลายแถวได้สูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงแท็กกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่ม Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่