เมตริกประสิทธิภาพและแอตทริบิวต์การกําหนดค่าสําหรับโฆษณา
รายงานนี้สามารถแสดงผ่านคําขอแบบไม่พร้อมกันเท่านั้น (กล่าวคือ ผ่านเมธอด 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 |
ได้ |