ข้อมูลการรายงานสําหรับบัญชีเครื่องมือค้นหา ซึ่งรวมถึงข้อมูลต่อไปนี้
- เมตริกประสิทธิภาพของแคมเปญทั้งหมดในบัญชีเครื่องมือค้นหา
- แอตทริบิวต์การกําหนดค่าสําหรับบัญชีเครื่องมือค้นหา
ขอตัวอย่าง
ส่งเนื้อหาคำขอ Reports.request() หรือ Reports.generate() ปกติ แต่ระบุ "reportType": "account"
{
...
"reportType": "account",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
สําหรับแต่ละคอลัมน์ที่คุณต้องการแสดงผลหรือกรองในรายงาน ให้ระบุ columnName
ที่แสดงในตารางด้านล่าง
นอกจากนี้ คุณยังระบุ headerText, startDate และ endDate ได้ด้วย
โปรดทราบว่าบางคอลัมน์จะกรองไม่ได้ โปรดดู "กรองได้" ในตารางด้านล่าง
columnName | คำอธิบาย | พฤติกรรม | ประเภท | กรองได้ |
---|---|---|---|---|
status |
สถานะของบัญชี: Active , Paused หรือ Removed |
แอตทริบิวต์ | Status |
ใช่ |
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 |
ใช่ |
accountCurrencyCode |
รหัสสกุลเงินของบัญชีเครื่องยนต์ในรูปแบบ ISO 4217 | แอตทริบิวต์ | String |
ใช่ |
accountTimeZone |
เขตเวลาของบัญชีเครื่องมือค้นหาในรูปแบบฐานข้อมูลเขตเวลา IANA เช่น America/New_York |
แอตทริบิวต์ | String |
ใช่ |
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 |
ใช่ |
searchImpressionShare |
Google Ads และ Bing Ads เท่านั้น การแสดงผลที่คุณได้รับในเครือข่าย Search หารด้วยจํานวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับ แสดงผลเป็นตัวเลขระหว่าง 0.1 ถึง 1 หรือสตริง < 10% หากส่วนแบ่งน้อยกว่า 0.1 |
เมตริก | Impression share |
ใช่ |
searchBudgetLostImpressionShare |
Google Ads และ Bing Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Search เนื่องจากงบประมาณไม่เพียงพอ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือเป็นสตริง > 90% หากส่วนแบ่งมากกว่า 0.9 |
เมตริก | Impression share |
ใช่ |
searchRankLostImpressionShare |
Google Ads และ Bing Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Search เนื่องจากอยู่ในลําดับต่ำ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือเป็นสตริง > 90% หากส่วนแบ่งมากกว่า 0.9 |
เมตริก | Impression share |
ใช่ |
displayImpressionShare |
Google Ads เท่านั้น การแสดงผลที่คุณได้รับในเครือข่าย Display หารด้วยจํานวนโดยประมาณของการแสดงผลที่คุณมีสิทธิ์ได้รับ แสดงผลเป็นตัวเลขระหว่าง 0.1 ถึง 1 หรือสตริง < 10% หากส่วนแบ่งน้อยกว่า 0.1 |
เมตริก | Impression share |
ใช่ |
displayBudgetLostImpressionShare |
Google Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Display เนื่องจากงบประมาณไม่เพียงพอ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือเป็นสตริง > 90% หากส่วนแบ่งมากกว่า 0.9 |
เมตริก | Impression share |
ใช่ |
displayRankLostImpressionShare |
Google Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Display เนื่องจากอยู่ในลําดับต่ำ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือเป็นสตริง > 90% หากส่วนแบ่งมากกว่า 0.9 |
เมตริก | Impression share |
ใช่ |
qualityScoreAvg |
Google Ads และ Bing Ads เท่านั้น ค่าเฉลี่ยถ่วงน้ำหนักการแสดงผลของคะแนนคุณภาพ (QS) ของเครื่องมือในทุกๆ วันและคีย์เวิร์ดในขอบเขตรายงาน | เมตริก | Number |
ใช่ |
topOfPageBidAvg |
Google Ads เท่านั้น ประมาณราคาเสนอ CPC เฉลี่ยที่จําเป็นในช่วงระยะเวลาของรายงานเพื่อให้โฆษณาปรากฏในตําแหน่งบนสุดเหนือผลการค้นหาเป็นประจำ | เมตริก | Money |
ใช่ |
absoluteTopImpressionPercentage |
เปอร์เซ็นต์ของการแสดงโฆษณาที่แสดงเป็นโฆษณาแรกเหนือผลการค้นหาทั่วไป | เมตริก | Impression share |
ใช่ |
searchAbsoluteTopImpressionShare |
การแสดงผลที่คุณได้รับในตำแหน่งบนสุดแบบสัมบูรณ์ (โฆษณาแรกสุดที่อยู่เหนือผลการค้นหาทั่วไป) หารด้วยจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับในตำแหน่งบนสุด | เมตริก | Impression share |
ใช่ |
topImpressionPercentage |
เปอร์เซ็นต์ของการแสดงโฆษณาที่แสดงเหนือผลการค้นหาทั่วไป | เมตริก | Impression share |
ใช่ |
searchTopImpressionShare |
การแสดงผลที่คุณได้รับในตําแหน่งบนสุด (ที่ใดก็ตามเหนือผลการค้นหาทั่วไป) เทียบกับจํานวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับในตําแหน่งบนสุด | เมตริก | Impression share |
ใช่ |
searchBudgetLostAbsoluteTopImpressionShare |
ประมาณความถี่ที่โฆษณาไม่ใช่โฆษณาแรกเหนือผลการค้นหาทั่วไปเนื่องจากงบประมาณต่ำ | เมตริก | Impression share |
ใช่ |
searchBudgetLostTopImpressionShare |
ช่วยให้คุณเข้าใจความถี่ที่โฆษณาไม่ได้แสดงที่ใดเลยเหนือผลการค้นหาทั่วไปเนื่องจากงบประมาณต่ำ | เมตริก | Impression share |
ใช่ |
searchRankLostAbsoluteTopImpressionShare |
ประมาณความถี่ที่โฆษณาไม่ได้แสดงเป็นอันดับแรกเหนือผลการค้นหาทั่วไปเนื่องจากลําดับโฆษณาต่ำ | เมตริก | Impression share |
ใช่ |
searchRankLostTopImpressionShare |
ประมาณความถี่ที่โฆษณาไม่ได้แสดงที่ใดก็ตามเหนือผลการค้นหาทั่วไปเนื่องจากลำดับโฆษณาต่ำ | เมตริก | Impression share |
ใช่ |
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 |
ใช่ |