ข้อมูลการรายงานสำหรับบัญชีเครื่องมือค้นหา ได้แก่
- เมตริกประสิทธิภาพในทุกแคมเปญของบัญชีเครื่องมือค้นหา
- แอตทริบิวต์การกำหนดค่าสำหรับบัญชีเครื่องมือค้นหา
ขอข้อความที่ตัดตอนมา
ส่ง
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 หรือหากส่วนแบ่งน้อยกว่า 0.1 สตริง < 10% |
เมตริก | Impression share |
ใช่ |
searchBudgetLostImpressionShare |
Google Ads และ Bing Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาของคุณไม่แสดงบนเครือข่าย Search เนื่องจากงบประมาณไม่เพียงพอ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือหากส่วนแบ่งมีค่ามากกว่า 0.9 จะแสดงเป็นสตริง > 90% |
เมตริก | Impression share |
ใช่ |
searchRankLostImpressionShare |
Google Ads และ Bing Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Search เนื่องจากลำดับโฆษณาต่ำ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือหากส่วนแบ่งมีค่ามากกว่า 0.9 จะแสดงเป็นสตริง > 90% |
เมตริก | Impression share |
ใช่ |
displayImpressionShare |
Google Ads เท่านั้น การแสดงผลที่คุณได้รับในเครือข่ายดิสเพลย์ หารด้วยจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับ แสดงผลเป็นตัวเลขระหว่าง 0.1 ถึง 1 หรือหากส่วนแบ่งน้อยกว่า 0.1 สตริง < 10% |
เมตริก | Impression share |
ใช่ |
displayBudgetLostImpressionShare |
Google Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่าย Display เนื่องจากงบประมาณไม่เพียงพอ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือหากส่วนแบ่งมีค่ามากกว่า 0.9 จะแสดงเป็นสตริง > 90% |
เมตริก | Impression share |
ใช่ |
displayRankLostImpressionShare |
Google Ads เท่านั้น เปอร์เซ็นต์ของจำนวนครั้งที่โฆษณาไม่แสดงในเครือข่ายดิสเพลย์เนื่องจากลำดับโฆษณาต่ำ แสดงผลเป็นตัวเลขระหว่าง 0 ถึง 0.9 หรือหากส่วนแบ่งมีค่ามากกว่า 0.9 จะแสดงเป็นสตริง > 90% |
เมตริก | 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 |
แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงผลวันแรก (วันอาทิตย์) ของแต่ละแถว | กลุ่ม | 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 |
ใช่ |