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

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

รายงานนี้สามารถแสดงผ่านคําขอแบบไม่พร้อมกันเท่านั้น (กล่าวคือ ผ่านเมธอด 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 ของโฆษณา โปรดดูหน้า 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	จํานวนการกระทําทั้งหมดของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	Number	ได้
dfaRevenueCrossEnv	รายได้รวมที่เกิดจากธุรกรรมของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	Money	ได้
dfaTransactionsCrossEnv	จํานวนธุรกรรมทั้งหมดของ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ได้
dfaWeightedActionsCrossEnv	ผลรวมของการถ่วงน้ําหนักของการดําเนินการของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	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	แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว วันละแถว คอลัมน์นี้จะแสดงผลวันที่ของแต่ละแถว	กลุ่ม	Date	ได้
monthStart	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว เดือนละ 1 แถว คอลัมน์นี้จะแสดงผลวันแรกของเดือนของแต่ละแถว	กลุ่ม	Date	ได้
monthEnd	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว เดือนละ 1 แถว คอลัมน์นี้จะแสดงผลวันสุดท้ายของเดือนของแต่ละแถว	กลุ่ม	Date	ได้
quarterStart	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว แต่ละแถวสําหรับแต่ละไตรมาส คอลัมน์นี้จะแสดงผลวันแรกของไตรมาสของแต่ละแถว	กลุ่ม	Date	ได้
quarterEnd	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว แต่ละแถวสําหรับแต่ละไตรมาส คอลัมน์นี้จะแสดงผลวันสุดท้ายของไตรมาสของแต่ละแถว	กลุ่ม	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 แต่ละกลุ่ม คอลัมน์นี้จะแสดงผลรหัสกลุ่ม Floodlight ของ DS ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ได้
floodlightGroupTag	แบ่งกลุ่มรายงานตามกลุ่ม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 กลุ่มสําหรับกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงผลแท็กกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
floodlightActivity	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลชื่อกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
floodlightActivityId	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลรหัสกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ได้
floodlightActivityTag	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลแท็กกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้