ประเภทรายงาน: ผู้ลงโฆษณา

ข้อมูลการรายงานสําหรับผู้ลงโฆษณา ซึ่งรวมถึงข้อมูลต่อไปนี้

• เมตริกประสิทธิภาพในบัญชีเครื่องมือค้นหาและแคมเปญทั้งหมดของผู้ลงโฆษณา
• แอตทริบิวต์การกําหนดค่าสําหรับผู้ลงโฆษณา

ขอตัวอย่าง

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