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

ข้อมูลการรายงานสำหรับผู้ลงโฆษณา ได้แก่

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

ขอข้อความที่ตัดตอนมา

ส่ง 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 หรือหากส่วนแบ่งน้อยกว่า 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	ใช่