ข้อมูลการรายงานสําหรับผู้ลงโฆษณา ได้แก่
- เมตริกประสิทธิภาพในบัญชีเครื่องมือค้นหาและแคมเปญทั้งหมดของผู้ลงโฆษณา
- แอตทริบิวต์การกําหนดค่าสําหรับผู้ลงโฆษณา
ข้อความที่ตัดตอนมา
ส่งเนื้อหาคําขอ Reports.request() หรือ Reports.generate() ปกติ แต่ระบุ "reportType": "advertiser"
{ ... "reportType": "advertiser", "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 |
ได้ |
dfaAdvertiserId |
รหัสของผู้ลงโฆษณา Campaign Manager ที่เชื่อมโยงกับผู้ลงโฆษณา DS นี้ | แอตทริบิวต์ | ID |
ได้ |
dfaNetworkId |
รหัสของเครือข่าย Campaign Manager ที่เชื่อมโยงกับผู้ลงโฆษณา DS นี้ | แอตทริบิวต์ | ID |
ได้ |
dfaNetworkTimeZone |
เขตเวลาของเครือข่าย Campaign Manager ที่เชื่อมโยงกับผู้ลงโฆษณา DS นี้ในรูปแบบฐานข้อมูลเขตเวลา IANA เช่น America/New_York |
แอตทริบิวต์ | String |
ได้ |
advertiserCurrencyCode |
รหัสสกุลเงินของผู้ลงโฆษณาในรูปแบบ ISO 4217 | แอตทริบิวต์ | String |
ได้ |
googleAnalyticsTimeZone |
เขตเวลาของข้อมูลพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์กับผู้ลงโฆษณา DS นี้ ใช้รูปแบบฐานข้อมูลเขตเวลา IANA เช่น America/New_York |
แอตทริบิวต์ | String |
ได้ |
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 |
ได้ |
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 เท่านั้น เปอร์เซ็นต์ของจํานวนครั้งที่โฆษณาของคุณไม่แสดงบนเครือข่ายดิสเพลย์เนื่องจากงบประมาณไม่เพียงพอ แสดงผลเป็นตัวเลขระหว่าง 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 |
แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว วันละแถว คอลัมน์นี้จะแสดงผลวันที่ของแต่ละแถว | กลุ่ม | 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 |
ได้ |