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

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

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

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

ส่งเนื้อหาคําขอ 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 ได้