ประเภทรายงาน: โฆษณา

เมตริกประสิทธิภาพและแอตทริบิวต์การกำหนดค่าสำหรับโฆษณา

รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())

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

ส่ง Reports.request() เนื้อหาของคำขอ แต่ระบุ "reportType": "ad" 

{
...
  "reportType": "ad",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

สำหรับแต่ละคอลัมน์ที่คุณต้องการให้ส่งคืนหรือกรองในรายงาน ให้ระบุ columnName ที่แสดงในตารางด้านล่าง นอกจากนี้คุณยังสามารถเลือกระบุ headerText startDate, และ endDate โปรดทราบว่าบางคอลัมน์ไม่สามารถกรองได้ ดูที่ "กรองได้" ในตารางด้านล่าง

columnNameคำอธิบายลักษณะการทำงานประเภทกรองได้
status สถานะของโฆษณา: Active, Paused หรือ Removed โปรดทราบว่าแคมเปญ กลุ่มโฆษณา คีย์เวิร์ด และโฆษณาต่างก็มีสถานะของตนเอง ดูสถานะ แอตทริบิวต์ Status ใช่
engineStatus สถานะเพิ่มเติมของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทบัญชีภายนอก) ได้แก่ active, eligible, creative deleted, creative approved family safe ฯลฯ แอตทริบิวต์ String ใช่
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 ใช่
campaign ชื่อแคมเปญ แอตทริบิวต์ String ใช่
campaignId รหัสแคมเปญ DS แอตทริบิวต์ ID ใช่
campaignStatus สถานะของแคมเปญที่มีรายการนี้ แอตทริบิวต์ Status ใช่
adGroup ชื่อกลุ่มโฆษณา แอตทริบิวต์ String ใช่
adGroupId รหัสกลุ่มโฆษณา DS แอตทริบิวต์ ID ใช่
adGroupStatus สถานะของกลุ่มโฆษณาที่มีรายการนี้ แอตทริบิวต์ Status ใช่
ad ชื่อโฆษณา แอตทริบิวต์ String ใช่
adId รหัสโฆษณา DS ค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา แอตทริบิวต์ ID ใช่
adEngineId รหัสของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก แอตทริบิวต์ ID ใช่
isUnattributedAd ระบุว่าเมตริกในแถวนี้ระบุแหล่งที่มาไปยังโฆษณารายการใดรายการหนึ่งได้หรือไม่ ตัวอย่างเช่น โฆษณาที่มีรูปแบบที่ไม่รองรับหรือ URL ของเซิร์ฟเวอร์คลิกที่ไม่ถูกต้องอาจป้องกันไม่ให้ DS ระบุแหล่งที่มาของเมตริกเป็นโฆษณาได้ แอตทริบิวต์ Boolean ใช่
adHeadline บรรทัดแรกของโฆษณา แอตทริบิวต์ String ใช่
adHeadline2 บรรทัดแรกของโฆษณา 2; ไม่สามารถใช้ได้กับเครื่องมือบางรายการ แอตทริบิวต์ String ใช่
adHeadline3 บรรทัดแรกของโฆษณา 3 ไม่สามารถใช้ได้กับเครื่องมือบางรายการ แอตทริบิวต์ String ใช่
adDescription1 บรรทัดรายละเอียดโฆษณา 1 แอตทริบิวต์ String ใช่
adDescription2 บรรทัดรายละเอียดโฆษณา 2 ไม่สามารถใช้ได้กับเครื่องมือบางรายการ แอตทริบิวต์ String ใช่
adDisplayUrl URL ที่แสดงของโฆษณา แอตทริบิวต์ String ใช่
adLandingPage หน้า Landing Page ของโฆษณา ดู URL ของหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก แอตทริบิวต์ String ใช่
adType ประเภทโฆษณา: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text หรือ Expanded dynamic search แอตทริบิวต์ Ad type ใช่
adPromotionLine บรรทัดโปรโมตโฆษณา ข้อความโปรโมตสั้นๆ สำหรับโฆษณาผลิตภัณฑ์ แอตทริบิวต์ String ใช่
adLabels ชื่อของป้ายกำกับที่กำหนดให้กับโฆษณานี้โดยตรง ไม่รวมป้ายกำกับที่รับช่วงมา แอตทริบิวต์ String list ใช่
adPathField1 ช่องเส้นทางโฆษณา 1 ช่องเส้นทาง 1 และ 2 จะรวมเข้ากับ adDisplayUrl เพื่อสร้าง URL ที่แสดงในโฆษณา แอตทริบิวต์ String ใช่
adPathField2 ช่องเส้นทางโฆษณา 2 ช่องเส้นทาง 1 และ 2 จะรวมเข้ากับ adDisplayUrl เพื่อสร้าง URL ที่แสดงในโฆษณา แอตทริบิวต์ String ใช่
effectiveLabels ชื่อของป้ายกำกับทั้งหมดที่รับช่วงมาหรือกำหนดให้กับโฆษณานี้โดยตรง แอตทริบิวต์ String list ใช่
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 ใช่
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 ใช่